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 their 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? To get started, you need to:

• Install the Analytics SDK in the Package Manager
• Link your dashboard project to a Unity Editor project
• Initialize UGS in your game code

What platforms are supported? Unity 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. More information about the Event Browser can be found here.

What KPIs can I track? A full list of metrics can be found on Data Explorer 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 AdBlocker 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 to avoid sending events with large parameter values (greater than 100 characters); these are slower to analyze later. The overall size of each event is limited to 1MB. This includes the entire JSON serialization of the event.

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. More information is found here.

My Events fail with the reason that duplicate events are detected. Duplicate Events can appear within the Event Browser; this is likely when the events are sent over the SDK which doesn’t log them as received and sends them again. All the events have a unique eventID so any duplicates are immediately rejected by the platform. This is not something to worry about and can happen when a player has network connectivity issues.

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.

Can I see what Events are being sent? The events sent are seen within 5 - 15 minutes of being sent in the Event Browser or if you log into the console. More information is found here.

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 records in our standard event: acquisitionSource. Find out how here.

Can I track revenue? Track IAP revenue in Unity Analytics if you use the Unity IAP Package and have Unity Analytics installed and enabled. Alternatively, if you are not using the IAP Package, record your own transaction events and send them to Unity Analytics.

Record an adImpression event and populate the adEcpmUsd parameter and any other required parameters, to track revenue. You are responsible to populate this event and send it 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 a userID 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. More information about managing data privacy is found here.

Data#

Can I send Events from non-Unity apps? The Analytics package and the REST API are the only methods to send data that are currently supported.

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 is 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 is retained until either the player requests its deletion or the developer initiates its removal. Raw event data is kept for 13 months, and provide 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, and 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 again access your organization data through Snowflake.

Can I disable Analytics? Yes, Analytics can be enabled and disabled from the Analytics Settings page on the Unity Dashboard. Disable this setting to prevent further data from being recorded. It is re-enabled 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.