[06/11/24] Weekly Release

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

1. Pango Form: tích hợp thêm luồng Scan QR on Bill

2. Pango Reward: bổ sung UTM Source khi đổi lượt chơi và mở ZMA Wheels

3. Pango Reward: thêm tính năng trên giao diện cho phép sao chép mã mời của User

4. Pango Form: thêm Element Invite Code cho phép nhập mã mời của F0 để trở thành F1

5. Pango Gift: thêm custom UI cho loại quà Activate GiftCode

6. Pango Connect: hiển thị đúng vị trí đã ghim trên GG Map bằng cách thêm link đến địa chỉ này

7. Pango Form: Element Voucher thêm loại chỉ hiển thị Tên và Banner của Voucher

8. DMA Workflow: thêm Element Enrich Zalo User cho phép cập nhật thêm User Info từ Zalo

9. Nâng cấp giao diện thông báo truy cập Mini App Form và thêm CTA cho Event Restriction và Expiration Access

New Feature

Pango Form: tích hợp thêm luồng Scan QR on Bill

Đối với Usecase Scan QR on Bill - quét mã QR trên hoá đơn mua hàng để nhận quà thông qua chức năng Proof of Purchase của Pango đã tích hợp với các Mini App Gift và Reward. Bổ sung thêm luồng này trên Mini App Form bao gồm:

+ Ngữ cảnh áp dụng -> xem tại đây

+ Hướng dẫn sử dụng Element Scan Bill và Bill Prize -> xem tại đây

Pango Reward: thêm tính năng trên giao diện cho phép sao chép mã mời của User

Trước đây, khi F0 cần cung cấp mã mời của mình cho các F1 tham gia chương trình sẽ cần phải truy cập vào CTA More Action cạnh CTA làm nhiệm vụ - điều này gây khó khăn cho một số User. Nâng cấp giao diện thêm tính năng sao chép mã mời của User vào màn hình Race Track Infor để dễ thao tác hơn.

Pango Form: thêm Element Invite Code cho phép nhập mã mời của F0 để trở thành F1

Trước đây, hệ thống chỉ ghi nhận người được mời (F1) hợp lệ khi F1 truy cập vào liên kết được người mời (F0) gửi ra để tham gia chương trình Reward. Thêm tính năng mới cho phép người dùng tham gia theo luồng truy cập vào link gốc của chương trình vẫn có thể trở thành F1 của bạn bè bằng cách nhập đúng mã Invite Code của F0.

Để thực hiện điều này, thêm Element Invite Code trên Mini App Form để nhập mã của F0 và trở thành F1 hợp lệ. Element này chỉ có thể hoạt động khi thuộc Form có CDP App Id thuộc Joining Method của chương trình Reward. Khi User ấn vào link được gửi mời từ bạn bè sẽ tự động điền thông tin Invite Code vào trường Invite Code trên Form -> khi thay đổi thành Invite Code của bạn bè khác -> người dùng trở thành F1 của F0 mới được nhập vào.

DMA Workflow: thêm Element Enrich Zalo User cho phép cập nhật thêm User Info từ Zalo

Dữ liệu khách hàng trên hệ thống Pango đôi khi thiếu những trường thông tin liên quan đến Zalo như Zalo User ID hay Zalo User App Id đến từ các ngữ cảnh khác nhau như:

1. Zalo User ID: User đã Follow OA từ rất lấu và tương tác với Mini

2. Zalo User App Id: Brand chuyển đổi ZMA Builder -> User chưa tương tác với Zalo Developer App mới nên không có ID

Thêm Element Enrich Zalo User để giải quyết vấn đề trên nhằm phục vụ các nhu cầu lấy thông tin của User trong các luồng vận hành giữa các Mini App hay tương tác qua tin Zalo UID, đối soát thông tin trên các Model.

Một số ngữ cảnh sử dụng:

