Monetisation Events
Introduction
Monetisation events are crucial for understanding and optimizing how your game generates revenue. By tracking these events, you can gain insights into player spending behavior, ad interactions, and in-app purchases. This information is essential for maximizing your game’s revenue potential and enhancing the overall player experience.
Ad Events
Core Ad Events
💡 | To simplify the management of ad queries, rewards, and events, you can utilize the Ads Module. This module handles interaction with adverts and automatically tracks the necessary events. In brackets I have indicated which events are used under the hood of the module. |
Core ad events help track basic interactions with in-game advertisements. These events are essential for understanding player engagement with ads and optimizing ad placements for maximum revenue.
BannerShowRequested
Use this event to track when a banner ad is displayed to the player.
InterstitialShow
Use this event to track when an interstitial ad is displayed to the player.
RewardVideoShow
Use this event to track when a rewarded video ad starts playing.
❓ | For more advanced ad tracking and detailed flow instructions, refer to our Advanced Ad Documentation. |
RewardVideoCollect
Use this event to track when a player collects a reward after watching a rewarded video ad. This event includes a reward parameter, similar to the EconomyEvent event, which details the reward received by the player. As such, there is no need to fire a separate EconomyEvent event for the reward.
In-App Purchase Events
💡 | IAP Validation Module: Using this module enhances the reliability of your in-app purchase tracking. For detailed instructions and implementation, refer to our IAP Validation subpage. This module handles IAPs purchases with validation and automatically tracks the necessary events. **In brackets I have indicated which events are used under the hood of the module. |
InAppPurchase
The InAppPurchase event tracks player transactions involving real money. This event is crucial for understanding player spending habits and optimizing in-app purchase offerings. The InAppPurchase event inherits logic from the EconomyEvent event, making it essential to understand the logic behind the EconomyEvent event.
On the server side, we parse the InAppPurchase event similar to the EconomyEvent event with our economy pipeline.
Product Types:
- Items: Typically boosters / power-ups, and resources (common in idle games).
- Virtual Currencies: Includes soft and hard currencies like coins, gems, etc.
- Real Currencies: Represents real money transactions (USD, EUR, etc.). Include the following parameters for accurate tracking:
realCurrencyType: The currency code (e.g., USD, GBP, HKD, etc.). The value must use the ISO 4217 Currency Code for the location of the player.realCurrencyAmount: The amount of currency received.
💡 | For realCurrencyAmount, provide the currency’s actual face value. Lion Analytics then transforms this value into minor units. For example, for an IAP that costs $2.99 USD, provide:
|
💡 | Also we perform currency conversion in our data pipelines based on the values of realCurrencyType and realCurrencyAmount. |
Other Monetization Events
ShopEntered
Use this event to track when a player enters the in-game shop. This helps understand shopping behavior and optimize the shop layout and offerings.
ProductViewed
Use this event to track when a player views a product in the in-game shop. This event provides insights into player interest and can help in optimizing product placements and promotions.