Google Ads
  • 4 Minutes to read
  • Dark

Google Ads

  • Dark

Article Summary

Google Ads is an online advertising platform that enables businesses to create and display ads on Google's search engine and advertising network. It offers a range of ad formats, targeting options, and bidding strategies, allowing businesses to reach their desired audience and drive traffic, leads, and conversions through paid search and display advertising.

All available fields from the Google Ads API are listed in the Google Ads official documentation.

All limitations for API calls are described in Google's documentation on rate limits.

How to Create a New Google Ads Data Source

  1. Under the Sources tab, click on the Create Source button and select the connector from the list.
  2. From the drop-down menu, choose your account.
    Didn't find your account?

    Click on Add new Account at the bottom of the drop-down and follow the on-screen prompts. You can also go to the Authorizers tab and click on Add New Service.

  3. Name your data source and select your metrics and attributes.
  4. [Optional] Configure your advanced settings (for more information please refer to the section on Advanced Settings). If you are unsure about how to proceed, we recommend skipping this step.
  5. Configure your snapshotting preferences. Choose your sync frequency or the exact synchronization time under Show advanced settings.

    If you need to load historical data, please refer to the Manual Data Load page.

  6. Preview your data by clicking on the Test Data button in the top right corner. You can adjust the date range for a more specific time frame.
  7. Click on Save and congratulations, your new data source is ready!

Connector Overview

Google Ads (MCC) Manager Account

Previously known as My Client Centre (MCC), a manager account may be a good option for large advertisers with more than one Google Ads account. It may also work well for third parties such as agencies and other online marketing professionals who manage multiple client accounts or a large number of campaigns. With a single login and dashboard, this online advertising manager can save you time with reporting, access control, and consolidated billing. Link multiple Google Ads accounts, so you can access and manage them online with a single login. Easily make updates across accounts, including changing daily budgets and pausing campaigns. Use labels to organize accounts, create automated rules, set alerts and get email notifications.

Read more information on the official Google website.

Report Types

When selecting the report type, keep in mind that the metrics, attributes, and segments will depend on it.

You can select up to 10 metrics, 10 attributes, and 10 segments per source. There is also a minimum of at least one metric and one attribute.

Please note that not all combinations are possible, for more information, see Google's official documentation.

There are multiple reporting types:

  • Campaign Performance Report
  • Video Performance Report
  • Ad Performance Report
  • Keyboard Performance Report
  • Shopping Performance Report


Data Preview Unavailable

If there is no data preview after clicking on Test Data, there might be a problem with your source configuration. The most common causes are:

  • Date range: Try a smaller date range. You can load the rest of your data afterward through our manual data load function.
  • Invalid metrics, attributes, or breakdowns: You may not have any data for the selected metrics, attributes, or breakdowns.
  • Incompatible combination of metrics, attributes, or breakdowns: The combination you have selected cannot be queried together. Please refer to the service's documentation to view a full list of metrics that can be included in the same source.

Invalid Metrics, Segments, and Attributes Combination

Not all the available metrics, segments, and attributes are compatible and can be combined together. If the chosen combination is not possible, it will result in an error.

Google Ads Query Builder can help you check which combinations of metrics, attributes, and segments are compatible.

Metric and Ad Recall Data Don't Match

The Reach and Recall metrics cannot be summed to get the totals for longer time periods. As these metrics measure the daily unique users who view your ad (= reach) or will remember the ad (=ad recall), it is not possible to get data for a specific time period and/or aggregate the data.

To avoid this, you can

  1. Get daily breakdowns: The daily values will match, but not when summed up over a longer time period.
  2. Extract data weekly or monthly: These weekly/monthly values will match.

Simply create a new source and a new flow with the particular breakdown (for example, a source and a flow with daily breakdowns/synchronizations).

Read more about the metrics, and why the data may not be matching here.

Values in Micros

Google Ads API reports all costs in micros. This means that the values we are getting for fields such as Average Cost, Cost Per Conversion, Average CPC and so on will be 1 000 000 times higher than what you see in the Google Ads UI. To get to the same values, divide the amounts by 1 000 000.

Performance Max Campaigns Missing from Data

If your campaings are of the Performance Max type, please note that the Google API supports campaign level report type or lower. If you are extracting at the ad or ad group levels, your data will be missing.

If you select an AdGroup when querying Performance Max campaigns, no campaigns will be returned.

Related Articles

Now that you have successfully created a data source, see how you can connect your data to a dashboarding app or a data storage.

Sending Data to Dashboarding Apps

Sending Data to Data Storages

Other Resources

Was this article helpful?