• User submit mini app Form nhưng không thể lấy được Zalo User Id để gửi tin nhắn (nguyên nhân có thể: follow từ rất lâu trong quá khứ -> Zalo không trả về khi Sync Data) -> dùng Element để nhận được Zalo User Id (theo Zalo User App ID và Zalo User Id) -> gửi tin tương tác cho User.

• User trước đó tham gia chương trình trên Zalo Developer App của Pango được điểm. Chuyển đổi điểm số qua chương trình tương tự trên Zalo Developer App của Brand để bảo toàn số điểm. User này chưa tương tác với App của Brand nên chưa có Zalo User App Id mới để cộng điểm -> dùng Element để nhận được Zalo User App Id (theo Zalo User ID và Zalo Developer App Id) -> cộng điểm qua chương trình mới -> User truy cập vào app mới sẽ thấy có sẵn điểm.

Hướng dẫn sử dụng trên DMA Workflow

• Sử dụng thông tin User được cung cấp trên các Element khác

• Select a Connection: chọn kết nối liên kết Zalo Developer App

• Zalo Offcial Account (OA): chọn kết nối ZOA đã liên kết để nhận thông tin User

• Get Zalo User By: chọn trường thông tin muốn nhận từ Zalo

  • Zalo User Id (By OA): dùng Zalo User App Id để tìm theo Zalo OA

  • Zalo User App Id (By App): dùng Zalo User Id và Zalo Developer App Id để nhận thông tin từ Zalo

• Update Context Value: ghi nhận thông tin User vừa nhận được từ Zalo để ghi nhận vào thông tin cũ

• Step name: đặt tên cho bước này

Improve

Pango Reward: bổ sung UTM Source khi đổi lượt chơi và mở ZMA Wheels

Trên ZMA Reward khi đổi quà loại Vòng quay may mắn (lượt chơi Wheels) bổ sung thêm UTM Source nhằm ghi nhận nguồn khi mở ZMA Wheels, giúp người vận hành dễ dàng đánh dấu và theo dõi truy cập của User.

Các cấu trúc này sẽ mặc định theo hệ thống của Pango, nội dung bao gồm:

• pango_source_c=reward

• pango_medium_c=play_button

• pango_campaign_c={campaignName}

Pango Gift: thêm custom UI cho loại quà Activate GiftCode

Custom UI trên ZMA Gift bổ sung thêm loại Activate GiftCode để thay đổi một số thông tin trên giao diện giúp Brand dễ tương tác với Khách hàng hơn.

Hướng dẫn thiết lập nội dung custom UI:

• Truy cập vào Module Activations, menu Brands

• Chọn Brand cần thay đổi giao diện

• Chọn Custom UI của Gift

• Chọn đúng Gift Code Screen

• Thay đổi các nội dung hiện có hoặc thêm CTA tại màn hình này

  • Instructions for gift exchange: hướng dẫn sử dụng mã

  • Activation failed message: thông báo khi kích hoạt mã thất bại

Pango Connect: hiển thị đúng vị trí đã ghim trên Google Map bằng cách thêm link đến địa chỉ này

Trước đây, định vị Shop trên hệ thống ZMA Connect sử dụng Long & Lat của địa chỉ để định vị trên GG Map. Dẫn đến việc chỉ định vị được địa điểm chứ không chọn đúng địa chỉ Brand đã gắn trực tiếp trên GG Map.

Cập nhật thêm trường nhập liên kết đến địa chỉ Brand đã gắn trên GG Map để chọn chính xác và hiển thị đúng thông tin cửa hàng của Brand thay vì chỉ hiển thị vị trí như trước đây.

Để thực hiện, khi thiết lập Shop trên hệ thông Pango hay Import danh sách Shop có sẵn theo template của Pango cần nhập thêm trường thông tin Mark Location Link.

Để lấy được liên kết này, cần vào địa chỉ đã ghim trên GG Map và sao chép liên kết địa chỉ đó.

Pango Form: Element Voucher thêm loại chỉ hiển thị Tên và Banner của Voucher

