Analytics · Wire B

Bản đồ event analytics

Mỗi dòng = một event game ghi lại. Cột giữa nói event đo gì. Cột phải nói tình huống người chơi khiến event bắn.

18 event wire tay 2 beacon tự bắn Session · Ads · Endless · Travel · Revive · Booster · Tutorial · DFW

Session — mở / đóng app

AppDelegate.cpp

Event	Sự kiện này là gì	Khi nào bắn
app_open	Người chơi mở app lên	Mỗi lần app hiện lên màn hình: mở lạnh lần đầu, hoặc kéo app từ nền về lại. Gắn thêm `open_type` để biết mở lạnh hay resume.
app_session_start	Bắt đầu một phiên dùng app	Bắn cùng lúc với `app_open` khi app vừa lên foreground — đánh dấu phiên mới bắt đầu.
app_session_end	Kết thúc phiên dùng app	Người chơi đưa app về nền hoặc tắt app. Không bắn khi chạy chế độ QA tự động.

AdService.cpp

Event	Sự kiện này là gì	Khi nào bắn
ad_request	Game xin một quảng cáo	Ngay trước khi tải hoặc hiện quảng cáo. Mỗi lần xin tạo một mã id để nối các bước request → show → close/fail.
ad_show	Quảng cáo bắt đầu hiện	Màn quảng cáo vừa xuất hiện trước mặt người chơi.
ad_reward	Xem rewarded thành công	Người chơi xem hết (hoặc đủ điều kiện) quảng cáo có thưởng và SDK báo nhận thưởng OK.
ad_close	Quảng cáo đóng lại	Người chơi tắt quảng cáo hoặc quảng cáo tự đóng. Có trường `reward_received` = 1 nếu đã nhận thưởng, = 0 nếu chưa.
ad_fail	Xin / hiện quảng cáo thất bại	Không tải được quảng cáo, hoặc tải được nhưng không hiện được.

BoardPlay.cpp

Event	Sự kiện này là gì	Khi nào bắn
round_start	Bắt đầu một ván Cơ bản	Vào ván mới, chơi lại, hoặc remake bàn. Chỉ tiếp tục ván đang dở (resume) thì không bắn event này.
round_end	Kết thúc một ván Cơ bản	Ván thua / hết nước đi lần đầu, hoặc người chơi tự thoát khỏi ván. Chỉ cho Endless. Travel dùng `level_win` / `level_lose`. Lý do kết thúc: `no_moves` hoặc `user_quit`.

BoardPlay.cpp

Event	Sự kiện này là gì	Khi nào bắn
level_start	Bắt đầu một màn Travel	Người chơi vào một màn Travel (kèm số lần thử màn đó). Vào màn mới thì bắn. Chỉ resume màn đang dở thì theo cờ resume (có thể không bắn lại).
level_win	Thắng màn Travel	Ván Travel kết thúc và người chơi đạt mục tiêu (pass).
level_lose	Thua màn Travel	Ván Travel kết thúc mà người chơi không đạt mục tiêu.

ReviveScreens · BoardPlay

Event	Sự kiện này là gì	Khi nào bắn
revive_offer	Hiện lời mời hồi sinh	Game sắp thua và mở popup hỏi có muốn hồi sinh không. Loại `standard` = popup xem trước khối hồi sinh. Loại `countdown` = popup đếm ngược.
revive_action	Người chơi phản hồi lời mời hồi sinh	Chọn xem quảng cáo để hồi sinh (`watch_ad`), bấm từ chối (`decline`), hoặc hết giờ đếm ngược (`timeout`).
revive_success	Hồi sinh thành công	Người chơi đồng ý hồi sinh và đã xem rewarded OK — ván tiếp tục.
use_booster	Dùng một booster	Người chơi tiêu thành công 1 booster trong ván: universal, cannon, clear, hoặc hammer.
tutorial_step	Tiến một bước hướng dẫn	Trong tutorial cố định classic, người chơi hoàn thành bước hiện tại và sang bước tiếp theo.
daily_reward_claim	Nhận thưởng Daily First Win	Người chơi nhận phần thưởng thắng đầu ngày — nhận thường, hoặc nhân đôi bằng xem quảng cáo (thẻ revive).

không wire tay

Event	Sự kiện này là gì	Khi nào bắn
ad_impression	Quảng cáo được tính impression	SDK/beacon tự ghi khi impression được tính — không cần gọi từ code game.
ab_exposure	Người chơi vào nhóm A/B test	Beacon tự ghi khi người chơi bị gán vào một biến thể thử nghiệm — không cần wire tay.

Hai event này nằm ngoài phạm vi Wire B call-site.