Gameplay analytics mate log
This is the log required for the mate indicator in the game play analysis dashboard of each game indicator. A mate is a subservient companion of a game user character, such as a pet, avatar, or monster. When mate acquisition and consumption changes occur, logs are sent so that you can examine the ratio and number of differences in acquisition versus consumption by grade, the number of acquisition/consumption by route by grade, and the number of users acquired/consumed/total change by grade.
Transmit logs¶
Send logs for mate 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 mate logs, the value is fixed as “pub_mate_log” | STRING | Y |
| mateId | Mate ID, a value that identifies each mate | STRING | |
| mateGrade | Mate grade (e.g., Rare) Use for classifying all indicator mate grades | 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 | |
| mateChangeFlag | Mate variation flags (e.g., draw) * Purchase, drawing, promotion, synthesis, sale, deletion, etc. Used for item path, acquisition path by grade, consumption path by grade | STRING | Y |
| mateChangeAmount | Mate change amount * Consumption: Send as a negative number (e.g., -1) * Acquisition: Send as a positive number (e.g., 1) Used for item path, acquisition path by grade, and consumption path by grade | INTEGER | Y |
Check sent logs¶
- After sending the game log, you can check the log in the log definition function
- The transmission is reflected and displayed in the indicator if all required values are entered in accordance with the mate log definition.