Trước đây, Element Voucher trên Pango Form khi chọn tuỳ chọn View type theo Image and code sẽ hiển thị Banner và thông tin của Voucher (Voucher Code, các thông tin liên quan đến thời gian phát hành, hết hạn, hạn sử dụng). Một số Campaign khi triển khai trả ra loại quà "Chúc bạn may mắn lần sau" gặp trường hợp hiển thị thông tin Banner không trúng quà nhưng lại hiển thị thông tin Voucher làm người dùng hoang mang.

Thêm tính năng Hide voucher detail information trên giao diện Thank Form chỉ hiện thị thông tin Banner và Tên của Voucher theo Tag được xác định, các thông tin còn lại sẽ bị ẩn. Khi chọn loại hiển thị Voucher là Image and code sẽ xuất hiện tuỳ chọn cho phép bật tính năng Hide voucher detail information. Element Voucher Integrate với Batch Voucher để trả Voucher dạng các Generate Type -> khi trả ra quà đúng Tag sẽ ẩn Chi tiết Voucher, không đúng Tag sẽ hiển thị thông tin Voucher đầy đủ theo Element.

Hướng dẫn thiết lập khi thao tác trên Form Builder

1. Element Voucher trên Form

2. View type chọn Image and code

3. Enable Hide voucher detail information

4. Voucher's Tag: nhập Tag của Voucher muốn hiển thị theo điều kiện ẩn thông tin chi tiết

Nâng cấp giao diện thông báo truy cập Mini App Form và thêm CTA cho Event Restriction và Expiration Access

Cải thiện giao diện thông báo cho người dùng khi chặn truy cập của người dùng, không cho phép truy cập vào Mini App dựa trên các điều kiện Event Restriction và Expiration Access. Đồng thời thêm được CTA trên thông báo dãn đến liên kết bên thứ 3 được thiết lập. Hiện tại Popup thông báo hạn chế truy cập chỉ áp dụng cho loại Pango Form.

Event Restriction

Đối với Zalo Mini App sử dụng Event Restriction, khi User đã thực hiện một hoặc nhiều hành động và bị hạn chế truy cập bởi ZMA. Nếu tiếp tục thực hiện sẽ hiển thị thông báo chặn trên ZMA với CTA mở liên kết mới dẫn User đến trang đích và hành động để tắt Mini App đang mở.

Hướng dẫn thiết lập trên Custom UI Mini App

1. Truy cập Custom UI Mini App, thẻ Rules

2. Chọn menu Event Restriction

3. Thiết lập các Event truy cập và Event dùng để hạn chế User

4. Thiết lập nội dung thông báo chặn truy cập ZMA bao gồm:

   • Image: banner hiển thị thông báo

   • Warning Message: nội dung hiển thị thông báo

   • Close App Button Text: nội dung hiển thị trên CTA tắt ZMA

   • + Add Button: thêm CTA để mở liên kết mới

     • Text: nội dung hiển thị trên CTA mở liên kết

     • Link: địa chỉ trang đích hướng tới

Expiration Access

Tính năng giới hạn truy cập Mini App của người dùng bằng các mã QR có thời gian trong một giới hạn quy định hoặc phiên truy cập dành cho người dùng đầu tiên tham gia (cơ chế _puqrid được tạo ra bởi ZMA Scan của Pango). Khi ngươi dùng truy cập ZMA không hợp lệ sẽ hiển thị Popup thông báo.

Hướng dẫn thiết lập trên Custom UI của Mini App:

1. Truy cập Custom UI Mini App, thẻ Rules

2. Chọn menu Expiration Access

3. Thiết lập các cấu hình để sử dụng và chặn các Event theo quy định

4. Thiết lập nội dung thông báo khi User bị chặn truy cập

   • Image: banner hiển thị thông báo

   • Warning Message: nội dung hiển thị thông báo

   • Close App Button Text: nội dung hiển thị trên CTA tắt ZMA

   • + Add Button: thêm CTA để mở liên kết mới

     • Text: nội dung hiển thị trên CTA mở liên kết

     • Link: địa chỉ trang đích hướng tới

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