[03/09/25] Weekly Release
#65 Release Note sẽ được phát hành định kỳ hàng tuần để cập nhật các thay đổi về tính năng của PangoCDP kèm hướng dẫn sử dụng (nếu có)
Improve
New
ZMA Setting - Rules: cho phép thiết lập Validation Script để không tính Limit Quotation Event Times
Trước đây, khi triển khai chiến dịch cần quy định số lượng tương tác tối đa của tất cả User với ZMA qua tính năng Access Limitation loại Total Event Times ⇒ người vận hành gặp các ngữ cảnh khó khăn như:
Có nhiều nhu cầu chặn khác nhau trên cùng ZMA ví dụ:
UTM Source là Online thì không giới hạn số lượng (do quà tặng phát sau nên không giới hạn)
UTM Source là Offline thì có giới hạn vì số lượng quà tại điểm phát là có giới hạn
Ngữ cảnh khác: nếu User Submit Form có chọn nội dung là “người dùng mới” tặng Voucher giảm giá (áp dụng giới hạn cho 1000 người dùng mới đầu tiên). Còn lại có thể submit thoải mái mà không ảnh hưởng đến số lượng giới hạn.
⇒ Không thể triển khai khi gặp các trường hợp tương tự như ví dụ vì hiện đang Count by Event khi User Action → chưa có cơ chế chọn lọc để lược bỏ.
Cập nhật mới trên Zalo Mini App Settings:
Thay đổi giao diện trên menu Access Limitation cho tính năng Total Event Times
Turn-on để áp dụng: thêm số lượng tối đa cho User tương tác với ZMA theo Event(s)
Thêm tính năng Validation Event để định nghĩa các Event không thỏa điều kiện ⇒ không tính quota trong limitation
Khi User vào tương tác với ZMA ⇒ hệ thống sẽ kiểm tra eventData trên Event thiết lập
Nếu thỏa các điều kiện trong Validation, sẽ không tính Event này vào Quotation
Validate Script sẽ định nghĩa các Event không được tính số lượng Limitation

Hướng dẫn thiết lập bằng cách:
Truy cập vào Module Console, menu Connection → Social Network → Zalo Official Account
Chọn Connection chứa ZMA, trên giao diện quản lý chọn icon Setting
Trên giao diện quản lý Setting, chọn tab Rules → chọn menu Access Limitation
Trên giao diện Access Limitation, Enable tuỳ chọn "Total Event Times"
Thiết lập các cấu hình ZMA Event(s), Reset Type, Max Times

Chọn Event Validation Script để thiết lập điều kiện không tính Limit Quotation
Trên giao diện mở ra chọn event đã thiết lập tại ZMA Events và điền cấu trúc Validation Scripts theo mong đợi
⇒ Các event đúng điều kiện Validation Script sẽ không được tính Limit Quotation được thiết lập tại Max Times.

Pango Reward x DMA Workflow: bổ sung pop-up hiển thị thông điệp khi nhận điểm từ Element ACT. Reward Point
Trước đây, khi thực hiện các luồng cộng điểm cho User bằng DMA Workflow - element ACT.+/- Reward Point trên ZMA Pango Reward sẽ ghi nhận vào History (lịch sử cộng điểm). Khi triển khai Campaign khi người dùng thực hiện tính năng Multi-mission để thực hiện nhiệm vụ nhận điểm ⇒ User không biết khi được tích điểm thành công, dẫn đến giảm trải nghiệm khi sử dụng ZMA.
Cập nhật mới cho phép hiển thị thông báo khi cộng điểm thành công từ DMA Workflow cho User trên Pango Reward. Điều này giúp làm rõ thông tin về việc hoàn thành nhiệm vụ nhận điểm và sử dụng điểm đổi quà ⇒ nâng cao tỉ lệ tương tác với ứng dụng Pango Reward - giúp triển khai Campaign đạt hiệu quả hơn.
Lưu ý: chỉ áp dụng cho Pango Reward sử dụng giao diện Version 2 khi Deploy ZMA.

