[07/05/25] Weekly Release

Trong bảng Release tuần này có gì?

1. Pango Form: cập nhật thêm trường nhập Required Text cho các Element

2. Cập nhật giao diện cảnh báo ngưng sử dụng dịch vụ Firebase Dynamic Links

3. Pango Gift: bổ sung điều kiện Unlock để mở chi tiết quà tặng

4. PTCR: khi thay đổi thiết lập thêm cảnh báo để cập nhật lại Auto Complete Mission trên ZMA

5. Pango Form: Display Condition hỗ trợ thêm tuỳ chọn Not Likes trong Operator

6. Pango Form: cập nhật element QR Code khi redeem mở đúng ZMA Scan thiết lập tại Campaign QR

7. Thêm tính năng correctPhone trên Transform Parameter

8. Pango Scan: thêm trường nhập Email khi tạo Account PG

9. Pango Console: Bổ sung tính năng cho phép chỉnh sửa Object Model khi Clone Webhook Event

10. DMA: nâng giới hạn Max time tại element ACT. +/- Reward Points

11. Chuyển đổi Model Cheater từ System sang Custom để ứng dụng được trên các tính năng khác

12. API Ingestion Data: thêm thông báo khi push fail qua Telegram Group

New Feature

Pango Form: cập nhật thêm trường nhập Required Text cho các Element

Trước đây, các trường bắt buộc trong Pango Form chỉ hiển thị thông báo mặc định khi chưa được điền. Hiểu được nhu cầu tùy chỉnh nội dung cảnh báo theo từng ngữ cảnh sử dụng, Pango Form vừa được cập nhật với tính năng mới: bổ sung trường nhập "Required Text" cho từng Element.

Với bản cập nhật này, bạn có thể dễ dàng thiết lập nội dung thông báo riêng khi người dùng chưa nhập thông tin bắt buộc, từ đó nâng cao trải nghiệm và tính linh hoạt trong quá trình thiết kế biểu mẫu.

Hướng dẫn thiết lập bằng cách:

• Truy cập vào Module Console, sử dụng tính năng thiết lập Form Builder

• Khi thiết lập Element, chọn tab cấu hình Settings

• Bật chức năng "Required"

• Điền nội dung cảnh báo

• Lưu Form và sử dụng

Thêm tính năng correctPhone trên Transform Parameter

Áp dụng mới cho việc chuyển đổi dữ liệu bằng chức năng Transform cho phép chuyển đổi giá trị định dạng Phone về một cấu trúc nhất định trước khi thực hiện đẩy dữ liệu đó qua Webhook hoặc nhận về trên Pango Model.

Sử dụng cấu trúc:

correctPhoneNumber(field, countrycode,false)=dest

Trong đó:

• correctPhoneNumber: hàm khai báo dùng để thực hiện Transform Data

• field: giá trị Key của Data Field chứa số điện thoại được dùng để định dạng

• countrycode: mã vùng số điện thoại tại khu vực (Việt Nam: nhập 84)

• false/true: chọn định dạng chuyển đổi của số điện thoại

  • false: có ý nghĩa từ chối định dạng bắt đầu bằng 84 ⇒ chuyển tất cả giá trị về định dạng bắt đầu bằng 0.

    • Ví dụ: giá trị số điện thoại là 84987654321 sẽ chuyển thành 0987654321; còn nếu định dạng ban đầu là 0987654321 sẽ giữ nguyên giá trị 0987654321.

  • true: có ý nghĩa chấp nhận định dạng bắt đầu bằng 84 ⇒ chuyển tất cả giá trị về định dạng bắt đầu bằng 84.

    • Ví dụ: giá trị số điện thoại là 84987654321 sẽ giữ nguyên giá trị 84987654321; còn nếu định dạng ban đầu là 0987654321 sẽ chuyển thành 84987654321.

Chuyển đổi Model Cheater từ System sang Custom để ứng dụng được trên các tính năng khác

