Thiết lập Component

Tài liệu này sẽ hướng dẫn chi tiết người dùng thiết lập một component trong ZMA Experience.

Giới thiệu

Trong ZMA Experience, một component là đơn vị phần mềm đóng gói sẵn bao gồm giao diện, logic xử lý và các hook sự kiện, cho phép các nhà phát triển nhúng trực tiếp vào ứng dụng thông qua component key mà không phải xây dựng từ đầu.

Mỗi component không chỉ cung cấp sẵn layout, style và tương tác người dùng cơ bản, mà còn xử lý tự động các nghiệp vụ như gọi API, nhận đầu vào và phát ra các sự kiện để dễ dàng can thiệp hoặc mở rộng. Các component đều được thiết kế theo nguyên tắc tái sử dụng cao, giúp giảm thời gian phát triển và đảm bảo tính nhất quán về trải nghiệm trên nhiều dự án.

Các bước thực hiện

Bước 1: Khởi tạo component

Tạo custom component

Người vận hành thực hiện các bước sau để tạo một component theo một tempate có sẵn trong ZMA Experience:

• Truy cập Module ACT Console

• Chọn tab ZMA Experience

• Chọn

Giao diện ZMA Experience

• Để chọn template, người vận hành có thể điền các thông tin trong bảng sau để tìm kiếm template.

Trường thông tin	Mô tả
Enter name	Nhập tên template để tìm kiếm
Select format	Chọn loại template cần tìm kiếm. Hiện tại, Pango đang hỗ trợ 1 loại template là: Game

• Người vận hành có thể xem trước template bằng cách nhấn vào nút

• Sau khi xem trước và lựa chọn template phù hợp với chiến dịch, người vận hành nhấn Select để bắt đầu sử dụng. (Người vận hành có thể chọn template ngay tại màn hình review bằng nút Select Template)

Điền thông tin component

• Sau khi đã tạo thành công, người vận hành điền các thông tin cần thiết cho component.

• Nhấn Save Changes để hoàn thành.

Trường thông tin	Mô tả
Name	Nhập tên component
Description	Nhập mô tả cho component
Selected Component Template	Thay đổi component khác
Effective Time	Thiết lập thời gian chạy cho component. Component chỉ khả dụng trong khoản thời gian được cài đặt
Status	Trạng thái của component. - : Component khả dụng khi được Publish. - : Component không khả dụng nếu Unpublish.

Người vận hành có thể thay đổi component khác.

Lưu ý việc thay đổi component khi người vận hành đã cấu hình UI ở bước 2 có thể dẫn đến việc mất hết các cấu hình đó.

Bước 2: Custom Component

Khi template đã được khởi tạo, người vận hành sẽ tiến hành tùy chỉnh giao diện của component dựa trên yêu cầu của từng brand bằng cách nhấn vào

Mỗi component có mỗi bộ cấu hình UI khác nhau.

Sau đây là cách cầu hình theo từng component:

Loại Component	Component	Hướng dẫn custom
User Engagement Components	Lucky Wheel with double rewards	Xem hướng dẫn tại đây
Reward & Offer Components	Chưa hỗ trợ
Dynamic Content Components	Chưa hỗ trợ

Bước 3: Tích hợp component

Hiện tại, Pango đang hỗ trợ hai hình thức tích hợp component:

• Tích hợp với Pango ZMA

• Tích hợp với Partner ZMA

Tích hợp với Pango ZMA

Sau khi đã hoàn tất tạo và cấu hình cho component, người vận hành tích hợp component vào ZMA bằng cách:

• Truy cập Module Console.
• Truy cập đến ZMA cần tích hợp component.

• Chọn Setting
• Chọn tab Services.

• Truy cập đến PZE Service.

• Bật toggle "Enabled" để tiến hành điền key component.

• Điền Key component và nhấn để hoàn tất tích hợp.

Truy cập Mini App

Điền Key component

Tích hợp với Partner ZMA

Xem tài liệu hướng dẫn tích hợp tại đây