Hướng dẫn thiết lập bằng cách:
Truy cập vào Module DMA, chọn menu Automation → chọn submenu Workflow
Chọn DMA Workflow cần thiết lập → chọn element ACT. +/- Reward Points
Bật cấu hình Notify App Message để cấu hình nội dung cộng điểm trên ZMA
Nhập nội dung phù hợp, có hỗ trợ parameter theo ngữ cảnh trên Workflow
Bất cấu hình Validate Param để đảm bảo các param được enrich thành công mới cho thông báo. Trong trường hợp còn parameter chưa được enrich sẽ vẫn cộng điểm thành công nhưng không hiển thị thông báo.

Batch Voucher: bổ sung thêm trường usedTime cho các Voucher trên hệ thống bằng cách Manual Import và API Ingest
Trước đây, khi sử dụng tính năng Import Manual hoặc API để updated trạng thái của các Allocated Voucher thành Used Voucher người vận hành không thể chèn thời gian updated Used vào hệ thống Pango. Hệ thống sẽ sử dụng thời gian Current Time tại thời điểm Update Success để khi nhận updateTime của Voucher.
Cập nhật mới cho phép thêm trường updatedTime trong file Import mẫu và trên API Document. Hệ thống sẽ xử lý khi nhận diện usedTime theo nguyên tắc:
Nếu không có thông tin usedTime hoặc sai cấu trúc yêu cầu ⇒ hệ thống sử dụng Current Time khi update thành công để ghi nhận.
Nếu có thông tin usedTime ⇒ hệ thống thực hiện so sánh với allocatedTime (phải lớn hơn) ⇒ hệ thống tiếp tục so sánh với currentTime (phải bé hơn) ⇒ ghi nhận updatedTime theo giá trị truyền vào .

Pango Console: bổ sung tuỳ chọn Time Table Partition trên giao diện Output Big Query
Trước đây khi đồng bộ dữ liệu từ PangoCDP sang BigQuery, hệ thống mặc định chỉ hỗ trợ Table Partition dựa trên Created Time. Điều này gây hạn chế trong một số tình huống cần đồng bộ dữ liệu dựa trên Updated Time .
Bản cập nhật hiện tại đã bổ sung trường Time Partition trên giao diện cấu hình Output BigQuery, cho phép người vận hành chọn dữ liệu muốn đồng bộ theo nhu cầu. Nhờ đó, việc quản lý dữ liệu linh hoạt và tối ưu hơn.
Hướng dẫn thiết lập bằng cách:
Chọn Module Console và chọn Connection là GCP Big Query
Tại connection muốn cấu hình, chọn button Setting
Tại thanh menu bên trái, chọn Output Tables
#Bước 1: Để có thể nhập giá trị tại trường Time Partition, trước đó người vận hành cần phải tự khai báo giá trị cho field Time Partition, bằng cách như sau:
Tại Output Tables, người vận hành chọn icon Setting
để mở giao diện Event Builder
Khi này, người vận hành có thể chọn Field và nhập Column Name cần đồng bộ dữ liệu lên Big Query để hoàn tất cấu hình.

#Bước 2: Cấu hình Time Partition
Quay lại Output Tables, chọn tiếp button Add
hoặc Edit để mở giao diện cấu hình.
Tại trường Time Partition, nhập giá trị trùng với Column Name đã khai báo ở bước trên để hoàn tất.

Form builder: thêm tooltips hướng dẫn nhập đúng cấu trúc cho trường fieldName trên các Element
Trước đây, các trường Field Name trong Form Builder cho phép nhập bất kỳ ký tự nào (space, số, ký tự đặc biệt...). Không có gợi ý khi người dùng nhập sai định dạng. Người dùng dễ nhập sai, hệ thống vẫn chấp nhận → gây lỗi tiềm ẩn trong quá trình sử dụng.
Bản cập nhật hiện tại đã thêm tooltip hướng dẫn khi nhập Field Name: "Enter the name without spaces. You can use an underscore ‘_’. For example: FieldName, field_name". Bổ sung rule validation cho Field Name: Chỉ cho phép ký tự alphabet (A–Z, a–z), có thể kèm 1 dấu gạch dưới _
không chấp nhận space, số, hoặc ký tự đặc biệt.

Pango Short Link: bổ sung thêm cơ chế Quota Limitation quản lý giới hạn tạo và theo dõi số lượng
Cập nhật thêm các tính năng quản lý Limitation Quota trên Pango Short Link Service vừa được phát hành trong thời gian gần đầy. Các cập nhật bao gồm:
Thêm trường Quota Litmitation trên Extend Paramerter: cho phép người vận hành nhập số lượng tối đa (theo gói doanh nghiệp đăng ký trước đó).
⇒ Khi Connection đạt số lượt Short Link tối đa, sẽ tự động Enable Connection (không thể call để tạo được Short Link nữa).

