FAQ
General
What is Unity Analytics? Unity Analytics provides an end-to-end suite of tools that studios can use to understand how their players engage with their game. Answer questions about game performance and player behavior and take action to roll out new configurations or run AB tests without releasing new versions of your game.
Is there a cost associated with Unity Analytics? Analytics uses a pricing model based on monthly active users (MAU). MAU is determined by the total count of unique user IDs within your organization that have engaged in at least one session during a month. Under this pricing structure, there's a free tier of 50,000 MAU per month to help you get up and running without incurring any costs. After that, the price you pay scales along with your player base. Find more information on our billing page.
How can I get started with Analytics? Follow our get started with Analytics tutorial.
What platforms are supported? Analytics supports the following platforms:
- iOS
- Android
- Desktop (Windows, Linux, Mac)
- WebGL
How can I submit feedback? Fill in this form to submit any feedback, bugs or feature requests. We plan to trigger an in-product customer satisfaction survey and reach out through email to schedule customer feedback calls.
What versions of Unity are supported? The minimum Unity Editor version required for Unity Analytics is Unity 2019.4.
How long does it take before my data shows in the dashboard? After the SDK installation, it can take a minimum of one hour for the metrics to be processed for analysis in the dashboards and Data Explorer. To confirm your integration is successful, use the Event Browser to view your event stream.
What KPIs can I track? A full list of metrics can be found on the Data Explorer V1 metrics or Data Explorer V2 measures and metrics pages to track against your game KPIs. The list is limited to the ones predefined with no ability to create custom metrics.
Why do I get an Unexpected Error message when viewing Analytics? Check that you don't have an ad blocker enabled; they can cause issues on Analytics pages.
Events
Are there limits to how many events I can send? There is currently no event limit for Unity Analytics. We strongly recommend to limit the number of custom events per MAU to 500 custom events per MAU to be in line with our fair usage limits.
Are there any size limitations on my event parameters? We recommend you avoid sending events with large parameter values (greater than 100 characters); these are slower to analyze later. The overall size of each event or batch of events is limited to 4MB (including the entire JSON serialization of the event). The SDK automatically uploads events in valid batches, and discards outsized events with a console warning.
Where are my events, some are missing? First see the Event Browser. This is the first place events flow prior to the dashboards and Data Explorer. Verify that the events are valid. Select the Invalid Events tab which displays an invalid reason. For more ideas please see our debugging tutorial.
My events fail with the reason that duplicate events are detected.
Duplicate events can appear within the Event Browser; this is mostly likely due to a player having network connectivity issues, meaning that the SDK is unable to confirm that events were received, so it sends them again. All the events have a unique eventUUID
value so any duplicates are immediately rejected by the platform. This is not something to worry about.
What happens to events collected during offline play? Events recorded during offline play are cached locally on the client device and sent when connectivity is restored. For more information, see our SDK behaviour page.
Can I see what events are being sent? The events sent are seen within 5 - 15 minutes of being sent in the Event Browser. For more places to look, see our debugging tutorial.
Can I track player attribution?
You can track the data provided by MMPs on the client side such as (but not limited to): the ad network, the specific ad which brought the user to your game, and the cost to acquire this user. All of this data can be recorded in our standard event, acquisitionSource
. Find out more in the how to track user acquisition data tutorial.
Can I track revenue?
Yes, you can track IAP revenue by manually recording transaction
events, or if you are using the Unity IAP Package, it can do this automatically as long as Analytics is also installed and enabled.
You can also track ad revenue by recording adImpression
events with the adEcpmUsd
parameter populated. You are responsible for populating and recording this event in your code. Not all ad provider SDKs make the ad revenue available to the client at runtime.
Privacy
Is Analytics COPPA compliant? To provide analytics for your games, Unity Analytics generates an anonymized user ID for each user in your game unless provided with an external user ID by the developer. We do not use any of these IDs generated from Child Apps to track users across apps built by other developers or to map users between devices, or browsers on the same computer. See the privacy overview page for information on the personal data collected.
If your application is a Child App, you need to designate it as such within the Editor service panel or via the project creation process in the Unity Dashboard.
Is Unity Analytics GDPR compliant? Maintaining compliance with GDPR when you use Unity Analytics is a shared responsibility. Unity is the data processor and therefore provides the functionality for the developer to allow a player to opt in and out of data collection and to manage the personal data that Unity collects about them, as required by the GDPR. Please see our guide on managing data privacy with the SDK.
Data
Can I send events from non-Unity apps? Yes. Although we only provide the SDK for Unity projects, you can still use the REST API to upload events from other sources, such as a server.
Can I send events from a server? Yes, events can be sent to the Analytics REST API.
Can I send data I exported from another service? You can't send data directly from another service, but you can send data to the Analytics REST API if you have exported it and transformed it to match the analytics event definitions in your project.
Can I backfill old data? No, events with an event timestamp older than 31 days ago are dropped automatically.
How long is player data retained? Player data retention on Analytics varies based on the type of data. Metric data (DAU, MAU, session length, etc.) for dashboards and user profiles are retained until either the player requests their deletion or the developer initiates their removal. Raw event data is kept for 13 months, and provides year-on-year analysis, then automatically deleted. Once raw event data is deleted, it cannot be retrieved, and developers should conduct analyses within the retention period. The data is primarily used for analysis and targeting purposes.
Developers can request data deletion on players' behalf either by requesting it through the dashboard or if you submit an opt out request through the SDK. Data deletion requests affects metric data, raw event data and user profile data.
Can I export my data? Reports that are created within the dashboard can be exported to PNG or CSV. Alternatively, if you want to export raw data you can make use of Data Access to access your organization data through Snowflake.
Can I disable Analytics? Yes, Analytics can be enabled and disabled from the Settings page on the Unity Dashboard. Disable this setting to prevent further data from being recorded. You can re-enable it again at a later date to resume data recording.
Can I delete my data? Yes, use Game Data Deletion to delete your data per environment.
Can I delete a player's data?
There is a "Request Data Deletion" function built into the SDK that is used to delete all the data for a given player. It records a ddnaForgetMe
event that results in all the data for the player being deleted within the next 30 days. This event can also be submitted through the Analytics REST API. Note, if new data is received for the player it is recorded. See privacy overview for more information.
Can I block a player? No, it's not possible to block individual players.
Where are the servers hosted? Our servers are in Belgium and we use Snowflake instances in the Netherlands to store data plus a replicated copy in Iowa.