Block Club · Event Tracking

Tổng hợp mọi event đang gắn trong game theo file Block_Club_Event_Tracking.xlsx. Nguồn: tracking-plan.yaml và game/Source/platform/AnalyticsTrack.cpp. Đã bỏ toàn bộ event cũ.

Chuỗi khởi động

app_launch→app_init→load_start→load_save→load_end→app_ready

Cùng một launch_id. duration = giây từ mốc trước; app_launch_duration = giây từ lúc mở app. app_ready bắn 1 lần mỗi lần mở app, khi bàn chơi hiện lần đầu hoặc khi vào sảnh.

Tham số chung (tự thêm vào mọi event)

Tham số	Kiểu	Giá trị
`game_mode`	string	`none` · `classic` · `adventure`. Event tự truyền thì giữ giá trị của event.
`schema_version`	int	1
`event_id`	string	UUID sinh lúc track; event chờ consent vẫn giữ id.
`environment`	string	`demo` khi SDK key MAX còn là placeholder, `production` khi có key thật.
`app_build`	int	Android: versionCode. iOS: CFBundleVersion. Desktop/Web: 0.
`app_session_id`	string	UUID của phiên, đổi mỗi lần mở app hoặc quay lại từ nền.

Danh sách event

Quyết định khi gắn

Adventure: lựa chọn hồi sinh gửi level_continue thay cho revive_action; Classic giữ revive_action.
tutorial_step cũ tách thành tutorial_start và tutorial_end; mỗi bước chỉ gửi start 1 lần cho mỗi lượt tutorial.
Adventure chơi lại / kết thúc ở trạng thái finish không gửi level_end.
skl_ad_show bắn lúc gọi hiện quảng cáo (MAX bridge không báo lúc quảng cáo thật sự hiện).
skl_ad_close chỉ gửi khi đóng bình thường; lỗi sau khi đã gọi hiện gửi skl_ad_display_failed với stage=show.
Bỏ ad_policy_blocked; giữ ab_exposure. ad_revenue_sdk và ab_exposure do lớp beacon tự gửi.
Thời gian ván chỉ đếm lúc đang chơi: dừng khi xem quảng cáo (tính sang ad_duration) và khi app vào nền; lưu lại để resume tiếp đúng ván.

Rủi ro còn lại

tutorial_variant có thể ra -1 nếu tutorial chạy theo đường resume mà chưa gán variant trong lần mở app đó.
Thời lượng tutorial tính theo thời gian ván; ván bị reset giữa chừng thì số sai (chặn tối thiểu 0).
Chưa kiểm trên máy: quảng cáo, hồi sinh, booster, quà hằng ngày, round_end, Adventure.

Soát trên máy: build với -PtrackLog rồi adb logcat | grep "\[TRACK\]".