Thống kê danh sách Short Link đã tạo trên Connection từ mọi nguồn: khi một Short Link được tạo ra sẽ ghi nhận thêm vào Total Generate (các Short Link đã xoá vẫn được tính trong tổng số này).

ZMA Setting - Rules: thêm tính năng cho phép chặn các User trong Cheater Model có thể truy cập ZMA
Hiện trạng: khi các User trong Cheater Model vào các ZMA của Pango → hệ thống sẽ không ghi nhận các hành vi của User (không ghi lại log, không trả thưởng,...) → tuy nhiên vẫn được truy cập ZMA dẫn đến một vài bất cập trong vận hành như:
Gây ra chênh lệch số lượng User truy cập ZMA → thực hiện các hành vi kỳ vọng
Báo các lỗi về miss event log phải kiểm tra thêm
Gây sai lệch trong các chỉ số report không mong muốn
⇒ Cập nhật mới cho phép chặn các User từ Cheater Model truy cập ZMA ngay từ ban đầu.
Hướng dẫn cập nhật mới trên Zalo Mini App Settings:
Thêm tính năng Access Limitation Cheater trên menu Access Limitation
Turn-on để áp dụng: chặn các User nằm trong Model Cheater vào ZMA có thiết lập
Khi User vào ZMA hệ thống sẽ dùng Zalo User App Id để kiểm tra trong model Cheater
Nếu matching → nghĩa là User nằm trong Cheater model sẽ kiểm tra thêm các điều kiện lọc
Service Types: lý do bị đánh Cheater của User
Zalo Mini App: app ghi nhận hành vi Cheater của User
Khi bỏ trống hệ thống sẽ mặc định chọn tất cả

ZMA Setting - Rules: thêm tính năng cho phép một nhóm User trong Data Model của Pango mới có thể truy cập ZMA
Trước đây, khi triển khai các Campaign dành cho tệp User đặc biệt, đặc thù - không dành cho các khách hàng vãng lai vào ZMA ⇒ chưa khả thi vì chưa thể ràng buộc cơ chế cho phép tệp User nào được truy cập. Team vận hành thường xử lý bằng các Use Case như:
Pango Form: sử dụng element Verify Code để truyền mã đặc biệt được tạo trước và thêm vào liên kết truy cập App
Sử dụng DMA Workflow để kiểm tra hành động của User trên các ZMA từ đó mới thực hiện tiếp các hành động như: trả thưởng, tặng quà, thông báo, cho phép mua hàng, telesale,...
Sử dụng UTM riêng để hiển thị các trường điền thông tin ⇒ chỉ share các UTM này cho nhóm đặc biệt
⇒ Điểm chung của các hành động chỉ xử lý vấn đề theo hướng giải pháp tạm thời và gặp các hạn chế như:
Cần thiết lập thêm các luồng kiểm tra lại thông tin, mất thời gian và dễ gây sai sót
Đa phần User đều đã tương tác với ZMA ⇒ sau đó nhận thông điệp “không thỏa điều kiện…” ⇒ dẫn đến trải nghiệm không tốt của User
Cập nhật mới nhất trên tính năng Access Limitation Model: cho phép chỉ định nhóm User cụ thể nằm trong Model ZMA Eligible của Pango mới cho truy cập vào ZMA.
Hướng dẫn thực hiện bằng cách:
Truy cập vào cấu hình Access Restriction Rule của ZMA, chọn cấu hình Access Limitation Model
Turn-on để áp dụng: chỉ cho phép User từ Model ZMA Eligible được thiết lập truy cập ZMA
Khi User vào ZMA hệ thống sẽ dùng Key được chọn để kiểm tra trong model cho phép
Nếu matching → nghĩa là User nằm trong model sẽ kiểm tra thêm các điều kiện lọc
Source: sử dụng giá trị field Source trong Model (nếu có) để kiểm tra
Zalo Mini App: sử dụng giá trị ZMA trong Model (nếu có) để kiểm tra
Key hỗ trợ: Phone/Email/ZUID/ZUAID
⇒ Người vận hành cần đảm bảo tổ chức Data Model trước theo các trường thông tin sử dụng

