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

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.

Need assistance?

Feel free to contact us and we will help you with the setup. To speed the process of resolving your issue, make sure you provide us with sufficient information.

Was this article helpful?