OlympikTracking Event Documentation
This document details all tracking events sent by our applications.
Onboarding
Events related to the first user experience and acquisition.
CLIENT.GAME_LAUNCH
Fires when the game application is launched by the user.
This event does not contain any parameters.
CLIENT.GAME_CLOSED
Fires when the game application is closed by the user.
This event does not contain any parameters.
USER.ACCOUNT_CREATE
A new user has created an account.
| Parameter | Type | Description | Required |
|---|---|---|---|
method | string | Sign-up method (email, google, facebook...) | Non |
USER.CHARACTER_CREATE
A new character has been created.
| Parameter | Type | Description | Required |
|---|---|---|---|
class | string | Character class or type | Non |
faction | string | Chosen faction or camp | Non |
TUTORIAL.STARTED
The player has started the tutorial sequence.
This event does not contain any parameters.
TUTORIAL.STEP_COMPLETE
The player has completed a specific step of the tutorial.
| Parameter | Type | Description | Required |
|---|---|---|---|
stepId | string | Unique identifier for the step | Oui |
stepNumber | number | The step number in the sequence | Oui |
TUTORIAL.SKIPPED
The player has decided to skip the entire tutorial.
This event does not contain any parameters.
TUTORIAL.COMPLETE
The player has successfully completed the tutorial.
This event does not contain any parameters.
Engagement
Events measuring engagement in the core gameplay loop.
SESSION.START
Start of an active game session.
This event does not contain any parameters.
SESSION.PAUSED
Pause of a game session.
This event does not contain any parameters.
SESSION.RESUMED
Resume of a paused game session.
This event does not contain any parameters.
SESSION.END
End of a game session.
| Parameter | Type | Description | Required |
|---|---|---|---|
durationSeconds | number | Total session duration in seconds | Oui |
cause | string | The reason of quit | Non |
GAMEPLAY.PAGE_VIEWED
The player opens a specific game page or menu.
| Parameter | Type | Description | Required |
|---|---|---|---|
pageId | string | Unique identifier for the page | Oui |
GAMEPLAY.LEVEL_START
The player starts a level, mission, or match.
| Parameter | Type | Description | Required |
|---|---|---|---|
levelId | string | Unique identifier for the level/mission | Oui |
difficulty | string | Chosen difficulty level (easy, normal, hard) | Non |
GAMEPLAY.LEVEL_END
The player finishes a level, mission, or match.
| Parameter | Type | Description | Required |
|---|---|---|---|
levelId | string | Unique identifier for the level/mission | Oui |
outcome | string | Result (win, loss, draw) | Oui |
score | number | Score achieved | Non |
timeSpentSeconds | number | Time spent in the level in seconds | Oui |
GAMEPLAY.DEATH
The player's character dies.
| Parameter | Type | Description | Required |
|---|---|---|---|
levelId | string | Level where the death occurred | Oui |
cause | string | Cause of death (enemy_id, fall, trap) | Non |
position | object | Coordinates (x, y, z) of the death | Non |
Progression
Events related to player progression and sense of accomplishment.
USER.LEVEL_UP
The player's character has gained an experience level.
| Parameter | Type | Description | Required |
|---|---|---|---|
level | number | The new level reached | Oui |
timeToLevelSeconds | number | Time elapsed since the previous level | Non |
SKILL.UNLOCKED
A new skill or ability has been unlocked.
| Parameter | Type | Description | Required |
|---|---|---|---|
skillId | string | Identifier of the skill | Oui |
SKILL.USED
The use of an item/skill/ability.
| Parameter | Type | Description | Required |
|---|---|---|---|
skillId | string | Identifier of the skill | Oui |
skillLvl | number | Level of the skill | Non |
ACHIEVEMENT.UNLOCKED
An achievement or trophy has been obtained.
| Parameter | Type | Description | Required |
|---|---|---|---|
achievementId | string | Identifier of the achievement | Oui |
QUEST.ACCEPTED
A quest has been accepted by the player.
| Parameter | Type | Description | Required |
|---|---|---|---|
questId | string | Identifier of the quest | Oui |
type | string | Quest type (main, side, daily) | Non |
QUEST.COMPLETED
A quest has been successfully completed.
| Parameter | Type | Description | Required |
|---|---|---|---|
questId | string | Identifier of the quest | Oui |
timeToCompleteSeconds | number | Time taken to complete it since acceptance | Non |
Monetization
Events related to monetization (purchases, ads, subscriptions).
STORE.OPEN
The player opened the in-game store interface.
| Parameter | Type | Description | Required |
|---|---|---|---|
entryPoint | string | From where the player opened the store (e.g., main_menu, death_screen) | Non |
IAP.PURCHASE_COMPLETE
An In-App Purchase was successfully completed.
| Parameter | Type | Description | Required |
|---|---|---|---|
productId | string | The unique identifier of the purchased product | Oui |
realCurrencyAmount | number | Amount spent in real currency (e.g., 5.99) | Oui |
realCurrencyType | string | Currency code (e.g., 'EUR', 'USD') | Oui |
virtualCurrencyAmount | number | Amount of virtual currency received | Non |
AD.VIEWED_COMPLETE
An ad (rewarded video) was watched to completion.
| Parameter | Type | Description | Required |
|---|---|---|---|
placementId | string | The ad placement within the game | Oui |
Technical
Technical events for tracking performance and errors.
ERROR.CRITICAL
A critical error or crash occurred.
| Parameter | Type | Description | Required |
|---|---|---|---|
errorMessage | string | Error message or stack trace | Oui |
context | string | Where the error occurred (e.g., loading_level_x) | Non |
PERF.REPORT
Periodic session performance report.
| Parameter | Type | Description | Required |
|---|---|---|---|
avgFps | number | Average frames per second | Oui |
maxMemoryMb | number | Maximum memory usage in MB | Oui |
avgLoadingTimeMs | number | Average loading time in ms | Non |
Social
Events related to social interactions and the community.
SOCIAL.FRIEND_ADDA player adds another player to their friend list.
This event does not contain any parameters.
SOCIAL.GUILD_JOINA player joins a guild or clan.
guildIdstringSOCIAL.CHAT_MESSAGE_SENTA message is sent in a chat channel.
channelstring