Một số lưu ý khi triển khai nội dung này:
Người vận hành tự tổ chức Custom Model và chọn loại ZMA Eligible
Mỗi ZMA chỉ phép chọn 01 model để cho phép User truy cập, người vận hành tự tổ chức model này cho phù hợp bao gồm (số lượng; tối đa 5000 record và key để ZMA sử dụng làm matching key)
Pango Reward: thêm cơ chế nhập mã thay thế mã QR cho campaign type Scan Product QR
Trước đây, Người dùng chỉ có thể quét mã QR trên sản phẩm để tích điểm trong chiến dịch Reward. Tuy nhiên, mã QR thường được phủ lớp tráng bạc hoặc dễ bị hư hại trong quá trình bảo quản, dẫn đến tình trạng không thể quét để tích điểm.
Bản cập nhật hiện tại, Pango Reward đã bổ sung tính năng nhập mã QR thủ công để thay thế quét mã, giúp người dùng dễ dàng tích điểm ngay cả khi mã QR bị hư hỏng hoặc không nhận diện được.

Hướng dẫn truy cập:
Chọn module ACT Console, chọn button Setting tại campaign Reward có campaign type Scan Product QR cần cấu hình
Chọn Custom UI App Reward
Tại thanh menu bên trái, chọn Scan Product QR, khi này người vận hành cần điền các trường thông tin như sau

Allow manually enter product QR code
Khi enable toggle, hệ thống sẽ hiển thị thêm phương thức nhập mã Product QR Code
Button: Missions Scan Product QR
Nội dung button Quét mã Product QR Code tại giao diện hiển thị các button thực hiện nhiệm vụ
Button: Enter Product QR Code
Nội dung button Nhập mã Product QR Code tại giao diện hiển thị các button thực hiện nhiệm vụ
Title
Tiêu đề của giao diện Nhập mã Product QR Code
Description
Mô tả của giao diện Nhập mã Product QR Code
Input Label
Tiêu đề trường nhập mã của giao diện Nhập mã Product QR Code
Input Placeholder
Placeholder trường nhập mã của giao diện Nhập mã Product QR Code
Lưu ý:
Để thực hiện nhập mã Product QR Code, tại Point Earning Rule, mục Applicable Products, người vận hành cần chọn Specific Batch QR và chọn tiếp Batch Product QR tương ứng.
Mã Product QR Code chính là trường Code của Product QR Code khi được generate/import trong Batch của Campaign Reward.

Pango Reward: áp dụng cơ chế Fraud Detector Rule cho các tính năng nhập hoặc quét mã
Trước đây, ứng dụng Pango Reward chưa có cơ chế phát hiện và chặn gian lận trong các hoạt động nhập hoặc quét mã. Điều này tạo kẽ hở cho người dùng gian lận điểm thưởng, gây ảnh hưởng đến hiệu quả chiến dịch.
Bản cập nhật hiện tại, Pango Reward chính thức tích hợp Fraud Detector Rule để nâng cao khả năng kiểm soát và bảo mật, giúp thương hiệu quản lý điểm thưởng hiệu quả hơn.
Cụ thể có các nhóm Service Type như sau:
ACT. Verify Code: apply cho campaign Reward type Scan Product QR và Scan Identify QR
UseBill: apply cho campaign Reward type Scan Bill QR
ACT. Verify QR Code: apply cho campaign rReward type Scan Product QR và Scan Identify QR
ACT. Verify Product Unique Code: apply cho campaign Reward type Collect Product Unique Code
Ngoài ra, bản cập nhật mới còn bổ sung trường mặc định trong Detail Rule: fromLength, toLength để định nghĩa độ dài mã hợp lệ. Hai trường thông tin này là bắt buộc cho các nhóm Service Type liên quan đến: ACT. Verify Code và ACT. Verify Product Unique Code.

Đây là bản cập nhật số #64 của chúng tôi cho tuần này. Hãy chờ đón nhiều cập nhật và thông tin thú vị hơn trong bản tin tiếp theo của chúng tôi. Cảm ơn sự góp ý và chờ đợi từ phía các bạn!
Product Team
Last updated
Was this helpful?