Understanding the performance of your playables beyond the ad network metrics is key to optimising your creative.
On top of this, our custom events API allows you to track specific events within your playable that will help you understand the user flow and drop off points within the ad.
All custom events are in the
In order to avoid misuse or user-code errors, Luna enforces two limits on custom events.
- 256 events logged per playable session
You can log up to 256 events in a given playable session (per user). After 256 logged events, any subsequent events will be dropped by the server.
- 32 events per unique event name
You can log up to 32 events per unique event in a given playable session (per user). After 32 logged events, any subsequent events will be dropped by the server.
Luna provides a number of commonly used and useful custom events to be used in your playable. These events will also have pre-built reporting template in Luna Playground's Insights pages.
Each event has a name and optional integer parameter.
TutorialStarted- the playable has presented the tutorial.
TutorialComplete- the user has completed the tutorial.
LevelStart- a level was started.
LevelWon- the user won a level.
LevelFailed- the user failed a level.
LevelRetry- a user retried a level.
Score- submit a score to Luna Insights.
EndCardShown- the end card was shown.
If your game has specific experiences which you want to measure, and the needs aren't met via one of the pre-defined events detailed above, you can also use your own custom events.
This API allows you to pass in any string, which will be logged and available for reporting in Luna Insights.
For example, you could log an event with different values based on what threshold the user's score reached:
We recommend not passing in values that can widely vary like a player's score, as each unique value will create its own unique event. So if a score can vary between all values in between 0 - 1000, you could potentially end up with 1000 different events.
You can find out all you need to know on this here.
You can find out all you need to know about these settings here.