app_session_maintain
An event that occurs every 2 minutes while the client is running after login. You can use it to create metrics such as the number of concurrent users, the number of sessions, and play time.
| Attribute name | Data type | Description |
|---|---|---|
| dateTime | TIMESTAMP | Indicates the date and time when the event occurred. Recorded based on the event time, and can be used as the basis for aggregation by period unit (day/week/month/hour/minute) and date range queries. (Example: 2023-05-09 19:30:35) |
| eventName | STRING | Indicates the name that identifies the event. Because all events are loaded together into a single source log, this value identifies which event it is, and it can be used as the basis for querying data by event. (Example: app_login) |
| userId | STRING | Indicates the account-based identifier of the user who triggered the event. Recorded based on the user's unique ID in the app, and can be used to count unique users, such as AU, with a distinct count aggregation. |
| identifierProvider | STRING | Indicates the system that issued the user identifier. The value is always "hive". |
| deviceId | STRING | Indicates the device-based identifier of the user who triggered the event. Recorded based on the instance value issued for each device every time the app is installed, and can be used to count unique devices (such as the number of terms agreements) with a distinct count aggregation. (Example: 33333333) |
| appIdGroup | STRING | Indicates the project where the event occurred. Recorded based on the GAMEID value registered in Hive Console > Project Settings > App ID, and can be used to compare metrics by project when you query multiple projects together. (Example: com.sample.analytics) |
| appId | STRING | Indicates the unique ID of the app where the event occurred. Recorded based on the APPID registered in Hive Console > Project Settings > App ID, and can be used to distinguish metrics by app. (Example: com.sample.analytics.google.global.android.common) |
| country | STRING | Indicates the user's country identified when the event occurred. Recorded in ISO 3166-1 alpha-2 uppercase format, and can be used to compare the number of users, revenue, retention, and so on by country. (Example: KR, US) |
| serverId | STRING | Indicates the app server the user was connected to when the event occurred. Recorded based on the server identifier sent by the app, and can be used to compare the number of users, revenue, and retention by server. (Example: KR, GLOBAL) |
| market | STRING | Indicates the market where the user installed the app when the event occurred. Recorded based on the market where the app is installed or serviced, and can be used to compare metrics by market. (Example: GO (Google Play), AP (Apple App Store), HS (direct distribution)) |
| os | STRING | Indicates the operating system of the user's device when the event occurred. Recorded based on the platform value sent by the client, and can be used to compare metrics by OS. (Example: A (Android), I (iOS)) |
| clientIp | STRING | Indicates the IP of the user's device where the event occurred. Recorded with the last segment of the IP masked, and can be used to query data such as the number of devices by IP range. (Example: 127.0.0.x) |
| sdkVer | STRING | Indicates the Hive Axyl SDK version when the event occurred. Recorded based on the Hive Axyl SDK version applied to the client, and can be used to compare data collection status by SDK version. (Example: 1.0.0) |
| sessionId | INT(INTEGER) | Indicates the client session identification key of the event. Recorded based on the key value that identifies a single client session, and can be used to count sessions with a distinct count aggregation. (Example: 123) |
| playtime | INT(INTEGER) | Indicates the time spent (in seconds) while the session is maintained. Recorded based on the time the app remained in the foreground between session maintenance event transmissions, and can be used to calculate play time with a sum aggregation. (Example: 0, 120, 240) |
| playOutTime | INT(INTEGER) | Indicates the inactive time while the session is maintained. Recorded based on the inactive period time sent in the session maintenance log, and can be used to calculate inactive time metrics with sum and average aggregations. |
| prevLatency | INT(INTEGER) | Indicates the delay of the session maintenance event compared to the previous transmission. Recorded based on the delay from the previous transmission sent in the session maintenance event, and can be used to analyze latency with average and maximum aggregations. |
| activeTime | INT(INTEGER) | Indicates the actual play time (in seconds) while the session is maintained. Recorded based on the actual play time in the foreground since the previous transmission (up to 120 seconds), and can be used to calculate actual play time with sum and average aggregations. (Example: 120) |