Get started with Analytics
To get started, you need to:
- Sign up for UGS.
- Link your dashboard project to a Unity Editor project.
- Initialize UGS in your game code.
- See billing information.
- Sign in to the Unity Cloud Dashboard.
- Select Sign Up in the top banner and follow the instructions.
Set up Analytics
You can set up and manage Analytics in the Unity Cloud Dashboard:
- Go to cloud.unity.com.
- Select + under Shortcuts in the left panel.
- Search for Analytics and select to pin to the left.
- Select to open Analytics.
When you launch Analytics for the first time, this adds Analytics to the Shortcuts section on the sidebar and opens the Game Performance page.
Link your project
In the Unity Editor, you'll need to link your local project build to a Unity Project ID.
- Go to Edit > Project Settings > Services.
- Log in with your existing credentials.
- Select your project from the drop-down list and select Link project ID.
In the latest Unity editor versions, the package will be visible in Package Manager.
The minimum editor version for Analytics is 2019.4.
To install the latest Analytics package for Unity, you should use the latest version of the Unity Editor and follow these steps:
- In the Unity Editor, open Window > Package Manager.
- In the Package Manager, select the Unity Registry list view.
- Search for Analytics, or locate the Analytics package in the list.
- Select the package, then select Install.
See the Package Manager documentation for more information.
Analytics is an end-to-end data and analysis solution, designed to support your entire studio. Analytics is free to get started and offers a generous free tier with a pay-as-you-scale afterwards, where you only pay for additional Monthly Active Users. This helps developers determine and predict their costs more easily as games scale from increased numbers of players. MAU is also a widely recognized industry standard for measuring user engagement that can be easier to understand compared to other models.
The current consumption pricing model based on events and query seconds will stop and customers will be charged on a model based on the number of Monthly Active Users (MAUs). MAU-based pricing is currently available for Leaderboards and UGS Analytics from August 1, 2023. Usage is reset at the beginning of each month. You cannot switch to the old pricing model.
Monthly Active Users measures the total number of unique user IDs that had at least one session per environment in a month. This is measured by the unityInstallationID or any custom userID passed to the Analytics service, and is specific to the Analytics product and not impacted by other products in the UGS bundle.
You are charged when the number of MAUs exceed the Free Tier or Fair Usage limits.
The below table shows the pricing tiers:
|Number of users||Cost per MAU|
|0 - 50,000||$0.00 (Free Tier)|
|50,001 - 150,000||$0.00360|
|150,001 - 500,000||$0.00315|
|500,001 - 1,000,000||$0.00293|
|1,000,001 - 5,000,000||$0.00225|
|5,000,001 and higher||Contact us to learn about more pricing options|
Fair Usage Limits
Fair usage limits is a set amount of usage capacity. If you exceed the fair usage limit and your usage is beyond the monthly free tier limit, a surcharge will be added to your bill. This is primarily to prevent abuse of Unity’s services by customers performing an excessive number of operations per MAU. Unity expects a very small number of edge cases to be impacted by these limits. Select Administration > Cost and Usage Reporting in the Unity Cloud Dashboard.
After you surpass the Free Tier limit, you are subject to fair usage limits to ensure fairness and reliability. As you approach your fair usage limits you’ll be notified.
The following limits apply:
- 500 custom events per MAU
- 0.05 seconds of SQL Data Explorer query time per MAU
In the event that a surcharge does apply and multiple fair usage limits are exceeded, the meter with the highest percentage over the limit is considered for surcharging. The surcharge for excess usage is reflected on your monthly bill, and these limits reset at the beginning of each calendar month.
Fair usage is an average value and might fluctuate throughout the month as MAU cumulatively increases; the source of truth for your usage and billing will be reflected in your bill at the end of each month. Note that both valid and invalid events count towards the custom event limit.
If you exceed fair usage limits and haven’t provided payment details, you might be contacted by Unity to discuss reducing usage or accepting special terms.
Follow best practices available in this article. Note that both valid and invalid events count towards the custom event limit. Make sure your queries are optimized for efficiency, particularly when handling large datasets. Refer to our cookbook for guidance. For other concerns or questions, contact our support team or reach out to your Unity client partner.
You can monitor your limits in the Unity Cloud Dashboard in multiple locations, including the Administration > Service Usage page and the Analytics landing page.
Note: The data in the reporting dashboard is delayed by about 14 hours.
There is one MAU usage tracker and two fair usage trackers, for custom events and query seconds. If you exceed any of the free tiers, banners appear on the Dashboard to notify you.
Purchasing Unity Analytics
Unity Analytics is a sub-product of Unity Gaming Services, so you must purchase UGS as a whole to use Analytics. See here to learn how to create a Unity ID.
When you have purchased UGS, it can take up to one hour before your pipelines are available and set up. However, you will immediately have access to the UI (such as Dashboards). If you cancel UGS, you immediately lose access to the UI , and lose access to the APIs 30 days later.
If you return to UGS, any Analytics events that you sent after canceling might be processed, but access to the ingestion pipeline is lost after you cancel.
Historic data (such as events or player information) is deleted 120 days after cancellation and cannot be retrieved.
The first billing period for the new Analytics MAU pricing model will run from August 1, 2023 to August 31, 2023, and customers can expect to receive their first bill under the new pricing model in early September.
Your first bill under the new pricing model is based on the sum of Monthly Active Users (MAU) across all projects and environments in your organization. If your MAU is below 50,000, you can use the Analytics service free of charge. If your MAU exceeds 50,000, you are charged at a different rate per tier exceeded. Refer to the pricing table above to estimate your costs or submit a request to speak with our support team about your project.
What if I have existing contracts with Unity?
The new pricing model applies to all customers, regardless of any existing contracts or commitments. However, if you have a negotiated contract, we recommend reaching out to your partner at Unity to understand how the new pricing model will affect your billing.
Will I be billed for my Legacy Analytics data?
Data that is migrated from Legacy Analytics to the new UGS Analytics does not count towards the MAU billing.
However, any data received into UGS Analytics from the UGS Analytics SDK is subject to billing. Once a customer installs the UGS Analytics SDK into their project and it begins ingesting data, it will be added towards the MAU model and be billable.
Additionally, if SQL Data Explorer is used to query against data imported from Legacy Analytics, it counts towards the Fair Usage Limits.
What about my other Unity services?
Each UGS product has its own billing unit and is separate from each other. The Analytics MAU meter is specific to the Analytics service and does not impact the pricing of other UGS services. Your Analytics usage exceeding the free tier is visible as a line item on your bill.