Data engineers who plan to integrate Google Analytics 4 data with Customer Data Platform must refer to the following instructions.
Google Analytics 4 integration
To get this integration:
- Allow CDP to access your account.
- Share the Google Property Id:
- New customers: During implementation, provide the Property Id to CDP’s Professional Services team.
- Existing customers: Post implementation, contact Acquia Support to request for any new connector, such as Google Analytics 4.
CDP sets up the integration and starts pulling data from your Google Analytics.
This typically takes 2 days. For information about the data that Acquia can pull from Google Analytics, see this article.
You can view the data in Reports and Metrics applications after the integration is complete.
Data engineers must follow the procedure to upstream Google Analytics 4 data with Customer Data Platform (CDP).
To allow CDP to access your account:
- Log in to your Google Analytics 4 account.
Switch to the required Google Analytics account and select the Google Analytics property from this account.
Ensure that you make a note of the Property Id of the current property.
Click Admin.
Ensure that you have admin access for the property.
Click Property Access Management.
- To add a new user, click the plus icon and select Add Users.
To create Acquia’s Google Analytics user, enter their email address in the Email addresses field.
For all accounts, add
[email protected].Adding the CDP Google Analytics User allows CDP to access the UI for reconciliation.
For CDP-Production, add
google-analytics-4-prod@api-project-522475697524.agilone.com.iam.gserviceaccount.com.Depending on your integration setup needs with CDP, you can authorize a new sandbox user to conduct further Google tests. If you have an active UAT or CS environment provisioned with CDP using Google Analytics, add the user only to your Google Sandbox account.
- For CDP-Sandbox (optional), add
google-analytics-4-cs@api-project-522475697524.agilone.com.iam.gserviceaccount.com.
Assign the Viewer role to the user.
- Click Add.
- Verify that both email addresses are successfully added with the role as Viewer.
- Create a Support ticket and share the current or new Property Id from Step 2, so that Acquia can track the relevant analytics data.
Permission denied error¶
You may encounter the Permission Denied error with the following message:
PERMISSION_DENIED: User does not have sufficient permissions for this property.
The following are the possible solutions to troubleshoot this error:
- Verify the Property Id:
- Ensure that you provide the correct Property Id that matches the intended property you are granting CDP access to.
- Ensure that you share the correct Property Id with CDP.
- User Access Permissions:
- Ensure that Acquia’s Google Analytics user has a Viewer role for the property.
- Check if the Acquia’s Google Analytics user is added to Property Access Management with the necessary permissions.
To resolve the permission denied error:
- Check the Property Id:
- Log in to your Google Analytics 4 account.
- Locate the Property Id associated with the property.
- Compare this Property Id with the Property Id that you have shared with CDP.
- Verify User Access permissions:
- Log in to your Google Analytics 4 account.
- Navigate to the Admin settings.
- Click Property Access Management to see assigned user roles and permissions.
- Ensure that Acquia’s Google Analytics user has a Viewer role for the property.
- Granting Access and Permission:
- Click the appropriate user to modify access and permissions, if required.
- Assign the Viewer role to Acquia’s Google Analytics user, if not already assigned.
- Click Save.
- Retest the Access:
- Share the Property Id with Acquia again.
- Ask the Acquia team to retest the access.
- Test if the Permission Denied error persists for the Acquia’s Google Analytics user.
If the issue persists, contact Acquia Support.