Upgrade to Google Analytics 4
Agility supports integration with Google Analytics 4 (GA4), the new standard for web analytics that replaces Universal Analytics. This allows you to track how media coverage drives traffic to your website and visualize those insights directly in your Agility reports.
Google recently announced the launch of GA4, which replaces Universal Analytics.
Universal Analytics (GA3) was officially retired on July 1, 2023. To continue using analytics data in Agility, users must migrate to GA4.
We strongly recommend that you follow Google’s step-by-step migration guide to ensure your property is GA4-ready.
If you've previously connected GA3 and still have your service account key file, you can simply activate the Google Analytics Data API and Google Analytics Admin API and proceed directly to connecting your GA4 property.
In this article, we’ll walk through everything you need to connect GA4 to Agility.
🔹 Step-by-Step Guide to Connecting GA4 to Agility
Step 1: Confirm GA4 property access in Google Analytics
In the lower-left corner, click the gear icon (Admin)
Under the Property column, confirm:
You have access to a Google Analytics Account
A GA4 property is present
The Property ID is shown in brackets beside the property name
❗If you don’t see a GA4 property or lack access, contact your Analytics administrator.
Step 2: Enable APIs in the Google Developers Console
Use an existing project or create a new one
Enable the following APIs:
More information:
Step 3: Create a service account and generate a JSON key
In the left-hand menu, click Service Accounts
Click + CREATE SERVICE ACCOUNT
Enter a name (e.g., GA4 Access for Agility) and optional description
Click Create and Continue
Under Select a Role, choose Basic > Viewer
Add your Google email under Service account admins role
Click Done
Then:
Click your newly created service account
Go to the KEYS tab
Click Add Key > Create new key
Choose JSON and click Create
✅ This will download your credentials file.
⚠️ The JSON file can only be downloaded once. If lost, you will need to generate a new one.
More information: Creating and managing service account keys
Step 4: Grant access to the GA4 property
Return to https://analytics.google.com
Click the Admin gear icon
Under the Property column, click Property Access Management
Click the + icon > Add users
Paste in the service account email from your JSON file
Assign the Viewer role
Click Add
⏳ Google may take up to one hour to apply access changes.
More information: Google Analytics user permissions
Step 5: Upload the JSON key to Agility
In Agility, go to Account > Content Management > Data Connections
Click New Data Connection
Upload the JSON key file
Follow the prompts to complete the connection
Once connected, Agility can begin pulling GA4 web analytics into your reporting.
🔹 Use GA4 in Your Agility Reports
Once connected, your GA4 property can be used in Agility reporting dashboards and shareable reports.
➡️ Learn more: Integrate Google Analytics with Agility Reporting
📝 Support & Resources
Need help? Chat with Support from your dashboard