[24/09/25] Weekly Release
#68 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ó)
Trong bảng Release tuần này có gì?
Console ACT: bổ sung PTCR tại menu ACT Console
Trước đây, nhóm chức năng PTCR được cấu hình tại Module Activation. Để thực hiện các thao tác liên quan, người vận hành vẫn cần quay lại hệ thống ACT cũ để thiết lập, điều này gây gián đoạn trải nghiệm và làm tăng thời gian thao tác.
Cập nhật mới cho phép người dùng thực hiện toàn bộ thao tác quản lý PTCR ngay trên Console ACT. Các tính năng được giữ nguyên về mặt logic xử lý, nhưng được thiết kế lại để tối ưu trải nghiệm người dùng: giao diện trực quan hơn, thao tác tập trung tại một nơi duy nhất.
Console ACT: bổ sung giao diện Orders tại Campaign Reward
Trước đây, chức năng Orders được quản lý tại Module Activation. Với các chức năng chưa được hỗ trợ trong Console ACT, người vận hành vẫn cần quay lại ACT để thực hiện thiết lập, điều này gây gián đoạn trải nghiệm và làm tăng thời gian thao tác cho người vận hành.
Bản cập nhật mới cho phép người dùng thực hiện toàn bộ thao tác quản lý Orders trên Console ACT. Các tính năng được giữ nguyên về mặt logic xử lý, tuy nhiên ở bản cập nhật này, Orders sẽ được quản lý theo từng campaign Rewards.
Hướng dẫn truy cập:
Truy cập vào module Console ACT, chọn menu Reward
Chọn campaign Reward cần xem Orders
Tại thông tin chi tiết của campaign, chọn sub-menu Orders
CDP: bổ sung field userPhone tại model User & Gift
Trước đây, khi đồng bộ dữ liệu User & Gift từ Module ACT hoặc Console ACT qua CDP, không hỗ trợ trường userPhone. Điều này làm hạn chế khả năng của người vận hành trong việc sử dụng model này cho các kịch bản cần thiết.
Bản cập nhật mới đã bổ sung trường Phone, nhằm hỗ trợ người vận hành sử dụng model trong nhiều ngữ cảnh triển khai các chiến dịch hơn, đặc biệt là các hoạt động cần đến dữ liệu số điện thoại của người dùng.
Console ACT: bổ sung tuỳ chọn connection Top-up và Digital Gift trong các phần tích hợp
Trên giao diện Console Activation, cập nhật trên các tính năng quà tặng Manage Gift
Phone Top-up: bổ sung các Connection Top-up đã tích hợp với các vendor đầy đủ
Vietguys Top-up version 1 và 2
UrBox Top-up Service
Gotit Top-up Service
Digital Gift: bổ sung các Connection quà tặng Digital với UrBox bên cạnh connection Giftee đã tích hợp
Console: cho phép cấu hình trạng thái Success Mode tại Postback API và Webhook
Trước đây, đối với các tích hợp bằng Postback API hoặc Webhook của PangoCDP, khi 3rd system tích hợp cần phải tra đúng cấu trúc đã được quy định sẵn bởi hệ thống Pango ⇒ mới ghi nhận trạng thái Success khi nhận dữ liệu từ bên tích hợp. Điều này gây ra bất cập trong việc tích hợp và đối chiếu dữ liệu vì đối với các bên khác nhau, trạng thái ghi nhận thành công sẽ được truyền tải bằng các phương thức, thông điệp hoàn toàn khác nhau. Việc đưa về một cấu trúc chung vô tình phải khiến một trong hai bên thay đổi cấu trúc API của mình trong việc tích hợp.
Một số ví dụ về sự đa dạng trong việc thể hiện cùng một trạng thái thành công:
Status: "OK", "Ok", "ok", "Success", "SUCCESS", "Confirmed", "Confirm", "CONFIRMED", "True", "TRUE", ...
Success: "OK", "Ok", "ok", "True", "TRUE", ...
Cập nhật mới trên các Connection Webhook và Postback API cho phép người vận hành tự động thiết lập các ngữ cảnh, nội dung ghi nhận trạng thái thành công của việc tích hợp dữ liệu. Điều này giúp các bên tích hợp hay bản thân Pango không cần thay đổi cấu trúc dữ liệu API ⇒ dẫn đến thuận tiện và linh hoạt hơn trong các dự án tích hợp và tuỳ chọn trong việc quy định trạng thái Success - nếu có thay đổi trong quá trình vận hành từ phía 3rd System cũng có thể linh hoạt vào tự thay đổi.
Hướng dẫn thực hiện bằng cách
Đối với Webhook Connection:
Vào Console ⇒ Connection ⇒ Webhook ⇒ chọn Webhook Connection cần thực hiện
Trên giao diện Extend Parameters, chọn cấu hình Success Mode để sử dụng
Đối với Postback API connection:
Vào Console ⇒ Connection ⇒ Postback API ⇒ Access Data API ⇒ chọn Connection cần thực hiện
Trên giao diện Connection Settings, phần Response ⇒ chọn cấu hình Success Mode để sử dụng
Giải thích và hướng dẫn sử dụng các cấu hình trong Success Mode:
Expect JSON {success: true/false}: nếu như 3rd trả về kết quả của việc đẩy dữ liệu trên trường Success ⇒ sử dụng tuỳ chọn này để ghi nhận mọi kết quả ghi nhận thành công, bao gồm: True/False hoặc Yes/No. Ví dụ: success: "true" hay success: "True" hay success: "Yes" ⇒ đều ghi nhận là Thành công.
Các key dùng để ghi nhận kết quả bao gồm: "success", "is_success", "isSuccess", "Success", "SUCCESS"
Các key dùng để ghi nhận giá trị bao gồm: (true/false), (Y/N), (Yes/No), (1/0)
Riêng Access Token API chọn version 2: chỉ hỗ trợ các key: "success", "isSuscees", "statusCode"
Consider success if HTTP status is 2xx: ghi nhận trạng thái thành công khi nhận phản hồi từ HTTP Code của 3rd System ⇒ nếu code này trong khoảng từ 200 đến 299 ⇒ ghi nhận trạng thái Thành công.
Check specfic JSON field matches expected value: kiểm tra key tuỳ chọn trong JSON để quy định trạng thái thành công ⇒ cho phép linh hoạt và tối ưu vận hành. Để sử dụng tuỳ chọn này, cần cần hính thêm Custom Field/Custom Field Path để khai báo hàm để kiểm tra:
Cấu trúc như sau: "key:value"
key - trường chứa dữ liệu cần kiểm tra
value - giá trị dùng để đối chiếu trạng thái thành công
Ví dụ: "howIntegrate:Good" ⇒ kiểm tra trong Json nếu có Key = "howIntegrate" sẽ đi kiểm tra value nếu bằng "Good" thì ghi nhận Success
Đây là bản cập nhật số #68 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?