Google Ads connector installation guide

This guide explains how to connect your Google Ads account to Windsor.ai, including prerequisites, required permissions, setup steps, supported data levels, troubleshooting tips, and support options.

Before connecting Google Ads to Windsor.ai, ensure you have:

• A Google account
• Access to at least one Google Ads account or a Google Ads Manager/MCC account
• A Windsor.ai account (https://onboard.windsor.ai/) 

To connect Google Ads to Windsor.ai, you need:

• A Google Ads account or Google Ads Manager (MCC) account
• Read-only or higher access level to the Google Ads account(s) you want to sync

Read-only access is sufficient because Windsor.ai is a read-only ETL connector. It does not create, edit, or manage campaigns.

Learn how to grant access to a Google Ads account or manage user access.

❗ Note: Google Ads connections use Google OAuth with read-only scopes. Login credentials are never shared with or stored by Windsor.ai, and access can be revoked at any time from 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 Ads 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 Google Ads account(s).

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

6. After successfully connecting, all the available Google Ads 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 Google Ads data and select a destination. Windsor.ai will begin syncing data automatically.

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

• Account level
• Campaign level
• Ad group level
• Ad level
• Keyword level
• Other segment-level dimensions (e.g., device, network, geography, date)

📋 Windsor.ai supports a comprehensive Google Ads schema with 430+ metrics and 1,905+ dimensions. The full list of supported fields is available in the Google Ads Field Reference.

If your Google Ads account does not appear, newly added accounts are missing, or data stops syncing, this is usually due to access being granted after the initial connection.

Google evaluates permissions at the time of authorization. If access changes later, the connector must be reauthorized.

To resolve this:

• Disconnect the Google Ads connector in Windsor.ai (just unselect all accounts) 
• Reconnect and reauthorize the connector
• Confirm the connected Google account has access to the required ad account(s)

For manager (MCC) accounts: If you are connecting via a manager account, ensure the manager has been explicitly granted access to the client accounts. Re-granting access and reconnecting typically resolves visibility issues.

If you encounter issues while connecting or using the Google Ads 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 Ads Support for account access, billing, or policy-related issues.

Last updated: 2025-12-16