| Name | Description | Required | Sample Value |
|---|---|---|---|
value | The amount of ad revenue. | Required | 1.99 |
currency | The currency code for the ad revenue (ISO 4217). | Required | “USD” |
adType | The type of ad. You must use one of the pre-defined strings from the list below. • "interstitial_ad"• "rewarded_ad"• “other” | Required | “interstitial_ad” |
adPlacementID | A unique identifier for the ad placement. | Required | “placement_3” |
adPlacementType | The type of ad placement. You must use one of the pre-defined strings from the list below. • "static"• "dynamic" | Required | “static” |
adPlacementPosition | The position of the ad placement within the game. You must use one of the pre-defined strings from the list below • "stage_start"• "stage_middle"• "stage_end"• "non_stage" | Nullable (if the placement is dynamic) | “stage_start” |
level | The player's or character's current level. | Nullable (only if no level system) | 10 |
stage | The stage number the user has played. If not in a game, this should be the last known result. | Nullable (if the game has no stages) | 10 |
stageType | The type of stage where the user has played. If not in a game, this should be the last known result. You must use one of the pre-defined strings from the list below. • "primary_stage"• "secondary_stage"• "extra_stage" | Nullable (if the game has no stages) | "primary_stage" |
totalFinishedStage | The total number of stages a player has finished. For games without stages, this should be the total play count. | Nullable (if the information is not available) | 10 |
stageResult | The result of the most recently completed stage.If the ad placement occurs at the end of a stage or game, this should reflect the result of that stage. If the placement is in the middle of a stage/game or the user is not currently in gameplay, provide the result of the last finished stage. You must use one of the pre-defined strings from the list below. • "success"• "fail"• "giveup"• "retry"• "draw"• "exhausted" | Nullable (if the game has no stages) | "success" |
adCooldownSeconds | When a cooldown is applied to an ad placement, this key-value map shows the trigger and duration of the cooldown. The key is omitted when no cooldown is applied. • interstitial_ad : Cooldown calculated from the last interstitial ad• rewarded_ad : Cooldown calculated from the last rewarded ad.• app_open : Cooldown calculated from the app open event• install : Cooldown calculated from the app install event.• other : Cooldown calculated from other eventsExample: If {"rewarded_ad": 120} is included, it means a 2-minute cooldown is applied from the last rewarded ad. | Nullable (if no cooldown is applied) | {"rewarded_ad":10,"interstitial_ad": 20} |
rewardItems | A key-value map of items rewarded to the player. Only for rewarded ads; otherwise, null. | Nullable (if the ad has no rewards) | {"coin": 500, "gem": 10} |
The purchase path. You must use one of the pre-defined strings from the list below.
• "shop"
• "popup"
• "other"
| Name | Description | Required | Sample Value |
|---|---|---|---|
stageType | The type of stage where the user has played. You must use one of the pre-defined strings from the list below. • "primary_stage"• "secondary_stage"• "extra_stage" | Nullable (if the game has no stages) | "primary_stage" |
stage | The stage number the user has played | Nullable (if the game has no stages) | 10 |
| Name | Description | Required | Sample Value |
|---|---|---|---|
stageType | The type of stage where the user has played. You must use one of the pre-defined strings from the list below. • "primary_stage"• "secondary_stage"• "extra_stage" | Nullable (if the game has no stages) | "primary_stage" |
stage | The stage number the user has played | Nullable (if the game has no stages) | 10 |
totalFinishedStage | The total number of stages a player has finished. For games without stages, this should be the total play count. | Nullable (if the game has no stages) | 10 |
stageResult | The result of the most recently completed stage. If the ad placement occurs at the end of a stage or game, this should reflect the result of that stage. If the placement is in the middle of a stage/game or the user is not currently in gameplay, provide the result of the last finished stage. You must use one of the pre-defined strings from the list below. • "success"• "fail"• "giveup"• "retry"• "draw"• "exhausted" | Nullable (if the game has no stages) | "success" |
Nullable
(only if no level system)
| Field | Validation Criteria |
|---|---|
| eventData.goal.category | Verify that the event name exactly matches the string defined in the taxonomy. |
| semanticAttributes | • All keys must match those defined in the taxonomy. • Value types must match the defined types (string, number, boolean). • For revenue events (ad_impression, order_completed), values must be positive numbers. |
| originalCurrency | Must be a 3-letter uppercase code defined by ISO-4217 (e.g., USD, KRW) |
category, semanticAttributes, and customAttributes parameters for event data collection?The event's unique name (e.g., AD\_IMPRESSION).
Only underscores are permitted as special characters; colons and other special characters are not allowed. If the collected data exceeds the maximum limit of 128 characters, only the initial 128 characters will be saved.
Semantic attributes of the event
Semantic attribute data collection is limited by type: up to 1024 characters for strings, and 64 bits for integers or floats.