Get started with Unity Analytics

With Unity Gaming Services and the Analytics package, actions that users take in your game appear on the Unity Dashboard. In this tutorial, you’ll set up your first Unity Dashboard project and link it to your game in one of two ways: either through the Dashboard or through the Unity Editor.

New to Unity?

If you’re new to Unity, welcome! The Unity Essentials learning pathway has been designed to help you get set up and ready to create in the Unity Editor. We recommend you complete this pathway before continuing with Unity Analytics.

Review the Unity Editor basics

If you need to refresh your memory of the Unity Editor basics, you can take a moment to review Explore the Unity Editor at any time.

Confirm access to the Unity Dashboard

To complete these tutorials, you’ll need to create an account for Unity Gaming Services and access to your account on the Unity Dashboard.

Set up your Unity project

To set up your Unity project, follow these instructions:

1. Install Unity 6.2 or higher, if you haven’t already done so.

2. Create a new Unity project using any template, or use an existing Unity project built with Unity 6.2 or higher.

Note: Creating a project via the Unity Hub will automatically create a project of the same name in the Unity Cloud Dashboard.

3. Install the Analytics package, version 6.1.0 or higher, into your project.

Important: Be sure to select the Analytics package, not the older Analytics Library.

The Unity Dashboard is organized into projects. You may create a new Dashboard project through either the Dashboard, the Unity Hub, or the Editor. Skip to the next step if you prefer to create a new project through the Editor. Creating a project from the Unity Hub automatically creates the project in the Unity Dashboard and links the Dashboard project to the Editor project. If this is sufficient, you can skip this section altogether.

To create a project on the Unity Gaming Services Dashboard and then link it to your Unity project, follow these instructions:

1. Sign in to your account on the Unity Gaming Services Dashboard.

2. From the Dashboard menu, navigate to the Projects section.

3. Select the + New button.

4. Choose a project name.

You’ll be prompted to specify whether your game or app is primarily targeted at children under the age of 13. This requirement applies in the United States, under the jurisdiction of the Children's Online Privacy Protection Act (COPPA).

5. Answer accordingly and select the Create button.

For more information about COPDashboard_Create_Project_COPPA_U6.pngPA, consult the COPPA web page on the US Federal Trade Commission website.

6. From the Unity Editor’s main menu, select Edit > Project Settings > Services.

Your project will already be attached to a separate Unity project that was created when you created your project in the Unity Hub.

7. Select your Organization from the list.

You can find your Organization Name in the Unity Dashboard under the Projects section.

8. Select the project you previously created in the Dashboard and select the Link Unity project to cloud project button.

Your existing Dashboard project is now linked to your Unity project.

Optionally, you may create a Dashboard project and link it to your Unity project from the Unity Editor. Skip this step if you prefer to use the Dashboard.

To create a Dashboard project and link it your Unity project from the Editor, follow these instructions:

1. From the Unity Editor’s main menu, select Edit > Project Settings > Services.

2. Unlink project from existing project by selecting the Unlink project button.

3. Select your Organization from the list.

You can find your Organization Name in the Unity Dashboard under the Projects section.

4. Under the Choose between using an existing cloud project or creating a new one section, select Create a new cloud project.

5. Select the Create new cloud project and link to Unity Project button.

Your new Dashboard project will be created and linked to your Unity project.

At the bottom you’ll need to specify whether your game or app is primarily targeted at children under the age of 13. This requirement applies in the United States, under the jurisdiction of the Children's Online Privacy Protection Act (COPPA).

6. Answer accordingly and select the Save button.

For more information about COPPA, consult the COPPA web page on the US Federal Trade Commission website.

Now that you’ve linked your Unity project to the Unity Dashboard, you’re ready to configure the user events that you want to capture. In the next tutorial, you’ll learn about standard events, which are built into Unity Analytics, and custom events, which you can define in the Dashboard’s Event Manager and send from your game code to track specific player actions.