Trong quá trình tương tác với ZMA của Pango, nếu User thực hiện các hành động vi phạm vào Fraud Detector Rules sẽ bị đánh dấu và thêm vào danh sách Cheaters. Danh sách này trước đây là một System Model, do đó bị hạn chế khi có nhu cầu ứng dụng trong các tính năng trên hệ thống,

Hiểu được điều này, chúng tối tiến hành chuyển đổi việc quản lý danh sách Cheaters từ System sang Custom Model - nhưng vẫn giữ được các tính năng tự động hiện có (không yêu cầu người vận hành thực hiện thêm hành động nào để sử dụng).

Đối với thay đổi này, người vận hành có thể áp dụng danh sách Cheaters để thực hiện một số tiện ích chẳng hạn như:

• Áp dụng trên DMA để kiểm tra danh sách Users vi phạm để loại trừ trước khi thực hiện tương tác

• Dùng tính năng Import để thêm thông tin người dùng vi phạm từ các nguồn khác, nhằm hạn chế hành động của họ trên ZMA.

• Tính toán lại các Segment một cách chính xác hơn bằng cách loại trừ nhóm này

• Và nhiều tiện ích khác sẽ được chúng tôi cập nhật thêm...

API Ingestion Data: thêm thông báo khi thực hiện thất bại qua Telegram Group

Trong quá trình thực hiện Ingest Data vào Pango, có thể phát sinh những tình huống ghi nhận dữ liệu thất bại đến từ nhiều lý do khác nhau. Bên cạnh đó, các luồng Ingest dữ liệu đã thiết lập sẵn và chạy theo Schedule (thời gian theo lịch định kỳ) cũng có thể gặp tình huống chạy thất bại nếu các hệ thống có thay đổi không báo trước. Việc theo dõi để vận hành các hành động này trước đây phụ thuộc nhiều vào người vận hành phải tự kiểm tra trên những Model đã thiết lập trước đó.

Hiểu được khó khăn này, chúng tôi bổ sung thêm thông báo cho người vận hành khi Ingest Data vào hệ thống gặp vấn đề (được hiểu là xảy ra nhiều hành động Fail trong một thời gian ngắn).

Hướng dẫn thực hiện bằng cách:

• Truy cập vào Model Console, chọn menu Settings

• Chọn submenu Notification, chọn Telegram Bot

• Tại giao diện mở ra, chọn tab Enabled Notification

• Tìm kiếm nội dung có tên Api Ingestion Failed

• Enable để sử dụng

Improve

Cập nhật giao diện cảnh báo ngưng sử dụng dịch vụ Firebase Dynamic Links

Trước đây, Firebase Dynamic Links được sử dụng để tạo short link cho SMS và phục vụ cho mục đích tracking người dùng. Tuy nhiên, theo thông báo từ Firebase, tính năng Dynamic Links sẽ chính thức ngừng hoạt động vào ngày 25/08/2025. Sau thời điểm này, các liên kết Firebase Dynamic Links đã tạo trước đó sẽ không còn sử dụng được.

Hiểu được mức độ ảnh hưởng của thay đổi này, hệ thống đã được cập nhật để bổ sung giao diện cảnh báo ngừng sử dụng Firebase Dynamic Links tại tất cả các vị trí có liên quan. Cập nhật này nhằm đảm bảo người dùng được thông báo rõ ràng và có đủ thời gian để thay thế bằng giải pháp phù hợp khác.

Pango Gift: bổ sung điều kiện Unlock để mở chi tiết quà tặng

Trước đây, trong Pango Gift, các chương trình quà tặng tại Batch Voucher Version 2 chỉ hỗ trợ hai điều kiện mở quà (Conditions): Submit Form và Follow OA.

Nhằm tăng tính linh hoạt và hỗ trợ các chiến dịch thu thập thông tin hiệu quả hơn, hệ thống vừa được cập nhật với điều kiện mở quà mới: Chia sẻ Avatar, Tên và Số điện thoại (Share Avatar, Name, and Phone Number).

