Identity Events #

The Events tab enables you to view a chronological history of all actions associated with a particular identity. You can view when a play session began and ended, and all the events and achievements (e.g. joined a group, unlocked a new character, received a reward, etc.) that occurred in between.

Identity Events stream
Identity Events stream

The actions displayed are specific, predefined events in your game, enabling you to capture any details desired to understand and improve the player experience, engagement, and ultimate success of your game.

Default events #

There are a number of default events - events that do not need to be manually configured - available in Satori:

These default events must still be fired by your game client, if desired, and are not automatically tracked by the Satori SDK.

Some default audiences available in Satori are based on the computed properties generated from these default events. If these default events are not fired from game clients, the resulting audiences are affected.

EventTypeDescription
adStartedstringIndicates an ad with the given identifier was started.
appLaunchedstringIndicates the application with the given identifier was started.
gameFinishedstringIndicates a game with the given identifier was finished.
gameStartedstringIndicates a game with the given identifier was started.
purchaseCompletednumericThe amount in US cents of the purchase.
screenViewedstringIndicates a game screen with the given identifier was viewed.
tutorialCompletedstringIndicates a tutorial with the given identifier was completed.
tutorialStartedstringIndicates a tutorial with the given identifier was started.
tutorialStepCompletednumericThe step number of a multipart tutorial that was completed.
tutorialAcceptedanyIndicates a tutorial with the given identifier was accepted.
tutorialAbandonednumericIndicates a tutorial with the given identifier was abandoned.
tutorialDeclinedanyIndicates a tutorial with the given identifier was declined.
donationClaimedanyIndicates a donation with the given identifier was claimed.
donationGivenanyIndicates a donation with the given identifier was given.
donationRequestedanyIndicates a donation with the given identifier was requested.
currencyGrantednumericIndicates a currency with the given identifier was granted.
itemsGrantednumericIndicates an item with the given identifier was granted.
energyGrantednumericIndicates an energy with the given identifier was granted.
energyModifierGrantednumericIndicates an energy with the given identifier was modified.
rewardModifierGrantednumericIndicates a reward with the given identifier was modified.
currencySpentnumericIndicates a currency with the given identifier was spent.
itemSpentnumericIndicates an item with the given identifier was spent.
energySpentnumericIndicates an energy with the given identifier was spent.
purchaseIntentanyIndicates that there has been an intent for a purchase with the given identifier.
adPlacementStartedanyIndicates an ad placement with the given identifier was started.
adPlacementSucceededanyIndicates an ad placement with the given identifier has succeeded.
adPlacementFailedanyIndicates an ad placement with the given identifier has failed.
achievementUpdatednumericIndicates an achievement with the given identifier was updated.
achievementClaimedanyIndicates an achievement with the given identifier was claimed.
progressionPurchasedanyIndicates a progression with the given identifier was purchased.
progressionUpdatednumericIndicates a progression with the given identifier was updated.
progressionResetanyIndicates a progression with the given identifier was reset.
itemsConsumednumericIndicates an item with the given identifier was consumed.
statUpdatednumericIndicates a stat with the given identifier was updated.
teamCreatednumericIndicates a team with the given identifier was created.
incentiveCreatedanyIndicates an incentive with the given identifier was created.
incentiveDeletedanyIndicates an incentive with the given identifier was deleted.
incentiveSenderClaimedanyIndicates an incentive with the given identifier has been claimed by the sender.
incentiveRecipientClaimedanyIndicates an incentive with the given identifier has been claimed by the recipient.
eventLeaderboardRolledanyIndicates an event leaderboard with the given identifier has been rolled.
eventLeaderboardUpdatednumericIndicates an event leaderboard with the given identifier has been updated.
eventLeaderboardClaimedanyIndicates an event leaderboard with the given identifier has been claimed.
unlockableCreatedanyIndicates an unlockable with the given identifier has been created.
unlockableUnlockStartednumericIndicates an unlockable with the given identifier has been unlocked.
unlockableUnlockPurchasedanyIndicates an unlockable with the given identifier has been purchased.
unlockableSlotPurchasednumericIndicates an unlockable slot has been created.
unlockableClaimedanyIndicates an unlockable with the given identifier has been claimed.

A series of computed properties are automatically generated and tracked per identity for each of these default events, so long as the event is fired by the client.

Server-side events #

The default events, when fired, are sent to Satori from the client. However, there are three events tracked that can only be sent from the server and cannot be submitted from the client:

EventDescription
_identityCreateThe Satori identity was created.
_sessionStartA new play session has started.
_identifyThe Satori identity, and its session, are enriched and identified with the user’s (now authenticated) identity.

These events are used in situations where players have not yet authenticated with your game server, but you still want to track their activity. For example, if a player is playing your game as a guest, and then later authenticates with your game server. See an example.