Manually connect Google Analytics to the Developer Data framework
Manually connect your Google Analytics data to the Developer Data framework to resolve connection failures or customize data export settings.
읽는 시간 4분최근 업데이트: 2일 전
If your Google Analytics account doesn't connect to the Unity Dashboard through the guided setup process, then you can manually retry the connection process.
참고
The guided setup process performs the following steps on your behalf. Before you try the manual connection process, refer to Automatically retry an unsuccessful connection.
중요
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).
Determine which manual connection method to follow
Which method you use to manually connect Google Analytics depends on whether you have an existing BigQuery export.
To determine which method to use, follow these steps:
- In Google Analytics, go to Admin (gear icon) > Product links > BigQuery links.
- Under Project ID, identify the destination project:
- If the project ID is , then proceed to Google Analytics setup without an existing BigQuery export.
unity-firebase-bq-links-prd - If any other Google Cloud project ID is displayed, then proceed to Google Analytics setup with an existing BigQuery export.
Google Analytics setup without an existing BigQuery export
Follow this process if you don't have an existing BigQuery export, and BigQuery is linked to the project ID in Google Analytics.
unity-firebase-bq-links-prdBefore you begin, make sure you have the following:
- The Owner or Manager role in the organization that the Unity project belongs to in the Unity Dashboard
- The Administrator role on the Google Analytics property
- The Google Analytics property ID
Grant the service account access to the Google Analytics property
Unity uses a per-property service account to create and manage the BigQuery link.
To give the service account access to the Google Analytics property, follow these steps:
- In Google Analytics, go to Admin (gear icon) > Property > Property access management.
- Select Add access permissions to new users (+ icon).
- Select Add users.
- Enter the service account email address , making sure to replace the placeholder
ga-link-{propertyId}@unity-firebase-bq-links-prd.iam.gserviceaccount.comwith your Google Analytics property ID number. For example,{propertyId}.ga-link-540022283@unity-firebase-bq-links-prd.iam.gserviceaccount.com - Deselect Notify new users by email.
- Under Direct roles and data restrictions, select Editor.
- Select Add.
After you add the service account, the Property access management window displays the service account email address with the Editor role.
Verify the link export settings
To verify the link export settings, follow these steps:
- In Google Analytics, go to Admin (gear icon) > Product links > BigQuery links.
- Select the BigQuery link for your property.
- Turn on the following settings:
- Streaming Export
- Include Advertising ID
- Under Export Streams, confirm that the configured data streams are listed.
- Select Save.
After you verify the link export settings in Google Analytics, you need to verify the connection in the Unity Dashboard.
To verify the connection, follow these steps:
- In the Unity Dashboard, go to Projects > Settings.
- In the Developer Data section, locate Google Analytics (Firebase).
- Select View link.
- In the Auto-fix integration section, select Run auto-fix.
- Select Update Link.
After you save your changes, the Unity Dashboard's link verification displays the message .
Service account has editor role on GA propertyGoogle Analytics setup with an existing BigQuery export
Follow this process if you have an existing BigQuery export linked to a Google Cloud project.
Before you begin, make sure you have the following:
- The Owner or Manager role in the organization that the Unity project belongs to in the Unity Dashboard
- The Google Analytics property ID
- The destination project ID identified in BigQuery links
- One of the following user roles in Google Cloud Console Identity and Access Management (GCP IAM): Owner, BigQuery Admin, or BigQuery Data Owner
Grant the export service account read access to the dataset
Unity uses an export service account to read the property's data from the dataset in your project.
analytics_{propertyId}To grant the service account access to the dataset, follow these steps:
- In Google Cloud Console, select the destination BigQuery project linked in Google Analytics.
- In the Explorer panel, select the dataset . For example,
analytics_{propertyId}.analytics_540022283 - Select Sharing > Permissions.
- Select Add Principal.
- In New principals, enter .
big-query-link-creator@unity-firebase-bq-links-prd.iam.gserviceaccount.com - In the Role dropdown, select BigQuery Data Viewer ().
roles/bigquery.dataViewer - Select Save.
참고
Grant the BigQuery Data Viewer role only on the dataset, not on the whole project. The export needs to read only the dataset.
analytics_{propertyId}After you save your changes, the service account appears under Permissions with the BigQuery Data Viewer role.
Verify the link export settings
To verify the link export settings, follow these steps:
- In Google Analytics, go to Admin (gear icon) > Product links > BigQuery links.
- Select the BigQuery link for your property.
- Turn on Include Advertising ID.
- Under Export Streams, confirm that the configured data streams are listed.
- Select Save.
After you save your changes, the Unity Dashboard's link verification displays the message .
Service account has BigQuery accessThe BigQuery dataset is automatically created by Google Analytics within 24 to 48 hours after linking. To confirm the status of the dataset, check in BigQuery Console under the project ID.
analytics_{propertyId}If Google Analytics isn't connected to the Developer Data framework after you follow both the automatic and manual connection methods, then refer to Troubleshooting your Google Analytics connection to the Developer Data framework.