Google Ads: Setup guide

This guide explains how to collect data from Google Ads.

Prerequisites

Before you start collecting data from Google Ads, perform all of the following actions:

• Ensure that the account you use to connect to Google Ads has Read only or higher permissions. For more information, see the Google Ads documentation.

• To collect invoice data, activate monthly invoicing in your Google Ads account. For more information, see the Google documentation.

Creating a datastream to collect data from Google Ads

The basics of creating a datastream to collect data from any data source are explained in our guide to Collecting data in Adverity. This guide contains information about the specific steps to create a datastream to fetch data from Google Ads.

Authorization: Allow Adverity to access Google Ads

1. If you choose Access using your credentials or Access using someone else’s credentials, in Set up or edit Customers, you or the person granting access must choose one of the following options:

   • Choose Grant access to all items, including those created in the future to give Adverity Customers to access all existing items and all items created in the future.

   • Choose Select specific items to which you want to grant access to only give Adverity Customers to access the selected items. Adverity will not automatically have access to items created in the future. You will need to grant Adverity access to any items created in the future.

   Warning

   If you use your credentials to grant Adverity access to Google Ads, all the items available to you using your credentials will be visible in the Authorizations page to all Adverity users with permission to edit this authorization.

   If someone else uses their credentials to grant Adverity access to Google Ads, the same applies to the items available using their credentials.

   This is important to consider if you do not want all Adverity users with permission to edit the authorization to be able to see the details of the authorization items. For more information about user permissions, see Managing user permissions.

Configuration: Choose the data you want to collect from Google Ads

Note

This connector reports data in the timezone of the authorized customer account.

To choose what data to collect and customize the Google Ads datastream configuration, follow these steps:

1. (Optional) Rename your datastream.

2. In MCCs, Customers, and Campaigns, select the My Client Centers accounts (MCCs), customers, and campaigns for which to collect data. If you do not select any items in a drop-down list, Adverity collects data for all items in the drop-down list.

3. In Report type, select the type of data to collect from Google Ads. The selected report type determines the additional fields to populate.

4. In Resource level, select a level in the hierarchy of Google Ads resources. Adverity generates a report for this level. For more information, see the Google documentation.

5. In Segments, select the categories that Adverity uses to divide and group your data. You can only select one of the following date segments: Day, Week, Month, Quarter. The selected date segment determines the date range you can choose later when you fetch data. For more information, see Selecting the date range for a fetch.

6. In Metrics and Attributes, change the list of fields that you want to see in your data extract.

   Note

   Google Ads considers some metrics to be attributes. If you cannot see a specific metric in the Metrics drop-down list, look in the Attributes drop-down list.

7. In Billing Setups, select the billing setups for which to collect data. If you do not select any billing setups in a drop-down list, Adverity collects data for all items in the drop-down list.

   This field is visible if you select Invoice in Report type. The items selected in the MCCs and Customers fields determine which billing setups you can select.

8. In Recommendation fields, change the list of fields that you want to see in your data extract.

   This field is visible if you select Recommendation in Report type.

Tip

To write custom Google Ads queries, select GAQL in Report type and enter your query in the GAQL field. For more information, see Google Ads tips: Using GAQL queries.

What’s next?

• Apply Data Mapping to your collected data to harmonize data collected from different sources in Adverity.

• Transform your data to meet your needs by creating and applying transformations to your datastream.

• Load your data into Explore & Present to visualize your data in Adverity.

• Load your data into an external destination of your choice.