Search Unity

Introducing Standard Events

May 12, 2017 in Technology | 4 min. read

"What custom events should I implement?" is a question we get asked a lot at Unity Analytics. Believe it or not, asking this doesn't mark you as an analytics newb: in our jobs across the industry, we've collectively had this conversation on what data to track in every size of organization, from indies to big studios.

Opinions on what to track vary widely, but here at Unity Analytics we believe the answer begins by asking "what questions do I want answered?" While we can't precisely answer that question for each and every one of you, we do know some of the most commonly-asked questions that developers have, and can use that knowledge to help you begin exploring your questions. To facilitate this, we're introducing a new tool: Standard Events.

"Standard" Events

Our new feature quickly points you to areas of player behavior you likely want to explore. Instead of completely freeform custom events, these new standard events are normalized to help you ask some pretty sensible questions, such as "how are my players doing?", "where are they spending money?", and "how engaged are they in my game?" Just by using the SDK's API, you get a built-in checklist of questions you should probably be asking.

The Standard Events – and their associated questions – are broken into the following five groups:

  • How well are players onboarding?
  • How are players progressing?
  • How effectively are players monetizing?
  • Which UI screens do they visit?
  • How actively are players engaging and socializing?

We've captured these five areas in the acronym A POEM, as explained in the short video below.

This content is hosted by a third party provider that does not allow video views without acceptance of Targeting Cookies. Please set your cookie preferences for Targeting Cookies to yes if you wish to view videos from these providers.

Our beta users have had some great reactions to Standard Events:

"Standard Events cover 90% of what we normally track, so that works really well. The programmers also like this approach as it's less error prone and serves as a nice guideline of what events should get tracked."
Karol Drzymała, Orbital Knight

"Standard Events are exactly what we need. The API gives us the exact analytics calls we've been using on our own, and the integration was fast and simple."
Kyle Yamamoto, MochiBits

If you think Standard Events might help you, you can download it right away from our asset store page.

We'll dive deep on each Standard Event in a future post, but for now let's just list them all by category, including a quick explanation of what each event is for.

Onboarding/First-time User Experience

Event nameEvent function
first_interactionThe first voluntary action a player takes after install.
tutorial_startThe player began a tutorial.
tutorial_stepThe player passed a key stage in a tutorial.
tutorial_skipThe player skipped past a tutorial.
tutorial_completeThe player concluded a tutorial.

Game Progress

Event nameEvent function
level_startThe player entered into a new level.
level_failThe player failed to complete a level.
level_quitThe player quit a level before completing it.
level_skipThe player skipped past a level so they could carry on with the game.
level_completeThe player successfully completed a level.
game_startThe player began a game. This event is especially useful where a game has a distinct beginning and ending (e.g., arcade, endless runner).
game_overThe player concluded a game. This event is especially useful where a game has a distinct beginning and ending (e.g., arcade, endless runner).
level_upThe player leveled up, as might happen through an increase in experience (not to be confused with the completion of a game level).


Event nameEvent function
store_openedThe player opened an in-game store.
store_item_clickThe player selected an item within the store.
iap_transactionThe player spends real-world money to make an In-App Purchase.
item_acquiredThe player acquires an item within the game.
item_spentThe player expends any resource within the game.
ad_offerThe player was given the option to watch an ad.
ad_startThe ad started.
ad_skipThe user skipped the ad.
ad_completeThe user finished watching the ad.
post_ad_actionThe user completed a desired action (e.g., an install click or purchase) at the end of an ad.

Application Navigation

Event nameEvent function
screen_visitThe player navigated to a UI screen.
cutscene_startA cutscene began to play.
cutscene_skipThe player opted to skip past a cutscene.


Event nameEvent function
push_notification_enableThe player activated push notifications.
push_notification_clickThe player reacted to a push notification.
chat_msg_sentThe player sent a chat message.
achievement_stepThe player completed a milestone on the way to an achievement.
achievement_unlockedThe player successfully completed an achievement.
user_signupThe player registered through a login system.
social_shareThe player shared something (e.g., an image, invitation, or challenge) with a friend.
social_share_acceptOne player reacted to the social share of another.
May 12, 2017 in Technology | 4 min. read