Setup
The fastest way to connect is OAuth. Sign in with a Google account that has access to your GA4 properties and Adapt handles the rest.Authorize on Google
Sign in with a Google account that has access to your Google Analytics properties and approve read-only access. Adapt stores the connection and refreshes the token automatically.
analytics.readonly) and shared across your organization. Adapt can read every GA4 property the connected account can access and picks the right property based on your question — there’s no property ID to configure.
Connect with a service account
Prefer to use a service account, or need a connection that isn’t tied to a personal Google login? You can still connect Google Analytics with a service account key.Create a service account
- Go to Google Cloud Console
- Create or select a project
- Enable both of these APIs:
- Go to IAM & Admin > Service Accounts
- Create a new service account
- Download the JSON key file
Grant access in GA4
- Open your Google Analytics property
- Go to Admin > Property Access Management
- Add the service account email as a Viewer
Add the secrets
Add the following secrets:
| Secret Name | Value |
|---|---|
GOOGLE_ANALYTICS_PROPERTY_ID | Your GA4 property ID (e.g., 123456789) |
GOOGLE_ANALYTICS_CREDENTIALS | The full JSON service account key |
Capabilities
Adapt can query your Google Analytics data. Analyze traffic, user behavior, and conversion metrics.