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

Error	Likely cause
Permission denied	Service account hasn't been added to the GA4 property
Property not found	Property ID is incorrect
Invalid credentials	The JSON key file is malformed or for a different project