Với cập nhật này, bạn có thể thiết lập thêm một bước xác minh danh tính trước khi người dùng mở được phần quà, từ đó giúp cải thiện chất lượng thu thập dữ liệu và cá nhân hóa trải nghiệm tốt hơn.

Hướng dẫn thiết lập bằng cách:

• Truy cập vào Module Activate

• Chọn VOUCHER / Batch Vouchers Version 2

• Tạo mới hoặc chỉnh sửa Batch Voucher

• Bật toggle "Unlock to receive gift"

• Chọn điều kiện "Share Avatar, Name, and Phone Number"

PTCR: khi thay đổi thiết lập thêm cảnh báo để cập nhật lại Auto Complete Mission trên ZMA

PTCR đối với nhiệm vụ Submit trên Pango Form ⇒ có thể sử dụng tính năng Auto Complete Mission khi vào thằng Mission App mà không thông qua Source App (gọi là Direct Source) - xem chi tiết tại đây. Xảy ra trường hợp khi thay đổi thông tin App Source trên PTCR Mission ⇒ hệ thống không tự động đồng bộ sang ZMA Setting này mà yêu cầu người vận hành cần thực hiện thao tác Update lại để cập nhật lại Source App mới.

Nhằm nâng cao trải nghiệm người thiết lập và đảm bảo không bỏ lỡ việc cập nhật khi thực hiện thay đổi Source App trên PTCR Mission ⇒ thêm cảnh báo khi có thay đổi tạo ảnh hưởng đến Auto Complete Task.

Khi có sự thay đổi đối với thông tin Source App - hệ thống sẽ kiểm tra nếu có cấu hình Auto Complete Task ⇒ hiển thị giao diện thông báo cần người vận hành xác nhận việc đã Update cấu hình trên ZMA.

• Nội dung hiển thị: Để đảm bảo các thay đổi mới nhất trong PTCR được phản ánh vào ZMA, vui lòng xác nhận rằng bạn đã hoàn tất việc cập nhật PTCR.

• Thông tin ZMA đang thiết lập: tên và liên kết mở ra giao diện cấu hình Auto Complete Task.

• Chọn check box đã thực hiện và Confirm.

Pango Form: Display Condition hỗ trợ thêm tuỳ chọn Not Likes trong Operator

Trước đây, khi sử dụng tính năng Display Condition trên các Element của Pango Form, chỉ được hiển thị khi đáp ứng các điều kiện cụ thể trong quá trình tương tác với ZMA. Tuy nhiên, không hỗ trợ điều kiện Not Likes các Value được thiết lập ⇒ dẫn đến một chút bất cập khi người vận hành cần loại bỏ một số giá trị không đúng kỳ vọng (nhưng khác Not Equals ở chỗ chỉ loại bỏ các giá trị giống một phần chứ không phải đúng chính xác).

Cập nhật mới, bổ sung giá trị Not Likes trong tuỳ chọn Operator để loại các Data Field có Value giống với các giá trị cần loại bỏ.

Hướng dẫn thiết lập bằng cách:

• Truy cập vào Module Console, sử dụng tính năng thiết lập Form Builder

• Khi thiết lập Element, chọn tab cấu hình Display conditions

• Thiết lập các tuỳ chọn phù hợp, trong đó cần chú ý:

  • Control field name: chọn Data Field được dùng để kiểm tra giá trị

  • Operator: chọn tuỳ chọn Not Likes

  • Value: nhập Data Value cần kiểm tra khi User chọn/nhập trên Pango Form nếu chứa sẽ ẩn Element

Pango Form: cập nhật element QR Code khi redeem mở đúng ZMA Scan thiết lập tại Campaign QR

Trong các trường hợp Sampling hoặc Voucher Drop mà quà tặng được cung cấp dưới dạng mã QR để đổi trên ứng dụng Pango Form, người dùng cần hoàn thành một nhiệm vụ trên Pango Form để nhận mã đổi thưởng dưới dạng QR Code qua Thanks Form hoặc tin nhắn ZUID. Nếu có áp dụng đổi quà tặng, cần có sự tham gia của đội ngũ PG, sử dụng ứng dụng Pango Scan dùng để quét các mã QR này và đổi quà tặng tương ứng cho Khách hàng.

