Google Ads is Google's premier online advertising platform that lets advertisers display their advertisements, service offerings, and product listings to prospective customers.

This document guides you in setting up Google Ads as a source in RudderStack. Once configured, RudderStack automatically ingests your specified Google Ads data, which can then be routed to your RudderStack-supported data warehouse destination.

All the Cloud Extract sources support sending data only to a data warehouse destination.

Getting started

To set up Google Ads as a source in RudderStack, follow these steps:

  1. Log into your RudderStack dashboard.
  2. Go to Sources > New source > Cloud Extract and select Google Ads from the list of sources.
  3. Assign a name to your source and click Next.

Connection settings

  • Give RudderStack access to your Google Ads account by clicking on the Sign in with Google button under Google Credentials.
Verifying credentials

If you have already connected RudderStack to your Google Ads account, your credentials will appear automatically under Choose an account.

Then, configure the following settings to set up the source:

Connection settings
  • Customer ID: Enter the 10 digit customer ID associated with your Google Ads account without the dashes.

For more information on obtaining the customer ID, refer to the FAQ section below.

  • Start Date: RudderStack will import all your historical Google Ads data from this date.
  • End Date: RudderStack will import all your Google Ads data till this date.

The Start Date setting is valid only for the first (historical) sync.

  • Login Customer ID for Managed Accounts: This is a required field if you are using a Google Ads manager account to set up the source. Enter your 10 digit manager account customer ID without the dashes.
  • Conversion Window: Enter the Google Ads conversion window duration.
For more information on the conversion windows in Google Ads, refer to the FAQ section below.

Custom GAQL queries

The Custom GAQL Queries option lets you create a custom GAQL query for building a customized Google Ads report. The dashboard settings are described below:

  • Select resource: Select the Google Ads API resource from the dropdown.
  • Select: Select the relevant Attributes, Segments and Metrics from the dropdown.
  • Destination Table Name: Specify the table name in your warehouse destination where the results for the above query will be sent.

As you select the relevant options from the dropdown, you can observe the custom GAQL query displayed in the query box. You can also use the Reset and Edit query buttons to reset or change the query respectively.

Connection settings

The following image shows a sample custom GAQL query:

Connection settings

You can also use the Google Ads Query Builder tool to validate your queries.

RudderStack does not support creating a custom GAQL query for the click_view resource as it requires a filter limiting the results to one day. You can use the clickView predefined stream instead.

Destination settings

The following settings specify how RudderStack sends the data ingested from Google Ads to the connected warehouse destination:

  • Table prefix: RudderStack uses this prefix to create a table in your data warehouse and loads all your Google Ads data into it.
  • Schedule Settings: RudderStack gives you three options to ingest the data from Google Ads:
    • Basic: Runs the syncs at the specified time interval.
    • CRON: Runs the syncs based on the user-defined CRON expression.
    • Manual: You are required to run the syncs manually.

For more information on the schedule types, refer to the Common Settings guide.

Selecting the data to import

Choose the Google Ads data that you wish to ingest via RudderStack. You can either select all the data or choose specific Google Ads attributes as per your requirement.

Selecting the data to import

Google Ads is now configured as a source. RudderStack will start ingesting data from Google Ads as per your specified schedule and frequency.

You can further connect this source to your data warehouse by clicking on Add Destination, as shown:

Adding a destination
Use the Use Existing Destination option if you have an already-configured data warehouse destination in RudderStack. To configure a data warehouse destination from scratch, select the Create New Destination button.


Where can I find my Google Ads customer ID?

You can find your Google Ads customer ID in the top right section of your dashboard, as shown:

Customer ID

What is a conversion window in Google Ads?

A conversion window is defined as the time period after the user interacts with an ad (clicks, video views, etc.) during which a conversion is recorded in Google Ads.

Is it possible to have multiple Cloud Extract sources writing to the same schema?

Yes, it is. RudderStack associates a table prefix for every Cloud Extract source writing to a warehouse schema. This way, multiple Cloud Extract sources can write to the same schema with different prefixes.

Contact us

For more information on the topics covered on this page, email us or start a conversation in our Slack community.