promotion_install¶
This is an event that occurs when an app is installed through a promotion, and can be used to create metrics such as the number of promotional installations, new installations, and installations by medium.
| Attribute name | Data type | Description |
|---|---|---|
| dateTime | TIMESTAMP | Indicates the date and time when the event occurred. It is recorded based on the time of event occurrence, and can be used as a basis for period unit (day/week/month/hour/minute) aggregation and date range searches. (Example: 2023-05-09 19:30:35) |
| eventName | STRING | Indicates a name that identifies the event. Since all events are loaded together in one source log, this value identifies which event it is and can be used as a standard for searching data on an event-by-event basis. (Example: app_login) |
| userId | STRING | Indicates the user identifier based on the account that triggered the event. It is recorded based on the unique user ID in the game, and can be used to count the number of unique users such as AU by deduplicating the number. |
| identifierProvider | STRING | Indicates the user identifier issuance system, and "hive" is fixed. |
| deviceId | STRING | Indicates the user identifier based on the terminal that generated the event. Each time an app is installed, it is recorded based on the instance value issued for each device, and can be used to count the number of unique devices (the number of terms and conditions agreed, etc.) by deduplicating the number. (Example: 33333333) |
| appIdGroup | STRING | Indicates the project where the event occurred. Hive is recorded based on the GAMEID value registered in the console app center, and can be used to compare indicators by dividing them by project when viewing multiple projects together. (Example: com.sample.analytics) |
| appId | STRING | Indicates the unique ID of the app where the event occurred. Hive is recorded based on APPID registered in the console app center, and can be used to distinguish indicators for each app. (Example: com.sample.analytics.google.global.android.common) |
| country | STRING | Indicates the country of the user identified at the time the event occurred. ISO 3166-1 alpha-2 It is recorded in uppercase format and can be used to compare the number of users, sales, retention, etc. by country. (Example: KR, US) |
| market | STRING | Indicates the market where the user installed the game when the event occurred. It is recorded based on the market value where the app is installed or serviced, and can be used to compare indicators by market. (Example: GO(Google Play), AP(Apple App Store), HS(direct distribution)) |
| os | STRING | Indicates the operating system of the user terminal at the time the event occurred. It is recorded based on the platform value sent by the client, and can be used to compare indicators by OS. (Example: A(Android), I(iOS)) |
| clientIp | STRING | Indicates IP of the user terminal where the event occurred. It is recorded based on the masked value of the last section of IP, and can be used to query data such as the number of terminals for a specific IP band. (Example: 127.0.0.x) |
| sdkVer | STRING | Indicates the Hive SDK version at the time the event occurred. It is recorded based on the Hive SDK version value applied to the client, and can be used to compare the data collection status by SDK version. (Example: 4.16.2.2) |
| newUser | STRING | Indicates whether the user is a new user. userId is recorded based on issuance, and can be used to calculate the number of new users (NU). (Example: Y(new), N(existing), U(unknown)) |
| mediaId | STRING | Indicates media identification information for promotional installations. It is recorded based on the numeric value (App Index) of the media game that exposed the advertisement, and can be used to compare installation indicators by media. |
| mediaIdCompany | STRING | Indicates the medium company of the promotional installation. It is recorded based on the media company classification value, and can be used to compare installation indicators by media company. (Example: com2us_platform) |
| promotionType | STRING | Indicates the promotional type of the promotional install. It is recorded based on promotion type values such as cross front banner, offer wall, and UA, and can be used to compare installation performance by promotion type. (Example: cross-great, offerwall-normal, ua-cpi) |
| deviceModel | STRING | Indicates the model name of the user's terminal when installing the promotion. It is recorded based on the terminal model value sent by the client, and can be used to compare installation indicators by device model. (Example: iPhone) |
| adId | STRING | Indicates the number of the advertiser app in the promotional install. It is recorded based on numeric values (App Index) that are mapped 1:1 with App Center appId, and can be used to compare installation indicators by advertiser. (Example: 2624) |
| adCompany | STRING | Indicates the advertiser company of the promotional installation. It is recorded based on the advertiser company classification value, and can be used to compare indicators by advertiser company. (Example: com2us platform) |
| adAppId | STRING | Indicates the unique ID of the advertiser app in the promotional install. Hive is recorded based on the APPID value of the advertiser's game registered in the console app center, and can be used to compare installation indicators for each advertiser's app. (Example: com.sample.analytics.google.global.android.common) |
| adAppIdGroup | STRING | Indicates the advertiser project of the promotional install. Hive is recorded based on the GAMEID value registered in the console app center, and can be used to compare performance indicators for each advertiser project. (Example: com.sample.analytics) |
| mediadAppId | STRING | Indicates the unique ID of the medium app of the promotional install. Hive is recorded based on the APPID value of media games registered in the console app center, and can be used to compare installation indicators for each media app. (Example: com.sample.analytics.google.global.android.common) |
| mediadAppIdGroup | STRING | Indicates the media project of the promotional installation. Hive is recorded based on the GAMEID value registered in the console app center, and can be used to compare indicators by media game group. (Example: com.sample.analytics) |
| promotionNo | INT(INTEGER) | Indicates the unique number of the promotional campaign with which the event is associated. It is recorded based on the promotion and coupon campaign unique number value, and can be used to compare indicators for each campaign. (Example: 202694) |