Google Ads Walkthrough
  • 3 Minutes to read
  • Dark
  • PDF

Google Ads Walkthrough

  • Dark
  • PDF

Article Summary

Google Ads API version 12 is currently supported.

This guide will show you how to get the data from Google Ads into Rivery.


The Google Ads source in Rivery uses the Google Ads Query Language which can query the Google Ads API.

Google Ads source can be executed in one of the following options:


Create a Report


Accounts : clicking the 'Accounts' input will show up a list of all the accessible customers that you permissions to pull data in your Google Ads account. You may select one or more accounts, or leave empty to pull data for all accounts.

Resource : Select a report from the list of reports.
For more information on the available reports and their attributes and metrics click here.
For Migrating reports from Google Adwords click here

Fields : Select fields for the selected report. Please note that selecting some fields may disable other fields that cannot be selected together.

Filters:* Data is filtered by the selected filters. To add filters, click on the 'add filters' button, and select a filter name, operator and value for each filter. You may add the same filter more than once, with different values and operators if necessary.

  • Selecting 'IN' or 'NOT IN' operators enables inserting multiple values in 'Filter Value' field.
  • Selecting 'date' type segments fields in 'Fields' requires adding filters for these fields.


Extract Method: Selecting ' All ' if the report should not be incremental or if there is no segment field with 'date' type in the selected fields.

Selecting the ' Incremental ' method requires selecting an incremental field and selecting the time period to run on.

Please note that only reports that have 'date' type fields can be incrementally extracted.

Query's Time Period for incremental extract

Select the time period of the report:


All the reports support two kinds of the time period:

  1. Date Range -

    • Pulls data in the date range between the start and end date provided, including the end date.
    • You must select a start date.
    • Leaving the end date empty will pull data according to the current time of the river's run.
    • Select a timezone offset to send dates considering the offset.
    • Use the "Last Days Back For Each Run" to expend the start date and pull data a given number of days back before the chosen start date.
  2. Predefined date - A date range defined by Rivery:

    • Day - Yesterday.
    • Week (From Monday to Sunday) - Week to date, Previous week, Previous week to date.
    • Month - Month to date, Previous month, Previous month to date.
    • Year - Year to date.
  3. The Start Date won't be advanced if a River run is unsuccessful.
    If you don't want this default setting, click More Options and check the box to advance the start date even if the River run is unsuccessful (Not recommended).

Interval Chunks

Rivery can run over the increment using chunks, in order to make the loading more efficient and more precise. Your options are:

  1. Don't Split - Rivery will pull the data from the chosen start date to the end date in one bulk.

  2. Daily - The run will be chunked daily from the start to the end date.

  3. Monthly - The run will be chunked monthly from the start to the end date.

  4. Yearly (Less Recommended) - The run will be chunked yearly from the start to the end date.

Running a Custom Query

Running a custom query enables you to run a query that was generated in the interactive Google Ads Query Builder .

Please note that running a custom query can not be incremental as in the 'report' option in Rivery.


Activity Logs

The Activity Logs offer an inside perspective of the processes taking place in Google Ads river.

The Difference Between Clicks and Sessions

Some rows in Google Ads reports have no session data.
A common reason for missing data is that you've linked a Google Ads account to a view for which some traffic has been filtered out. For example, if traffic to a specific landing page has been filtered out of a view, you still see the Google Ads information for those destination URLs, but you don't see basic metrics like Sessions and Bounce Rate.
Click to learn more about the distinctions between a Click and a Session.

Google Adwords Reports Migration

When comparing the AdWords API to Google Ads API, there have been a few changes to field and report names.
Start your report migration planning by consulting the appropriate field mapping tables.

You may encounter data output constraints while migrating from Adwords API to Google Ads API, depending on the fields selected inside the river. Click to learn more.

Was this article helpful?