Skip to main content

Intro

Google Ads, formerly Google Adwords, is an online advertising service where advertisers pay to display brief ads to web users. Use the Google Ads connector to retrieve performance reports about your accounts, ads, campaigns, budgets, and many more for the specified manager account. For more information about the Ads API, see https://developers.google.com/google-ads/api/docs/start. This topic discusses the fields and menus that are specific to the Google Ads OAuth connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in Adding a DataSet Using a Data Connector.

Prerequisites

To connect to your Google Ads data using this connector, you must have the following:
  • The ID of the manager account you want to retrieve data for.
  • Your Google credentials (email address and password).

Connecting to Your Google Ads Account

This section enumerates the options in the Credentials and Details panes in the Google Ads Connector page. The components of the other panes in this page, Scheduling and Name & Describe Your DataSet, are universal across most connector types and are discussed in greater length in Adding a DataSet Using a Data Connector.

Credentials Pane

This pane contains fields for entering credentials to connect to your Google Ads account. The following table describes what is needed for each field:

Field

Description

Manager Account Customer ID Enter the client customer ID of the manager account you want to retrieve data.
The client customer ID is the account number of the Google Ads client account you want to manage with the Ads API, usually in the form 123-456-7890.
UI_Customer_ID.png
Once you have entered a valid Manager Account Customer ID, click Connect (or select Add Account if you have existing Google Ads accounts in Domo) to open the Google OAuth screen where you can select the account you want to connect to. After selecting an account, specify the password for that account. After you have entered a valid password, you can use the same account in Domo any time you create a Google Ads DataSet. For more information about this tab, see Managing User Accounts for Connectors.

Details Pane

This pane contains a primary Reports menu, along with various other menus which may or may not appear depending on the report type you select.

Menu

Description

Report

Select the Google Ads report you want to run. The following reports are available:

S.No Report Name Description
1 Ad Returns Ad details.
2 Ad Group Returns Ad group details.
3 Ad Group Audience View Returns Ad group audience view details. Includes performance data from interests and remarketing lists for Display Network and YouTube Network ads, and remarketing lists for search ads (RLSA), aggregated at the audience level.
4 Age Range View Returns age range view details.
5 Bidding Strategy Returns bidding strategy details.
6 Call View A call view that includes data for call tracking of call-only ads or call extensions.
7 Campaign Returns campaign details.
8 Campaign Audience View Returns campaign audience view details. Includes performance data from interests and remarketing lists for Display Network and YouTube Network ads, and remarketing lists for search ads (RLSA), aggregated by campaign and audience criterion. This view only includes audiences attached at the campaign level.
9 Campaign Budget Returns campaign budget details. A campaign budget shared amongst various budget recommendation types.
10 Conversion Action Returns conversion action details.
11 Customer Client Link Represents customer client link relationship.
12 Customer Returns customer details.
13 Dynamic Search Ads Search Term View Returns dynamic search ads search term view details.
14 Geographic View Returns geographic view details. Geographic View includes all metrics aggregated at the country level, one row per country. It reports metrics at either actual physical location of the user or an area of interest. If other segment fields are used, you may get more than one row per country.
15 Gender View Returns gender view details.
16 Keyword view Returns keyword view details.
17 Landing Page View A landing page view with metrics aggregated at the unexpanded final URL level.
18 Managed Placement View Returns managed placement view details.
19 Product Group View Returns product group view details.
20 Search Term View Returns search term view details. A search term view with metrics aggregated by search term at the ad group level.
21 Shopping Performance View Returns shopping performance view details. Provides Shopping campaign statistics aggregated at several product dimension levels. Product dimension values from Merchant Center such as brand, category, custom attributes, product condition and product type will reflect the state of each dimension as of the date and time when the corresponding event was recorded.
Customer Selection Specify whether you want to retrieve data for specific clients or all clients available for the mentioned manager account.
Customer IDs Enter a comma-separated list of the Customer ID you want to retrieve data for. Customer IDs must be for your Google Ads advertiser accounts not for a manager account.
Metrics Select the metrics you want to retrieve.
Segments Select the segments to breakdown the data.
Attributes Select the attributes.
Date Type Specify whether you want to retrieve the data for a specific date or a date range.
Single Date Select whether the report data is for a specific date or for a relative number of days back from today.
Specific Date Select the specific date using the date selector.
Relative Date Enter the number of days back that you would like to get data for in the Days Back field. Specify either today or 0, yesterday or 1, or today-7 or 7 to get data for 7 days into the past.
Start Date - Specific Select the first date in your date range using the date selector.
End Date - Specific Select the last date in your date range using the date selector.
Start Date - Relative

Enter the number of days back that you would like to get data from (start day). Combine with End Date to create a range of represented days.

For example, if you entered 10 for Start Date and 5 for End Date , the report would contain data for 10 days ago up until 5 days ago.

End Date - Relative

Enter the number of days back that you would like to get data to (end day). Combine with Start Date to create a range of represented days.

For example, if you entered 10 for Start Date and 5 for End Date , the report would contain data for 10 days ago up until 5 days ago.

Other Panes

For information about the remaining sections of the Connector interface, including how to configure scheduling, retry, and update options, see Adding a DataSet Using a Data Connector.