Video Games
The basic concept of analytics is based on 5 types of measurements of user behavior (known as AARRR):
- Acquisition – where / what channels do users come from?
- Activation – do users have a great first experience?
- Retention – do they come back & revisit over time?
- Referral – do they like it enough to tell their friends?
- Revenue – can you monetize any of this behavior?
These events and their properties are specially designed to track the behavior of video games sites/apps. Tracking these events will cover most of the data that you will need. You can choose different properties and events with custom events.
player_joined (user scope) event
Use this event when a new player registers to play a game. In case there is no need to register, the event should be triggered the first time a player opens a game. This event is the first event that is triggered by a user.
| Property | Example Value | Description |
|---|---|---|
| device_platform | web | The first platform used to play the game like: Web, Mobile, Tablet, PC |
| login_success | TRUE | Registers if a login was successful |
| login_error | Wrong user ID | The description of the log-in e |
start_game (session scope) event
Use this event when a user starts to play the game, trigger it on session start.
| Property | Example Value | Description |
|---|---|---|
| game_id | G15785209 | The unique ID of the game |
| game_name | Jake the villain hunter | The name of the game |
| game_category | RPG | Possible options (among others): Massively Multiplayer Online (MMO), Simulations, Adventure, Real-Time Strategy (RTS), Puzzle, Action, Stealth Shooter, Combat, First Person Shooters (FPS), Sports, Role-Playing (RPG), Educational |
| client_device | Samsung 8 (G950U) | The device the game is running on |
| app_platform | web | Possible options (among others): Web, Mobile, Tablet, PC, Console |
advance_level (event scope) event
Use this event when a user reaches a new level in a game.
| Property | Example Value | Description |
|---|---|---|
| level_id | M15323747 | The unique ID of the level. |
| level_name | Snatch the Emperor | The name of the level. |
| level_order | 6 | The consecutive number of the level. |
| score | 13040 | The score the user had when starting the level. |
make_transaction (event scope) event
Use this event to track different kinds of transactions in a game. Implementing this event can be used to track In App Purchases, purchasing in-game items using virtual currencies, exchanging items to receive other items, auctions etc..
| Property | Example Value | Description |
|---|---|---|
| direction | get | Describes the transaction direction from the user's point of view like: give or get |
| currency | Imperial Credit | The currency used for the transaction. |
| number_of_units | 17 | The number of units involved in the transactions. |
| item_id | BLSTR-07 | The unique ID of the item changing hands in the transaction. |
| item_name | Green laser blaster | The name of the item changing hands in the transaction. |
| type | in-app purchase | The type of of transaction like: in-app purchase, barter, auction etc.. |
start_level (event scope) event
Use this event when the user starts a new level.
| Property | Example Value | Description |
|---|---|---|
| level_id | M15323747 | The unique ID of the level started. |
| level_name | Snatch the Emperor | The name of the level started. |
| level_order | 6 | The consecutive number of the level. |
| score | 13040 | The score the user had when starting the level. |
complete_level (event scope) event
Use this event when a user completes a level.
| Property | Example Value | Description |
|---|---|---|
| level_id | M15323747 | The unique ID of the level completed. |
| level_name | Snatch the Emperor | The name of the level completed. |
| level_order | 6 | The consecutive number of the completed level. |
| score | 15021 | The score the user had when completing the level |
fail_level (event level) event
Use this event if a user failed to successfully complete a level.
| Property | Example Value | Description |
|---|---|---|
| level_id | M15323747 | The unique ID of the level failed. |
| level_name | Snatch the Emperor | The name of the level failed. |
| level_order | 6 | The consecutive number of the failed level. |
| score | 14751 | The score the user had when failing the level. |
log_ui_interaction (event scope) event
Use this event to log the game's reaction info generated by users' in-game behavior. You can use this event to log errors or any other data that is relevant to improving your game.
| Property | Example Value | Description |
|---|---|---|
| x_position | 20.02302 | The x axis position of the user interaction. |
| y_position | 50.10396 | The y axis position of the user interaction. |
| z_position | 0 | The z axis position of the user interaction. |
| message_type | error | The type of message, like: info, debug, warning, error, critical |
| ui_id | M15323747 | The unique ID of the screen where the interaction took place. |
| ui_name | The emperor's chambers | The name of the screen where the interaction took place. |
| element_id | 1425643 | The UI element unique ID the user interacted with. |
| element_name | Weapons selector | The name of the UI element the user interacted with. |
| user_action | click | The UI interaction carried out by the user like: click, double-click, right-click, drag, scroll, type. |
| ui_reaction | menu opened | The reaction of the UI to the user interaction. |
change_settings (event scope) event
Use this event when the user changes the game settings.
| Property | Example Value | Description |
|---|---|---|
| element_id | A-2673BG | The unique ID of the settings element the user changed. |
| element_name | Increase difficulty level | The name of the settings element the user changed. |
| change_from | Low | The mode of the settings before the change. |
| change_to | Medium | The mode of the settings after the change. |
view_notification (event scope) event
Use this event when a game push notification was viewed by the user.
| Property | Example Value | Description |
|---|---|---|
| id | 137853267 | The unique ID of the notification. |
| type | Bonus notification | The type of the notification like: system notifications, team notifications etc. |
| subject | Get your 50K bonus! | The subject of the notification. |
| body | Click here to receive your bonus | The content of the notification. |
