Skip to content

Google Analytics 4 Integration ​

Connecting GA4 surfaces website traffic, session, and conversion data in the client's portal.

Prerequisites ​

  • A Google Analytics 4 property
  • The client's GA4 Property ID
  • A Google service account with Viewer access to the property

Connecting for a client ​

  1. Open the client in /admin/clients.
  2. Go to Integrations → Google Analytics 4.
  3. Enter the Property ID (found in GA4 → Admin → Property Settings — it looks like 123456789).
  4. Upload or paste the service account credentials JSON.
  5. Click Test Connection.
  6. Click Save.

What the client sees ​

The client's dashboard and analytics pages show sessions, users, pageviews, and goal completions sourced from their GA4 property.

Service account setup ​

  1. In Google Cloud Console, create a service account for your project.
  2. Download the JSON key file.
  3. In GA4, go to Admin → Property Access Management and add the service account email with Viewer role.

Troubleshooting ​

ErrorLikely cause
Permission deniedService account hasn't been added to the GA4 property
Property not foundProperty ID is incorrect
Invalid credentialsThe JSON key file is malformed or for a different project

Client Portal Help Documentation