[19/03/25] Weekly Release

#43 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ì?

1. Pango Form: ra mắt Premium - Element mới Scan QR Code & QR Code Info

2. Pango Form: ra mắt Premium - Element mới Lookup Info

3. DMA Workflow: nhóm Check Condition thêm element Filter API Callback

4. PTCR Mission: thêm Extend Value giá trị đơn hàng vào cấu trúc Response

5. Model Zalo OA Profile thêm filter bằng thời gian Record được tạo ra bằng createdAt

6. Áp dụng Whitelist IP của BigQuerry trên Connection Pango

7. Thêm Json View để kiểm tra dữ liệu phản hồi trước khi sync dữ liệu 01 User cụ thể từ Zalo

8. DMA Workflow: cập nhật element ACT +/- Reward Points cho phép cộng điểm bằng số điện thoại & User chưa tham gia Campaign

New Feature

Pango Form: ra mắt Premium - Element mới Scan QR Code & QR Code Info

• Giải thích và hướng dẫn chi tiết element Scan QR Code, xem bài viết bên dưới

Scan QR Code | Pango Help Centerhelp.pangocdp.com

• Giải thích và hướng dẫn chi tiết element QR Code Info, xem bài viết bên dưới

QR Code Info | Pango Help Centerhelp.pangocdp.com

Pango Form: ra mắt Premium - Element mới Lookup Info

• Giải thích và hướng dẫn chi tiết element Lookup Info, xem bài viết bên dưới

Lookup Info | Pango Help Centerhelp.pangocdp.com

DMA Workflow: nhóm Check Condition thêm element Filter API Callback

Bổ sung Element mới trên DMA cho phép kết nối với một 3rd Partner System để nhận giá trị phản hồi theo dạng True/False từ đó xử lý tiếp trên Flow. Tài liệu API tích hợp được cung cấp bên dưới

https://docs.google.com/document/d/1Tz0YmDm5ZHFE6oplAQsdaHtYeLeWl8WS8KbEXjGMwOU/edit?tab=t.0docs.google.com

Ngữ cảnh đề xuất: sử dụng để kiểm tra tính đúng sai của một số giá trị có tính bảo mật, không chia sẻ qua các hệ thống bên ngoài như: thông tin khách hàng, thông tin dùng để tra cứu, mã kiểm soát,...

Ví dụ: sử dụng số điện thoại để kiểm tra xem người dùng có đăng ký hạn thành viên của Brand hay chưa, kiểm tra mã đật hàng của khách hàng, kiểm tra mã số nhận thưởng của khách hàng,....

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

• Truy cập Module DMA, vào cấu hình Workflow

• Kéo element Filter API Callback vào để sử dụng

• Endpoint: nhập địa chỉ dùng để gọi sang kiểm tra (thuộc 3rd system, được partner cung cấp)

• Authen: chọn hình thức xác thực khi gọi API

  • Api Key: nhập mã được quy định để kết nối, partner cung cấp

    • Key: lable để khai báo mã

    • Value: giá trị mã cần điền để truyền sang mỗi lần gọi API

  • API Token: sử dụng Connection API của Pango để xác thực, được tạo trước và xác thực sẵn

  • None: không sử dụng các hình thức xác thực mỗi lần gọi sang 3rd Partner System

• Whitelist IP: dùng IP của Pango thêm vào danh sách Whitelist của User

• Data Request

  • Request Header: thêm nội dung vào phần header để khai báo

    • Key: lable khai báo giá trị

    • Value: nhập giá trị truyền sang theo Key

    • Duplicate keys will overwrite existing ones: khi truyền dữ liệu, nếu có 2 key giống nhau sẽ thay đổi giá trị của một cái và chỉ truyền một.

  • Request Data Key: giá trị truyền sang để kiểm tra thông tin

    • Phone Number: số điện thoại

    • Email: địa chỉ email

    • Zalo User Id: Id của User khi người dùng follow OA, mỗi người dùng có 01 ID duy nhất dưới một Zalo Official Account

    • Use context value: sử dụng giá trị

  • Request Data Field: giá trị dùng khai báo key kiểm tra dữ liệu truyền qua hệ thống Partner

  • Transform Delivery Data: chuyển đổi dữ liệu theo định dạng hỗ trợ trên tài liệu này.

  • Step Name: nhập tên của bước thực hiện

  • Conversion: đánh đấu để theo dõi tỉ lệ chuyển đổi trên Flow

