Flappy Tây Du
Flappy Tây Du là mini game dự kiến mở trực tiếp trong Tây Du VNG qua WebView ingame, giúp người chơi có thêm hoạt động giải trí và nhận quà theo mốc. Buổi họp nhằm giới thiệu bản thử nghiệm và thống nhất với team Tech cách mở mini game từ IAM, nhận diện tài khoản, trao thưởng và ghi nhận kết quả.
Vì sao làm mini game này?
Tạo thêm một hoạt động ngắn ngay trong Tây Du VNG, để người chơi không cần rời ứng dụng vẫn có thể tham gia và nhận quà. Giai đoạn đầu thử nghiệm trong WebView ingame để đánh giá mức độ quan tâm, thời gian chơi và tỷ lệ quay lại.
Tăng thời gian người chơi tương tác
Tạo thêm lý do để người chơi tương tác và ở lại trong ứng dụng Tây Du VNG lâu hơn.
Tạo động lực chơi và quay lại
Hoàn thành từng mốc sẽ có mã quà, khuyến khích người chơi thử sức ở các ải tiếp theo.
Đo hiệu quả trước khi mở rộng
Theo dõi số người tham gia, thời gian chơi, mức độ hoàn thành và tỷ lệ quay lại để đánh giá hiệu quả.
Kết nối với hệ thống hiện có
Tận dụng hệ thống IAM và tài khoản game để mở mini game trong ứng dụng, nhận diện đúng nhân vật và hạn chế nhận quà trùng.
Mini game vượt chướng ngại theo chủ đề Tây Du
Người chơi mở mini game ngay trong Tây Du VNG, điều khiển nhân vật vượt chướng ngại để tích điểm. Càng tiến xa, thử thách càng khó; đạt mốc quy định sẽ nhận mã quà.
5 hiệu ứng hỗ trợ
Đóng băng · Nhân đôi điểm · Xuyên chướng ngại · Mở rộng khoảng trống · Bay chậm. Các hiệu ứng xuất hiện theo từng ải.
Ngoại hình nhân vật
Có thể mở khóa các nhân vật như Tôn Ngộ Không, Trư Bát Giới… khi đạt mốc điểm.
Quà in-game
Khi đạt mốc, phần thưởng (vật phẩm in-game) được trao thẳng vào tài khoản qua API, không hiển thị hay nhập code. Mỗi mốc chỉ nhận một lần.
Trải nghiệm mini game trực tiếp
Bản demo chạy thử ngay trong trình duyệt. Đây là môi trường kiểm thử, chưa phải kênh chính thức; nút trong game không mở store.
Bản thử nghiệm đã có những thành phần gì?
Giao diện mini game
Mini game được thiết kế để chạy trong WebView của Tây Du VNG trên Android/iOS, ở chế độ màn hình ngang. Bản thử nghiệm đã điều chỉnh cách hiển thị để chuyển động mượt hơn trong môi trường ingame.
Backend
Bản thử nghiệm có hệ thống xử lý riêng để lưu lượt chơi, kiểm tra điều kiện nhận quà và quản lý mã thưởng. Khi tích hợp chính thức, cần thống nhất cách kết nối với hệ thống của VNG.
Kiểm soát trao thưởng
Trao thưởng qua API SetCode theo tài khoản (roleID), có idempotency để mỗi mốc chỉ nhận một lần và đối soát được.
Hạn chế nhận thưởng không hợp lệ
Trước khi phát mã, hệ thống kiểm tra điểm, thời gian chơi và các yêu cầu bất thường. Nếu áp dụng phần thưởng giá trị cao, cần bổ sung kiểm tra chặt hơn.
Ghi nhận dữ liệu chơi
Mini game ghi nhận lượt chơi, thời gian và kết quả từng ải; hệ thống tổng hợp để theo dõi trên trang quản trị.
Môi trường chạy thử
Hiện có môi trường riêng để team kiểm thử và xem demo. Khi đưa đến người chơi, mini game dự kiến chỉ được mở từ WebView trong Tây Du VNG; cần thống nhất môi trường triển khai chính thức với Tech.
Người chơi sẽ tham gia và nhận thưởng như thế nào?
Các hệ thống kết nối với nhau
Luồng kỹ thuật dạng sequence — ai gọi ai, theo thứ tự thời gian.
%%{init: {'theme':'base','themeVariables':{'actorBkg':'#E6F1FB','actorBorder':'#2A78D6','actorTextColor':'#0C447C','signalColor':'#64707f','signalTextColor':'#1c1813','sequenceNumberColor':'#ffffff'}}}%%
sequenceDiagram
participant AP as Apollo
participant SDK as SDK (game chính)
participant FE as Minigame WebView
participant BE as Backend minigame
participant GA as GameAPIs (SetCode)
AP->>SDK: Gửi IAM campaign
SDK->>FE: Mở WebView + inject roleID/userID/serverID
FE->>BE: Gửi thông tin user (đã xác thực)
BE->>BE: Verify, mở phiên (không cần login lại)
FE->>BE: Chơi, ghi nhận lượt/thời gian
BE->>BE: Kiểm tra đạt mốc hợp lệ
BE->>GA: Gọi SetCode trao vật phẩm
GA-->>BE: Kết quả trao thưởng
BE-->>FE: Báo đã nhận quàCần theo dõi những chỉ số nào?
Bản demo có trang quản trị để xem kết quả. Thời gian chơi không tính lúc ứng dụng bị ẩn hoặc tạm dừng; có thể xuất dữ liệu để đối chiếu.
Số người tham gia và thời gian chơi
Số thiết bị tham gia, tổng lượt chơi, thời gian chơi trung bình và điểm số đạt được.
Người chơi dừng ở đâu?
Tỷ lệ vượt từng ải và những vị trí người chơi thường thất bại hoặc thoát game.
Hành vi sau khi nhận quà
Người chơi có tiếp tục thử sức sau khi nhận mã quà và có quay lại mini game trong Tây Du VNG vào những ngày sau không.
Tỷ lệ quay lại
Theo dõi tỷ lệ quay lại sau 1, 3 và 7 ngày kể từ lần tham gia đầu tiên.
Lịch sử trao thưởng
Lưu mã đã phát, thời điểm nhận và thông tin phục vụ kiểm tra, đối chiếu với hệ thống quà tặng.
Xuất dữ liệu báo cáo
Có thể tải dữ liệu để tổng hợp, phân tích thêm hoặc đối soát với các hệ thống liên quan.
Những vấn đề đã gặp và hướng xử lý
Định danh người chơi
Trước đây luồng mở WebView chưa truyền đủ thông tin tài khoản đã xác thực, phải tạm ghi nhận theo thiết bị.
Trao thưởng qua API (SetCode)
Phần thưởng phải vào đúng tài khoản, và theo quy định store không được hiển thị hay nhập code trong game.
Chống nhận thưởng không hợp lệ
Điểm số do thiết bị gửi lên có thể bị làm giả nếu hệ thống không kiểm tra.
Bảo mật tích hợp & dữ liệu
Mini game chạy trong WebView và kết nối hệ thống VNG, nên cần bảo đảm phiên đăng nhập, khóa bí mật và dữ liệu người chơi không bị lộ hoặc lạm dụng.
Một số giải pháp cần bàn với GPP
Xác định đúng tài khoản người chơi
Đã chốt Phương án 2: SDK truyền roleID + userID + serverID (đã xác thực) cho minigame, không cần đăng nhập lại. Cần SDK triển khai cơ chế inject (bản SDK mới) và backend verify.
Trao thưởng đúng người
Dùng API SetCode trao vật phẩm vào đúng tài khoản theo roleID (không hiển thị/nhập code). Cần spec tham số (roleID/userID/serverID), cách xác thực và idempotency; đối chiếu được lịch sử.
Ghi nhận dữ liệu chơi
Thống nhất những chỉ số cần ghi nhận và cách chuyển dữ liệu giữa mini game với GPP.
Môi trường chạy thử & security
Thống nhất nơi đặt hệ thống mini game, cách WebView ingame truy cập an toàn và các bước kiểm tra bảo mật trước khi phát hành.
Cơ chế nhận lượt chơi (giai đoạn sau)
Có thể tích hợp các API từ GDS để nhận lượt theo điều kiện (ví dụ đạt năng động, hoàn thành nhiệm vụ → nhận lượt) và API log nạp. Việc xác nhận điều kiện phải đến từ hệ thống game chính, mini game không tự quyết.
Từ bản thử nghiệm đến nền tảng minigame
Hiện đã có gì và bước tiếp theo là gì?
Đã hoàn thành bản thử nghiệm
Đã có bản demo phục vụ kiểm thử, chức năng trao thưởng, ghi nhận hoạt động và trang quản trị. Chưa triển khai qua IAM đến người chơi thật trong Tây Du VNG nên chưa có số liệu đánh giá hiệu quả.
Bước tiếp theo
- Legal: kiểm tra mở minigame có cần giấy phép bổ sung không.
- SRM: họp chốt request bộ API riêng và scan bảo mật source.
- SDK: triển khai Phương án 2 (bản SDK mới) truyền roleID + userID + serverID.
- Tracking: gắn và test cùng Apollo / GDS.
- Pilot: thử nghiệm nhóm nhỏ, đo hiệu quả trước khi mở rộng.