Game Play Analysis Content Log
Log required for the content index in the game play analysis dashboard of the index by game. You can check the number of uses for each content, success/cancel/complete rate, detailed status, and more.
Send Logs¶
Utilize the Hive SDK client log delivery technique to send logs for content indicators.
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 recommendedTransmit 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 | Y |
| category | The value that distinguishes the categories of the content log which is fixed as “pub_contents_log” | STRING | Y |
| modeTypeName | Content mode type name (e.g. "raid") Used as the content name of the “number of content uses” or “content use details” index | STRING | Y |
| modeTypeId | Content mode type ID, a numeric ID corresponding to the content modeTypeName field 1:1 * Used to aggregate the "Tutorial Funnel" indicator in ascending order if it is 20000000 or less * Used to aggregate the "Main Quest Funnel" indicator in ascending order if it is over 20000000 | INTEGER | |
| contentStatus | Proceed with the flow below in the content mode type state. * accept (-> wait) -> fail/success/cancel You can set one of the five values below. * “accept”: Accept * “wait”: Wait * “fail”: Fail * “success”: Success * “cancel”: Cancel Used in the “Content Acceptance to Status Ratio” index or the “Content Usage Details” index. | STRING | Y |
| serverId | Server ID Used as a search conditionTransmit automatically when using the Hive SDK client log transmission function. | STRING | |
| userId | User's unique ID in game | STRING | |
| userLevel | In-game user level or equivalent value Used as a search condition or in the "User Level (Average)" item of the "Content Usage Details" index | INTEGER | |
| characterLv | Character level Used in the "Character Level (Average)" item of the "Content Usage Details" index | INTEGER | |
| playTimeSec | State-based playtime or wait time (sec) for each content mode type Used in the "Playtime (Min/Average)" item of the "Content Usage Details" index | INTEGER | |
| score | Score earned during play or equivalent value Used in the "Score (Average)" item of the "Content Usage Details" index | INTEGER |
Check sent logs¶
- After sending the game log, you can check the log in the log definition function
- If all the values in the fields required by the content log definition are properly entered, the transmission is reflected and displayed in the index.