# Troubleshooting your Google Analytics connection to the Developer Data framework

> Solve common issues with connecting your Google Analytics data to the Developer Data framework.

If Google Analytics isn't connected to the Developer Data framework after you follow both the [guided setup](/cloud/developer-data/link-google-analytics.md) and [manual](/cloud/developer-data/link-google-analytics-manual.md) connection methods, then use the following guide to verify your configuration settings.

> **Important:**
>
> The following concerns a product or service (each a “Third Party Product”) that is not developed, owned, or operated by Unity. This information may not be up-to-date or complete, and is provided to you for your information and convenience only. Your access and use of any Third Party Product is governed solely by the terms and conditions of such Third Party Product. Unity makes no express or implied representations or warranties regarding such Third Party Products, and will not be responsible or liable, directly or indirectly, for any actual or alleged damage or loss arising from your use thereof (including damage or loss arising from any content, advertising, products or other materials on or available from the provider of any Third Party Products).

## Permission denied errors

This issue occurs when you try to add the service account in Google Analytics or Google Cloud Console.

This issue has the following possible causes:

* [The user account is missing required permissions in Google Analytics](#the-user-account-is-missing-required-permissions-in-google-analytics).
* [The user account is missing required permissions on the destination project](#the-user-account-is-missing-required-permissions-on-the-destination-project).

### The user account is missing required permissions in Google Analytics

1. **Cause**

   Permission is denied because your user account is missing one or more required permissions in Google Analytics.

2. **Resolution**

   To verify your account permissions in Google Analytics, follow these steps:

   1. Go to [Google Analytics](https://analytics.google.com/).
   2. Follow the instructions in [Add, edit, and delete Analytics users and user groups](https://support.google.com/analytics/answer/9305788?hl=en#Add) to view and edit your user role.
   3. Confirm that your user account has the **Administrator** role.

   If you don't have the necessary permissions and can't update them yourself, then contact a member of your team who can assign you the correct role.

### The user account is missing required permissions on the destination project

1. **Cause**

   Permission is denied because your user account is missing edit dataset access permissions on the destination project.

2. **Resolution**

   To verify your account permissions in Google Console, follow these steps:

   1. Go to [Google Cloud Console](http://console.cloud.google.com/bigquery).
   2. Select the destination BigQuery project with the project ID `unity-firebase-bq-links-prd`.
   3. Go to **IAM & Admin** > **IAM**.
   4. Confirm that your account has a role with `bigquery.datasets.update` permissions to edit dataset access. Roles with these permissions include Owner, BigQuery Admin, and BigQuery Data Owner.

   If you don't have the necessary permissions and can't update them yourself, then contact a member of your team who can assign you the correct role.

## Link settings don't save in Google Analytics

This issue occurs when you can't update your link settings in Google Analytics.

### Google Analytics settings are incorrectly configured

1. **Cause**

   Link settings don't save because your account settings are incorrectly configured in Google Analytics.

2. **Resolution**

   To resolve this issue, check the following in [Google Analytics](https://analytics.google.com/analytics/web/#/a/accounts):

   * Confirm that you have the Editor or Administrator role on the Google Analytics account.
   * Go to **Admin** > **Property Access Management** and confirm that the service account `ga-link-{propertyId}@unity-firebase-bq-links-prd.iam.gserviceaccount.com` appears with the **Editor** role.
   * Ensure the link exists and is not in a deleted state.

## No data appears after setup

This issue occurs when no data is displayed in the Dashboard after completing setup.

This issue has the following possible causes:

* [A different destination project is selected](#a-different-destination-project-or-dataset-name-is-selected).
* [The link export settings are incorrectly configured in Google Analytics](#the-link-export-settings-are-incorrectly-configured).
* [The linked property has no events to export](#the-linked-property-has-no-events-to-export).

### A different destination project or dataset name is selected

1. **Cause**

   No data is displayed because a different destination project is selected, or the dataset name doesn't use the property ID number.

2. **Resolution**

   To resolve this issue, confirm the following:

   * You are in the correct destination project.
   * The dataset name uses the Google Analytics property ID number, not the alphanumeric name.

### The link export settings are incorrectly configured

1. **Cause**

   The link export settings are incorrectly configured in Google Analytics.

2. **Resolution**

   To verify the link export settings, follow these steps:

   1. In [Google Analytics](https://analytics.google.com), go to **Admin** (gear icon) > **Product links** > **BigQuery links**.
   2. Select the BigQuery link for your property.
   3. Confirm that the following settings are turned on:

   * **Streaming Export**
   * **Include Advertising ID**

   4. Under **Export Streams**, confirm that the configured data streams are listed.

### The linked property has no events to export

1. **Cause**

   It can take up to 24 to 48 hours for Google Analytics to create a dataset after linking.

2. **Resolution**

   To verify the link export settings, follow these steps:

   1. In [Google Analytics](https://analytics.google.com), go to **Admin** (gear icon) > **Product links** > **BigQuery links**.
   2. Select the BigQuery link for your property.
   3. Confirm that the following settings are turned on:

   * **Streaming Export**
   * **Include Advertising ID**

   4. Under **Export Streams**, confirm that the configured data streams are listed.

## Verification fails after configuring the export service account

This issue occurs at the verification step after you grant the export service account read access to the dataset in Google Cloud Console.

1. **Cause**

   One or more settings are incorrectly configured during setup.

2. **Resolution**

   To verify the link export settings, confirm the following in [Google Cloud Console](http://console.cloud.google.com/bigquery):

   * The grant is on only the dataset and not the project IAM.
   * The principal is an exact match to the export service account email address.
   * The destination project named on the link is entered correctly.

## Additional resources

For additional troubleshooting information, refer to the following third-party resources:

* [Google Analytics Admin API - BigQuery Links](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.bigQueryLinks) (Google)
* [BigQuery IAM Roles](https://cloud.google.com/bigquery/docs/access-control) (Google)
* [Google Analytics Account Access Management](https://support.google.com/analytics/answer/9305587) (Google)
