Gameplay analytics currency log
The currency change indicator in the game play indicator dashboard of each game indicator requires this log for analysis. If a change occurs due to the acquisition or consumption of goods in the game, a log is sent to check the change in each good and the average change in goods for each user, and the TOP 10 behaviors can be checked in order of daily change in the amount of change in goods and the highest amount of change in each good.
Submit logs¶
Deliver logs for financial metrics 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 goods logs, the value is fixed as “pub_asset_log” | STRING | Y |
| assetName | Currency name (e.g., Diamond) Used as a search condition, used as a standard product name for all indicator tables/ graphs | STRING | Y |
| actionName | Reason for changes in currency (e.g., in-app purchase) Used for “consumption of currency by action” and “acquisition of currency by action” indicator action items | 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 | |
| amountPrev | Currency amount before the change | INTEGER | |
| amountVar | Amount of change in currency * Consumption: Send as a negative number (e.g., -100) * Acquisition: Send as a positive number (e.g., 100) Used when calculating the change in all currency change indicators | INTEGER | Y |
| amountCurr | Currency amount after the change Used when calculating in-game currency indicator owned | INTEGER | Y |
| contentsModeTypeName | If there is a currency change due to content usage, the content mode type name (e.g., "raid") is used when calculating currency changes per content | STRING | |
| isPaid | Value indicating whether the currency is paid * "Y": Paid currency * "N": Free currency | STRING | Y |
Check sent logs¶
- After sending the game log, you can check the log in the log definition function
- The transmission is reflected in the indicator and made visible if all required fields in the goods log definition are correctly filled out.