Gameplay analytics level-up log
This is the log required for the level-up indicator in each game indicator's game play analysis dashboard. When a level-up event occurs for a user account or character in the game, logs are sent to verify the number of level-up changes by type of search period, the number of users, and the number of users based on the final level.
Transmit log¶
Send logs for level-up indicators using the SDK client log delivery method.
A sample log to send logs can be checked from the Log Definition – Create Client Source.
Log specifications¶
The field is configured in the form of the CamelCase (e.g. serverId) and is case-sensitive. Values are not saved in the following cases:
- If the field name is not defined below (e.g. uid).
- If the field name does not exactly match the field name (e.g. serverid).
- If the type is not defined in each field (e.g. “474392047” for vid).
Precautions
- STRING: String data up to 1MB
- INTEGER: Signed 64-bit (-9,223,372,036,854,775,808 to 9,223,372,036,854,775,807) data
- If data that does not matches the type of each field is transmitted, the field may not be stored properly, so it must be sent with a value that matches the type.
| Field Name | Description | Type | Required |
|---|---|---|---|
| playerId | Unique key that identifies users in Hive authentication Transmit automatically when using the Hive SDK client log transmission function. | INTEGER | Y |
| appId | App ID issued by App Center Transmit automatically when using the Hive SDK client log transmission function. | STRING | Y |
| guid | Unique key value for a row of logs Random string forms such as uuid are recommended Transmit automatically when using the Hive SDK client log transmission function. | STRING | Y |
| dateTime | Log timestamp in a format of “YYYY-MM-DD hh:mm:ss” (e.g. “2022-11-15 10:20:10”) Transmit automatically when using the Hive SDK client log transmission function. | STRING | Y |
| timezone | dateTime’s time zone Can be obtained through the time zone check method using client IPDecided based on KST if blank or no value(e.g. “GMT+09:00”) Transmit automatically when using the Hive SDK client log transmission function. | STRING | |
| category | Category classification value for level-up logs, the value is fixed as “pub_levelup_log” | STRING | Y |
| levelUpType | Level-up type (e.g., “account”) The value that can be set is one of the following 4 * “account” * “character” * “guild” * “skill” Used when calculating all indicator level-up type classifications On the segment creation page, elements can be chosen when sending level values to the account | STRING | Y |
| serverId | Server ID Used as a search condition Transmit automatically when using the Hive SDK client log transmission function. | STRING | |
| userId | User’s unique ID in game If the playerId field contains the value 0 or null, it is used as the user identification key to compute the item. | STRING | |
| levelPrev | Level before the level-up | INTEGER | |
| level | Level after the level-up Used when calculating “Number of users who have leveled up last” | INTEGER | Y |
Check sent logs¶
- After sending the game log, you can check the log in the log definition function
- If all required values are correctly entered into the level-up log definition fields, the indicator reflects and displays the transmission.