[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ó)

3

Podcast Release

Phiên bản Podcast dành cho Release Note #65

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:

  1. Thay đổi giao diện trên menu Access Limitation cho tính năng Total Event Times

  2. 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)

  3. 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

  4. 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

  5. Nếu thỏa các điều kiện trong Validation, sẽ không tính Event này vào Quotation

  6. 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.

Các hàm hỗ trợ Validation Script - cập nhật tháng 09.2025

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.

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.


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:

  1. 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).

  1. 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:

  1. Thêm tính năng Access Limitation Cheater trên menu Access Limitation

  2. Turn-on để áp dụng: chặn các User nằm trong Model Cheater vào ZMA có thiết lập

  3. Khi User vào ZMA hệ thống sẽ dùng Zalo User App Id để kiểm tra trong model Cheater

  4. 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

  5. Service Types: lý do bị đánh Cheater của User

  6. Zalo Mini App: app ghi nhận hành vi Cheater của User

  7. 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:

  1. Truy cập vào cấu hình Access Restriction Rule của ZMA, chọn cấu hình Access Limitation Model

  2. Turn-on để áp dụng: chỉ cho phép User từ Model ZMA Eligible được thiết lập truy cập ZMA

  3. Khi User vào ZMA hệ thống sẽ dùng Key được chọn để kiểm tra trong model cho phép

  4. 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

  5. Source: sử dụng giá trị field Source trong Model (nếu có) để kiểm tra

  6. Zalo Mini App: sử dụng giá trị ZMA trong Model (nếu có) để kiểm tra

  7. 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


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

Trường thông tin
Mô tả

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?