Collecting data from Google Ads Keyword Planner

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

Introduction

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

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

Understanding datastreams and authorizations

When you connect to Google Ads Keyword Planner 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 Keyword Planner, perform all of the following actions:

  • Ensure you have access to a Google Ads account.

  • Find the site URLs and keywords on which you want to collect data.

  • Alternatively, create a value table that contains the site URLs or keywords. For more information on how to create a value table, see Creating value tables.

Creating a datastream using Google Ads Keyword Planner

Connecting to Google Ads Keyword Planner

To connect to Google Ads Keyword Planner, 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 Keyword Planner.

  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 Keyword Planner, choose an existing authorization.

  1. Click Next.

Choosing what data to collect

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

  1. Click Custom configuration.

  1. Click Next.

  1. (Optional) Rename your datastream.

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

  1. In Customers, select the customers 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 Sites URLs, select one of the following options:

    Value Table

    Choose this option to select a value table that contains the site URLs for the sites on which you want to collect data. In Sites value table, select the value table that contains the site URLs.

    Type In

    Choose this option to enter the site URLs for the sites on which you want to collect data. In Type In, enter the site URLs, separated by commas.

  2. In Keywords, select one of the following options:

    Value Table

    Choose this option to select a value table that contains the keywords on which you want to collect data. In Keywords value table, select the value table that contains the keywords.

    Type In

    Choose this option to enter the keywords on which you want to collect data. In Type In, enter the keywords, separated by commas.

  1. In Plan Network, choose to collect keywords data for either Google Search or Google Search and Partners.

  2. In Match Type, select how close the keyword needs to match the user's query for data to be collected. For more information about the match types, see the Google documentation.

  3. In Language, select the language on which you want to collect data.

  4. In Locations, select the locations on which you want to collect data.

  5. In Max CPC, enter the maximum cost per click.

  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 Keyword Planner

The fetch collects data from Google Ads Keyword Planner 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 Keyword Planner, harmonize your data so that it conforms with Adverity's unified naming and formatting conventions.