Google Analytics 4 (GA4) connector installation guide

This guide explains how to connect Google Analytics 4 (GA4) to Windsor.ai, including prerequisites, required permissions, authorization behavior, setup steps, supported data, troubleshooting tips, and support options.

Before connecting GA4 to Windsor.ai, ensure you have:

• A Google account with access to at least one GA4 property
• A Windsor.ai account (https://onboard.windsor.ai/)

To connect Google Analytics 4 to Windsor.ai, you need a Google Account with at least:

• Viewer or higher access on the GA4 property

Viewer access is sufficient because Windsor.ai is a read-only ETL connector. It does not modify GA4 configuration or data.

GA4 permissions are hierarchical and inherited by default:

• Permissions granted at the Account level apply to all properties under that account
• Permissions granted at the Property level apply only to that property
• A user’s effective permission is the most permissive role they have for that resource

For example:

• If a user has Editor access at the account level, they automatically have Editor access to all properties in that account.
• If the same user is assigned Viewer access on a specific property, the Editor role still applies.

As long as your Google account has Viewer or higher access at the property level directly or via inheritance, Windsor.ai can retrieve your GA4 data.

Learn more about access management in Google Analytics 4.

❗ Note: Windsor.ai connects via Google OAuth with read-only analytics scopes. Your Google login credentials are not shared with or stored by Windsor.ai and no changes can be made to your GA4 data. You can revoke access anytime in your Google Account settings.

1. Log in to your Windsor.ai account.

2. Navigate to the Data Sources search in the left-hand bar.

3. Find Google Analytics 4 (https://onboard.windsor.ai/app/googleanalytics4) in the list.

4. Click the “Sign in with Google” button. You will be redirected to Google’s authorization screen. Log in with a Google account that has access to the required GA4 account(s).

5. Review the requested permissions and click “Allow.”

6. After successfully connecting, all the available Google Analytics 4 accounts will appear in your windsor.ai dashboard. You can choose one or more (even all) ad accounts to pull data from.

7. Preview your GA4 data and select a destination. Windsor.ai will begin syncing data automatically.

The Windsor.ai GA4 connector pulls data at these reporting levels:

• Property level
• Event level
• User level
• Session level
• Page/screen level
• Traffic source dimensions (source, medium, campaign)
• Geographic dimensions (country, region, city)
• Device dimensions (device category, OS, browser)
• Time dimensions (date, week, month)

📋 Windsor.ai supports a comprehensive Google Analytics 4 schema with 90+ metrics and 385+ dimensions. The full list of supported fields is available in the Google Analytics 4 Field Reference.

If your GA4 properties do not appear, newly added properties are missing, or data stops syncing, this is usually caused by permission changes after the initial connection.

Google evaluates GA4 access at the time of authorization. If permissions are added or modified later, the connector must be reauthorized.

To resolve this:

• Disconnect the GA4 connector in Windsor.ai (just unselect all accounts)
• Reconnect and reauthorize the connector
• Confirm the Google account has Viewer or higher access to the GA4 property (directly or via inherited account-level access)

If you encounter issues while connecting or using the Google Analytics 4 connector in Windsor.ai:

• Frequently asked support questions and troubleshooting guides can be found here.
• Contact Windsor.ai Support for connector setup, authorization, or data synchronization issues.
• Contact Google Analytics Support for GA4 property access or configuration issues.

Last updated: 2025-12-16