Trước đây, hệ thống luôn mặc định sử dụng ứng dụng Pango Scan (SaaS) của Pango khi PG thực hiện quét mã trực tiếp từ Camera của Zalo để trả thưởng. Điều này dẫn đến việc không thể triển khai ZMA Builder riêng của Brand.

Cập nhật mới cho phép ứng dụng Pango Form sử dụng cấu hình Set up Default App của QR Campaign để quy định mở ZMA Scan tương ứng. Khi thực hiện tạo mã QR trả thưởng trên Thanks Form ⇒ sẽ điều hướng mở app Scan được thiết lập trong QR Campaign.

Hướng dẫn thiết lập bằng cách:

• Truy cập Module Console-ACT, chọn Menu Campaign

• Chọn Sampling ⇒ tìm QR Campaign cần cấu hình ⇒ ấn Setting

• Trên giao diện cấu hình QR Campaign, chọn menu Pango Scan Config

• Enable cấu hình Set up Default App

• Chọn ZMA Scan được tạo riêng dành cho Brand để sử dụng

Pango Scan: Bổ sung trường nhập Email khi tạo Account PG

Trước đây, Account PG trên hệ thống chưa có trường thông tin "Email", dẫn đến việc gây hạn chế trong việc quản lý thông tin liên hệ và khai thác dữ liệu của các PG.

Chính vì vậy, trong bản cập nhật mới lần này, Pango đã bổ sung trường thông tin "Email" khi thực hiện tạo và Import/ Export Account PG trên Module ACT.

Ngoài ra, chúng tôi cũng bổ sung trường "Email" khi thực hiện đồng bộ dữ liệu từ ACT sang CDP. Việc mở rộng trường thông tin này giúp đảm bảo tính đầy đủ, nhất quán trong toàn hệ thống và hỗ trợ doanh nghiệp quản lý dữ liệu hiệu quả hơn.

Pango Console: Bổ sung tính năng cho phép chỉnh sửa Object Model khi Clone Webhook Event

Trước đây, khi thực hiện Clone Webhook Event, người vận hành không thể thay đổi Object Model đi kèm. Điều này gây bất tiện trong những trường hợp cần lưu dữ liệu về một Custom Model khác phù hợp hơn với mục đích sử dụng.

Hiện tại, Pango đã bổ sung tùy chọn chỉnh sửa Object Model trong quá trình Clone Webhook Event. Người vận hành có thể chủ động chọn lại Custom Model mong muốn, từ đó giúp việc cấu hình và tổ chức dữ liệu linh hoạt hơn.

Hướng dẫn thiết lập bằng cách:

• Truy cập Module Console

• Chọn Connections, chọn PangoCDP Webhook và chọn Webhook Connection

• Trên giao diện Webhook Connection, chọn Webhook Event cần Clone

• Tại trường Object Model, enable toggle Custom Model

• Khi này, hệ thống hiển thị dropdown bao gồm danh sách các Custom Model mà người vận hành có thể chọn

DMA: nâng giới hạn Max time tại element ACT. +/- Reward Points

Trước đây, khi sử dụng cộng điểm trên DMA bằng element ACT. +/- Reward Points hệ thống chỉ cho phép thực hiện cộng điểm tối đa 1000 lần cho mỗi Users trên Workflow. Điều này dẫn đến những ngữ cảnh không thể triển khai khi các User có hành động cho phép cộng điểm lặp đi lặp lại trên 1000 lần.

Hiểu được điều đó, chúng tôi nâng giới hạn cộng điểm cho mỗi User trên DMA Workflow lên thành 10.000 lần (tức gấp 10 lần số cũ). Hy vọng mang lại sự thuận tiện và giới hạn mới để đội ngũ vận hành hợp tác cùng khách hàng thực hiện được những chiến dịch đạt đủ cột mốc này.

Đây là bản cập nhật số #49 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