Documentation

​
​

Development

User Acquisition

Monetization

Industry

Analytics

Unity SDK

Client API

Analytics

LiveOps
​
​
Analytics
  • Overview
  • Get started
  • Pricing
  • Concepts
  • Tutorials
  • Reference
    • Standard events
    • Standard audiences
    • Reserved parameter names
    • Data Explorer V1 metrics
    • Data Explorer V2 measures and metrics
    • SDK Event class
    • SDK CustomEvent class
    • SDK behavior
    • SQL Data Explorer queryable tables
    • SQL Data Explorer cookbook
    • Data Access available views
    • Glossary
  • Privacy and consent
  • FAQ
  1. Unity Analytics

Standard Events

Discover predefined events you can use to track key player actions and game lifecycle events.
Read time 2 minutes
Last updated 9 months ago

Standard Events are events that are ready to use without the need for instrumentation or developer configuration. Unity Analytics SDK sends some of these events automatically, but you need to populate and record others manually at an appropriate point in your game's lifecycle. These are used by out-of-the-box dashboards and in the Data Explorer.
Standard events are triggered when players perform key actions. You can find out things like: How engaged are your players? What are your best performing countries? Which audiences are underperforming?
The available standard events are:

Event Name

Description

Trigger type

aquisitionSource
Record information about the channel that the user was acquired from. This event should be populated with the information available from the attribution provider's SDK.Requires manual triggering. For information about how to record this event, see the attribution support tutorial.
sdkStart
Recorded at the start of a session. A new session starts when the user launches an app and when the user ID changes.Automatic.
newPlayer
Recorded at the start of a session if the user ID is different from the previous session. A new session starts when the user launches an app and when the user ID changes.Automatic.
gameStarted
Recorded at the start of a session. A new session starts when the user launches an app and when the user ID changes.Automatic.
clientDevice
Recorded at the start of a session. A new session starts when the user launches an app and when the user ID changes.Automatic.
gameRunning
Recorded periodically when the app is running to detect session activity.Automatically every 60 seconds, if no other events have been recorded since the last check.
gameEnded
Recorded when a player exits the game.Automatic. Note that if the operating system does not give sufficient time for the game to shut down gracefully, this event may not be recorded, or may be cached to local storage and only uploaded if the game is started again later.
ddnaForgetMe
Recorded when a player opt outs of data collection.Manually by calling
RequestDataDeletion()
. See the manage data privacy page.
adImpression
Available to be recorded manually when a player has been shown an ad within the game.Requires manual triggering. For information about how to record this event, see the record Ad Impression events tutorial.
transaction
Recorded when a player makes an in-app purchase and tracks the purchase amount. Transaction validation can be done via the Unity IAP.Requires manual triggering. For information about how to record this event, see the record transaction events tutorial.
transactionFailed
Recorded when a player makes an unsuccessful in-app purchase transaction. Successful transactions are tracked by the
transaction
event.
Requires manual triggering. For information about how to record this event, see the record transaction events tutorial.

Copyright © 2026 Unity Technologies
LegalPrivacy PolicyCookiesDocumentation Terms of UseDo Not Sell or Share My Personal InformationYour Privacy Choices (Cookie Settings)

"Unity", Unity logos, and other Unity trademarks are trademarks or registered trademarks of Unity Technologies or its affiliates in the U.S and elsewhere (more info here). Other names or brands are trademarks of their respective owners.

Some pages are machine-translated for convenience, and may contain inaccuracies. In the event of conflicting information, the English version is authoritative.


    Report a problem with this page