Client Data Reporting
Special Data Integration Instructions ()
- Request Protocol
- protocol：http/https/tcp
- Address Data (The following addresses may include custom ports and should use @ as a port separator):
- gameResourceUrl: Game resource service address (used for CDN version checks and download-related content)
- gameLoginServerUrl: Game login service address (used for user login verification)
- gameServerUrl: Game server address (used for gameplay servers for players to connect to)
The game must link this data to the extended data field as early as possible when these addresses become available.
Format:
key:protocol@url@port
- Key: gameResourceUrl/gameLoginServerUrl/gameServerUrl
- protocol: Required
- url: Required
- port: Optional
Example:
Integration via the extra parameter: aaa:bbbb,gameResourceUrl:tcp@game.com.xxx,111:2222,...
Integration via the extra parameter with a port:aaa:bbbb,gameResourceUrl:http@111.202.202.146@8000.xxx,xxx
Game Custom Reporting
| Reporting Key | Step (Phylum) | Result (ClassField) | Access Method | Description |
|---|---|---|---|---|
| version_check | 10 | Game | Version update () | |
| version_check_result | 11 | [ok/fail] | Game | Version update result () |
| hotupdate | 12 | Game | Hot update () | |
| hotupdate_result | 13 | Game | Hot update result () | |
| game_init | 14 | Game | Game initialization () | |
| game_init_result | 15 | Game | Game initialization result () | |
| enter_server | 62 (handled by SDK) | Game | Enter server () | |
| create_role | 63 (handled by SDK) | Game | Create character () | |
| level_up | 64 (handled by SDK) | Game | Level up () |
Official Reporting Events
| Report Key | Step (Phylum) | Result (ClassField) | Integration | Description |
|---|---|---|---|---|
| show_privacy_policy | 0 | Not required | Display privacy policy page (not reportable) | |
| allow_policy | 0 | Not required | Agree to policy (not reportable) | |
| open_app | 1 (handled by SDK) | SDK | App launched | |
| init_phonequick_failed | 1.1 | Failure reason | SDKQuick phone login initialization failed | |
| get_phonequick_failed | 1.2 | Failure reason | SDK | Failed to pre-fetch phone number |
| - | Game reporting reference Game custom reporting | - | - | |
| invoke_login | 30 (handled by SDK) | SDK | Game initiates login | |
| show_phonequick | 31 (handled by SDK) | SDK | Show one-click login UI | |
| show_phonecode | 32 (handled by SDK) | SDK | Show phone code login UI | |
| show_username | 33 (handled by SDK) | SDK | Show username/password login UI | |
| action_sendphonecode | 34 (handled by SDK) | SDK | Trigger send code action | |
| action_closeview | 35 (handled by SDK) | SDK | Trigger close UI action | |
| action_privacypolicy | 36 (handled by SDK) | select/none | SDK | Trigger privacy policy status action |
| phone_quick_auth | 41 (handled by SDK) | SDK | One-click phone login authorization | |
| phone_code_auth | 42 (handled by SDK) | SDK | Phone code login authorization | |
| username_auth | 43 (handled by SDK) | SDK | | |
| account_list_auth | 44 (handled by SDK) | SDK | Account list login authorization | |
| login | 55 (handled by SDK) | SDK | SDK login successful | |
| webview_check | 55.1 (handled by SDK) | SDK | WebView check | |
| login_failed | 56 (handled by SDK) | Failure reason | SDK | SDK login failed |
| show_realname | 57.1 (handled by SDK) | SDK | Show real-name verification UI | |
| start_realname | 57 (handled by SDK) | SDK | Start real-name verification | |
| realname_success | 58 (handled by SDK) | SDK | Real-name verification successful | |
| realname_failed | 59 (handled by SDK) | Failure reason | SDK | Real-name verification failed |
| login_game | 60 (handled by SDK) | SDK | Game login success callback | |
| logout | 61 (handled by SDK) | SDK | Logout | |
| enter_server | 62 (handled by SDK) | Game | Enter server | |
| create_role | 63 (handled by SDK) | Game | Create character | |
| level_up | 64 (handled by SDK) | Level up | ||
| start_pay | 98 (handled by SDK) | SDK | Start payment | |
| payment | 99 (handled by SDK) | SDK | Payment reporting | |
| xxxx | 100-x (Game input) | Game | Custom game events post-login | |
| invoke_manger | 200 (handled by SDK) | SDK | Call user management center | |
| invoke_service | 201 (handled by SDK) | SDK | Call customer service | |
| background | 997 (handled by SDK) | SDK | Game enters background | |
| active | 998 (handled by SDK) | SDK | Game enters foreground | |
| exit | 999 (handled by SDK) | SDK | Game exit | |
| hotfix_exception | Exception info | SDK | SDK hotfix exception | |
| other_exception | Exception info | SDK | Other client exceptions |
Channel Reporting Events
| Report Key | Step (Phylum) | Result (ClassField) | Integration Method | Description |
|---|---|---|---|---|
| show_privacy_policy | 0 | Not integrated | ||
| allow_policy | 0 | Not integrated | ||
| open_app | 1 (handled by SDK) | SDK | Open app (legacy system initialization result point) | |
| start_channel_init | 1.3 | Failure reason | SDK | Start channel initialization |
| channel_init_success | 1.0 | SDK | Channel initialization successful | |
| channel_init_failed | 1.5 | SDK | Channel initialization failed | |
| channel_init_timeout | 1.6 | SDK | Channel initialization timeout | |
| - | Channel specific reporting reference points Channel special points | |||
| - | Game custom reporting reference points Game custom reporting | |||
| invoke_login | 40 (handled by SDK) | SDK | Game calls login interface | |
| start_auth | 50 (handled by SDK) | SDK | Call channel login | |
| auth_success | 51 (handled by SDK) | SDK | Channel login successful | |
| auth_failed | 52 (handled by SDK) | Failure reason | SDK | Channel login failed |
| login | 55 (handled by SDK) | SDK | SDK login successful | |
| login_failed | 56 (handled by SDK) | Failure reason | SDK | SDK login failed |
| login_game | 60 (handled by SDK) | SDK | Game login (callback: login success) | |
| logout | 61 (handled by SDK) | SDK | Logout | |
| enter_server | 62 (handled by SDK) | Game | Enter server | |
| create_role | 63 (handled by SDK) | Game | Create character | |
| level_up | 64 (handled by SDK) | Game | Level up | |
| start_pay | 98 (handled by SDK) | SDK | Start payment | |
| payment | 99 (handled by SDK) | SDK | Payment reporting | |
| xxxx | 100-x (Game input) | Game | Custom event point after entering game | |
| background | 997 (handled by SDK) | SDK | Game enters background | |
| active | 998 (handled by SDK) | SDK | Game returns to foreground | |
| exit | 999 (handled by SDK) | SDK | Exit game |
Parameter Description
- login_success reporting point extra parameters
- login_type:
- phoneQuick: One-click login via phone number
- phoneCode: Login via phone number verification code
- usernamePwd: Login with username and password
- background/active/exit reporting points explanation
- classfield carries extra parameters
- quickPhoneView: Phone number quick login interface
- accountListView: Account list interface
- phoneCodeView: Phone number verification code interface
- usernameView: Username and password interface
- realNameView: Real-name authentication interface
- childAccountView: Child account interface
- gameView: Game interface