DMA Workflow: cập nhật element ACT. +/- Reward Points cho phép cộng điểm bằng số điện thoại & User chưa tham gia Campaign

Trước đây, để cộng điểm vào Campaign từ element ACT. +/- Reward Points chỉ có thể thực hiện thành công nếu User đã tham gia Campaign trước đó. Đối với các trường hợp chưa tham gia, sẽ tạo data log tích điểm ⇒ nghĩa là không thực hiện được vì User chưa tham gia.

Cập nhật mới cho phép User có thể:

• Được cộng điểm trước dù chưa tham gia Reward Campaign

• Cộng điểm cho User bằng cả 02 hình thức: Zalo User App ID và Phone (số điện thoại)

Nếu User chưa tham gia chương trình Reward, vẫn sẽ tạo data log với số điểm cộng tương ứng trước. Khi họ tham gia thành công sẽ kiểm tra và cập nhật điểm cho User này.

Trên cấu hình của element ACT. +/- Reward Points, trường Unique By có thêm tuỳ chọn Phone Number.

Improve

PTCR Mission: Pango Sell thêm Extend Value giá trị đơn hàng vào cấu trúc Response

Tiếp nối mô hình PTCR Service - một ZMA Source mở Pango ZMA Mission để thực hiện hành động được xem như hoàn thành nhiệm vụ để nhận lại kết quả trên app Source.

• Áp dụng: Pango Sell

• Hành động: place-order (hoàn thành việc đặt mua hàng trên app)

• Mô hình: S2S

• Thêm các tham số liên quan đến đơn hàng mà User đặt: orderId, totalAmount, totalVoucher, totalPromotion, totalBill, paymentType, paymentStatus, List of productSKU [1-n], createdAt.

Model Zalo OA Profile thêm filter bằng thời gian Record được tạo ra bằng createdAt

Cập nhật thêm trên System Model Zalo OA Profile, tính năng More Filter để mở giao diện Filter Builder

Trên trường chọn Select field thêm field Created Time - định dạng Timestamp để thực hiện lọc. Field này có ý nghĩa lưu trữ thời gian Data Record được tạo ra trên hệ thống.

Áp dụng Whitelist IP của Bigquery trên Connection PangoCDP

Cập nhật mới trên Connection với Bigquery, thêm cấu hình Enable sử dụng Whitelist khi sync dữ liệu.

Trong cấu hình Connection ⇒ menu Connection Info ⇒ thẻ Extend Parameters

⇒ Trường nhập Enable Whitelist IP ⇒ chọn cấu hình Yes để áp dụng

Thêm Json View để kiểm tra dữ liệu phản hồi trước khi sync User cụ thể từ Zalo

Thêm tính năng cho phép sync dữ liệu 01 Follower cụ thể từ hệ thống Zalo và lưu trữ vào Model Zalo OA Profile. Ngoài ra, cho phép kiểm tra nhanh dữ liệu người dùng Zalo có tồn tại trên hệ thống Zalo hay khồng.

Hướng dẫn sử dụng:

• Truy cập vào Module Console, chọn menu Connection

• Chọn kết nối Connection đã thiết lập với Zalo OA và Zalo Developer App

• Chọn submenu OA Users để mở giao diện OA User Information

• Tại giao diện này, chọn icon More Config

• Chọn tuỳ chọn Sync by user id để thực hiện

• Trên giao diện Sync by user id mở ra thực hiện thao tác

  • User Id Type: chọn ID dùng để kiểm tra thông tin khách hàng

    • Zalo User App Id: ID tương ứng với Zalo Developer App

    • Zalo User Id: ID tương ứng với Zalo Official Account

  • User Id Value: nhập giá trị đại diện cho Id của User

  • Ấn Execute để kiểm tra xem dữ liệu User có tồn tại trên hệ thống Zalo hay không

  • Copy Response cho phép sao chép Result đi thực hiện đối chiếu

  • Ấn Sync để đồng bộ dữ liệu User và lưu vào Model Zalo OA Profile

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