Skip to main content

Connect Google Analytics 4 (GA4) to Your Agility Account

Integrate web traffic insights into your PR measurement

Updated this week

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

  1. Go to https://analytics.google.com

  2. In the lower-left corner, click the gear icon (Admin)

  3. 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

  1. Visit https://console.developers.google.com

  2. Use an existing project or create a new one

  3. Enable the following APIs:

More information:

Step 3: Create a service account and generate a JSON key

  1. Go to https://console.cloud.google.com/iam-admin

  2. In the left-hand menu, click Service Accounts

  3. Click + CREATE SERVICE ACCOUNT

  4. Enter a name (e.g., GA4 Access for Agility) and optional description

  5. Click Create and Continue

  6. Under Select a Role, choose Basic > Viewer

  7. Add your Google email under Service account admins role

  8. Click Done

Then:

  1. Click your newly created service account

  2. Go to the KEYS tab

  3. Click Add Key > Create new key

  4. 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

  1. Return to https://analytics.google.com

  2. Click the Admin gear icon

  3. Under the Property column, click Property Access Management

  4. Click the + icon > Add users

  5. Paste in the service account email from your JSON file

  6. Assign the Viewer role

  7. 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

  1. In Agility, go to Account > Content Management > Data Connections

  2. Click New Data Connection

  3. Upload the JSON key file

  4. 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

Did this answer your question?