--- title: "Google Ads" slug: "google-ads" description: "Automate Google Ads data sync via Dataddo's connector. Create a Google Ads source, set snapshotting preferences, troubleshoot errors, understand limits&fields." updated: 2025-03-13T11:34:00Z published: 2025-03-13T11:34:00Z --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.dataddo.com/llms.txt > Use this file to discover all available pages before exploring further. # Google Ads **Google Ads**, previously **My Client Centre (MCC)**, 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. Refer to Google's official documentation to see [all available endpoints from the Google Ads API](https://developers.google.com/google-ads/api/rest/reference/rest). If you have multiple Google Ads accounts and would like to extract the same data from all of them, it's possible through [multi-account extraction](/docs/multi-account-extraction). Contact our Solutions team to enable this feature. ## Authorize Connection to Google Ads To authorize this service, use **OAuth 2.0** to share specific data with Dataddo while keeping usernames, passwords, and other information private. 1. On the **Authorizers** page, click on [Authorize New Service](https://app.dataddo.com/service/new) and select your service. 2. Follow the on-screen prompts to grant Dataddo the necessary permissions to **access and retrieve** your data. 3. **[Optional]** Once your ***authorizer*** is created, click on it to **change the label** for easier identification. Ensure that the account you're granting access to holds at least **admin-level permissions**. If necessary, assign a team member with the required permissions with the [authorizer role](https://docs.dataddo.com/docs/user-roles#authorizer) to authenticate the service for you. For more information, see our article on [***authorizers***](https://docs.dataddo.com/docs/authorized-services). ### Authorization Using a Service Account Google APIs also allow authorizing access to Google accounts using **Service Accounts** (aka an account that belongs to your app instead of an individual user). #### In Google Cloud Console To create a Service Account, follow these steps: 1. In your Google Cloud Console, select your project and navigate to the **API & Services** section. 2. Go to [**Credentials**](https://console.cloud.google.com/apis/credentials) and click on **+ CREATE CREDENTIALS** at the top of the page. 3. Select **Service account** and follow the on-screen prompts to create a new service account. 4. Assign a role to the service account (such as `viewer` or `editor`, depending on your needs). 5. Click on **Done** to create the service account. 6. You should be able to see your newly created service account at the bottom on the site. Click on **Edit service account** and navigate to the **Keys** tab at the top. 7. Click **Add key** and select **Create new key**. 8. Choose **JSON** as key type. This will download the JSON file to your computer which you will later need to upload to Dataddo. #### In Dataddo 1. On the [Security](https://app.dataddo.com/settings/security) page, navigate to the **Certificates** tab and click on **Add Certificate**. 2. Name your certificate, select **Google Service Account Key** as certificate type, and upload the file you have obtained when creating a service account for authorization. 3. On the [Authorizers](https://app.dataddo.com/authorizers) page, click on **Authorize New Service** and select your service with `(Service account)` in the name. 4. Select the newly added certificate. 5. Click on **Save**. ## How to Create a Google Ads Data Source 1. On the **Sources** page, click on the [**Create Source**](https://app.dataddo.com/sources/new) button. 2. Select the connector from the list and name your ***data source***. 3. On the **Dataset** step, select your **dataset**. **DATADDO TIP** If you're unsure which dataset to select, use the search bar to look for datasets with the desired attributes or metrics. 4. On the **Account** step select your ***authorizer*** from the drop-down menu. **Didn't find your authorizer?** 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**](https://app.dataddo.com/service/new). 5. On the **Attributes and Metrics** step, select the **metrics and attributes** you want to extract. ![Create a source using a custom-schema connector.](https://cdn.document360.io/084ed225-3f99-4644-a2da-39ca0cd5ef45/Images/Documentation/Create%20Source%20-%20Custom-Schema%20Connector.png) 6. On the **Metadata** step, select which [**metadata fields**](/docs/metadata-inclusion) such as extraction time to add to your data. 7. On the **Snapshot** step: 1. Configure your [**sync frequency**](/docs/extraction#extraction-frequency) or click **Show advanced settings** to set the exact synchronization time. **DATADDO TIP** If you need to **load historical data**, refer to the [**Data Backfilling**](https://docs.dataddo.com/docs/data-backfilling) article. 2. [Optional] Enable the **Allow Empty Data Extractions** toggle to allow the extraction when no data is available. 8. In the top-right corner, click **Test Data** button to preview extracted data. You can **adjust the date range** for a specific time frame. 9. Click on **Save** and **congratulations, your new data source is ready!** --- ## Limitations ### API Calls Rate Limits Refer to Google's official documentation to see [all API calls rate limits](https://developers.google.com/google-ads/api/docs/best-practices/rate-limits?hl=en). ### Limitations Based on Report Type Metrics, attributes, and segments all depend on the **selected report type**. The available report types are: - Campaign Performance Report - Video Performance Report - Ad Performance Report - Keyboard Performance Report - Shopping Performance Report When creating a ***data source***, there's a minimum of metrics and attributes you need to select: - **Minimum**: 1 metric, 1 attribute per source Please note that **not all metrics and attributes combinations are possible**, for more information, see [this section on troubleshooting](/docs/google-ads#invalid-metrics-segments-and-attributes-combination). --- ## Troubleshooting ### Data Preview Unavailable No data preview when you click on **Test Data** might be caused by an issue 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 using [manual data load](https://docs.dataddo.com/docs/data-backfilling). - **Insufficient permissions**: Please make sure your authorized account has at least admin-level permissions. - **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**: Your selected combination 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 ***data 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.** Use [Google Ads Query Builder](https://developers.google.com/google-ads/api/fields/v10/campaign_query_builder) to check which combinations of metrics, attributes, and segments are compatible. [Embedded content](https://www.youtube.com/embed/ZvPcYBEhGIc) ### 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](https://blog.dataddo.com/why-the-numbers-in-your-bi-tool-dont-always-match-your-source-data?_gl=1*ipsbl8*_ga*MjAwMjE2NTU4NC4xNjUxNzM0NTI4*_ga_NQ4TN4KP4V*MTY1MTc2NzQwMC40LjEuMTY1MTc2Nzg4OS4z). ### Missing Performance Max Campaigns For `PERFORMACE_MAX` campaings, the Google API supports only the **Campaign level** report type. This means that if you are extracting data at the **Ad** or **AdGroup** levels, your `PERFORMACE_MAX` data **will be missing** and won't return any campaigns. ### Values in Micros The 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` etc. will be 1,000,000 times higher than what you see in the Google Ads UI. In other words, to get to the same values in your ***data destination***, **divide the numbers by 1,000,000**. ## 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** - [Simple Data Integration to Dashboards](https://docs.dataddo.com/docs/simple-data-integration-to-dashboards) - [Data Backfilling to Dashboarding Apps](https://docs.dataddo.com/docs/data-backfilling-to-dashboarding-apps) **Sending Data to Data Storages** - [Batch Ingestion to Data Warehouses](https://docs.dataddo.com/docs/ingestion-to-data-warehouses) - [Data Backfilling to Storages](https://docs.dataddo.com/docs/data-backfilling-to-storages) **Other Resources** - [Troubleshooting](https://docs.dataddo.com/docs/troubleshooting) - [Extraction Logs](https://docs.dataddo.com/docs/extraction-logs) - [Data Duplication](https://docs.dataddo.com/docs/data-duplication) Multi-account extraction (MAE) enables simultaneous data extraction from multiple e.g. Facebook accounts within a single source setup. This ensures consistent configuration of your data sources across all accounts. Authorizers act as credentials for external services (e.g. Facebook or Google). To enable Dataddo to access and retrieve your data, you need to grant access to accounts that possess admin-level permissions or higher within these services. A source is a collection of data from an authorized service that's been connected via a Dataddo connector. Data within the source is automatically refreshed based on the source's configuration. A destination is the endpoint where the data from your sources will be loaded. Destinations include dashboarding tools, data warehouses, and other online services.