Collecting data from Google Ads

Follow this guide to collect data from Google Ads and preview the data.

Introduction

This guide explains how to collect data from Google Ads and preview the data.

The Google Ads connector is an improved solution to the Google Ads (Deprecated) connector. If you use the Google Ads (Deprecated) connector instead of Google Ads, consider upgrading to the new connector described in this guide. For more information, see the Google documentation.

This guide does not cover the whole functionality of the Google Ads connector. For more information on all features of the Google Ads connector, see Google Ads connector reference.

For more information on the data fields that you can collect from Google Ads, see List of supported fields.

Understanding datastreams and authorizations

When you connect to Google Ads through Adverity, you authorize Adverity to access your account. Adverity stores this authorization information in an authorization, and stores the data collection configuration in a datastream.

You can create several datastreams using the same authorization. The datastreams collect information from the same source, with the same login credentials, with different configurations.

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 using Google Ads

Connecting to Google Ads

To connect to Google Ads, follow these steps:

  1. Select the workspace you work with in Adverity and then, in the platform navigation menu, click Datastreams.

  2. In the top right corner, click + Create datastream.

  3. Search for and click Google Ads.

  4. Choose one of the following options:

    • Click Setup a new authorization and set up the new authorization with your own login credentials.

    • Click Send an access request to ask someone else to set up the new authorization. In the Email field, enter the email address of the person you want to ask to authorize the new authorization.

    • If you already have an authorization to Google Ads, choose an existing authorization.

  1. Click Next.

  1. In Set up or edit Customers, choose one of the following options:

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

    • Choose Select specific Customers to which you want to grant access to determine the specific Customers that you want Adverity to access. Adverity will not automatically have access to Customers created in the future. You will need to grant Adverity access to Customers created in the future.

  1. Click Next.

Choosing what data to collect

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

  1. Click Custom configuration.

  1. Click Next.

  1. (Optional) Rename your datastream.

  1. 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.

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

  1. 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.

  2. 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.

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

  1. 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.

  1. Click Next.

Choosing where to transfer your data

To choose where to transfer your data, follow these steps:

  1. To assign destinations to your datastream, select their checkboxes. For more information on destinations and their configuration settings, see Introduction to transferring data.

  1. Click Next.

Collecting initial data

To collect the initial data, follow these steps:

  1. Choose the time period for which data is collected.

  1. Click Run fetch.

Previewing data collected from Google Ads

The fetch collects data from Google Ads which takes some time. The Overview page of the newly created datastream is now displayed. To preview the collected data, follow these steps:

  1. In the All tasks tab, find the task at the top of the list, and click Show extracts.

  2. Click the top hyperlink.

  3. The data extract is displayed in a table containing the data that you have fetched.

What’s next?

After collecting data from Google Ads, harmonize your data so that it conforms with Adverity's unified naming and formatting conventions.