Analytics events

Unity collects AnalyticsA data platform that provides analytics for your Unity game. More info
See in Glossary data by dispatching events when someone uses your application or game. Unity dispatches a set of core events automatically. You can dispatch additional events to collect richer and deeper information about how users play your game or use your application.

The types of Analytics eventsEvents dispatched to the Analytics Service by instances of your applications. Analytics events contain the data that is processed and aggregated to provide insights into player behavior. More info
See in Glossary include:

• Core EventsCore events are the basic events dispatched by the Unity Analytics code in your game. These events, and the analytics based on them, become available simply by turning on Unity Analytics for a Project. Core events include: app running, app start, and device info. More info
  See in Glossary: Session-based and device-based events.
• Standard EventsStandard events are application-specific events that you dispatch in response to important player actions or milestones. Standard events have standardized names and defined parameter lists. More info
  See in Glossary: Behavioral events with standard names and parameters for tracking user experience and player behavior.
• Custom EventsCustom events are freeform events that you can dispatch when an appropriate standard event is not available. Custom events can have any name and up to ten parameters. Use standard events in preference to custom events where possible. More info
  See in Glossary: Fully-customizable events whose names, purposes and parameters you define as needed.
• Transaction Events: Specialized events you can use to track in-app purchase (IAP) transactions made through 3rd-party IAP APIs.
• Other: Specialized events, like Heatmap events, intended for a specific purpose. Such events are usually based on Custom Events, but the APIs for sending them control the event names and parameters.

Unity dispatches Core Events automatically. You must dispatch the other types of events at the appropriate times. You can dispatch Standard and Custom Events from an Analytics Event Tracker Component or from a script.

Your Unity game or app sends Analytics events to a Unity web service. The Analytics system collects the raw events and processes them for display on your project’s Analytics Dashboard. If the computer or device running the application cannot connect to the web service, Unity caches the events locally until the connection becomes available.

Note: If you have a Unity Pro subscription, you can download the raw event data directly. You can import this raw data into your own analytics tools and perform ad-hoc analyses that may not be supported by the Unity AnalyticsSee Analytics More info
See in Glossary Dashboard.

Standard Events versus Custom Events

Standard Events are a form of Custom Event. The difference is that Standard Events are standardized. Each Standard Event has a predefined event name and a set of required parameters. Standardization provides several benefits:

• Helps avoid easy-to-make coding errors, such as using slightly different names and parameters for what should be the same event.
• Provides a guide for useful places in your application to dispatch an Analytics event.
• Provides a known context for an event, which the Unity Analytics system can use to provide more meaningful Analytics reports.

Because of these benefits, you should use Standard Events rather than Custom Events whenever possible. Only use Custom Events when no Standard Event is appropriate.

• 2018–03–02 Page published with no editorial review

• 2018–06–04 - Service compatible with Unity 5.2 onwards at this date but version compatibility may be subject to change

• New feature in 5.2

• 2018–06–04 - Demographics event removed