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

  • If all required values are correctly entered into the level-up log definition fields, the indicator reflects and displays the transmission.