Google Ads via Google BigQuery Service Connector
Intro
Google Ads (formerly Google AdWords) is an online advertising service. Use Domo's Google Ads via BigQuery Service connector to transfer and pull data from a specific project into Domo. To successfully configure this connector, you must first configure a Google BigQuery script within your Google Ads account. The steps for doing this are provided later in this article.
For more information about the Google Ads API, see https://developers.google.com/adword...s/guides/start.
This topic discusses the fields and menus that are specific to the Google Ads via Google BigQuery Service connector user interface. For general information about adding DataSets, setting update schedules, and editing DataSet information, see Adding a DataSet Using a Data Connector.
Prerequisites
To connect to a BigQuery service account, you must have a Google BigQuery service account JSON key. To generate a key, do the following:
-
In the GCP Console, open the IAM & Admin page.
-
Click Service accounts in the left-hand navigation pane.
-
Select your project and click Open.
-
Click Create Service Account.
-
Enter a name and description for the service account.
-
Click Create.
-
Select Project Owner.
-
Click Continue.
-
Click Create key.
-
Select JSON as the key type.
-
Click Create.
A private key will be saved to your computer.
Connecting to Google Ads via Google BigQuery
This section enumerates the options in the Credentials and Details panes in the Google Ads via Google BigQuery Service 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 Google Ads via BigQuery. The following table describes what is needed for each field:
Field |
Description |
---|---|
Service Account Key JSON |
Copy and paste the JSON for your BigQuery service account key. For information about creating a key, see "Prerequisites," above. |
Once you have entered a valid key, you can use the same account any time you go to create a new Google Ads via BigQuery Service DataSet. You can manage connector accounts in the Accounts tab in the Data Center. For more information about this tab, see Managing User Accounts for Connectors.
Details Pane
This pane contains a number of fields and menus you can use to configure your report.
Menu |
Description |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Project ID |
Enter the name of the specific project you want to add your DataSet to. You can find this in your Google Cloud Console in the project info. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
DataSet ID |
Enter a name for your DataSet. You can choose any name you want. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Report |
Select the AdWords report type to run. The following reports are available:
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Date Range |
Select the date range for the data in your report. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Fields |
Check the boxes for all fields you want to import into your report. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Segments |
Check the boxes for all segments you want to import into your report. |
Once you have entered data into all of the fields and selected options from the menus, your Google Ads script will appear automatically in the Query preview pane. Copy this script and paste it into Google Ads as explained in the next section.
Configuring a BigQuery Script in Google Ads
This section explains how to configure a BigQuery script in Google Ads. After you have configured the script, you should be able to use the BigQuery Service connector to pull in data just as you would any other connector.
To configure a BigQuery script in Google Ads,
-
Configure your connector settings as explaned above.
-
Copy the script from the Query Preview pane.
-
Sign into your account in Google Ads.
-
Click the wrench icon in the top right corner of the screen.
-
Click Scripts (which is found under "Bulk Actions").
-
Click the plus button to create a new script.
-
Name the script, then click Authorize.
-
Select Advanced APIs.
-
Check the Bigquery box.
-
Paste the script you copied in step 4 into the textbox.
-
Click Preview.
-
(Conditional) If any error messages appear after you preview, follow their instructions.
For example, you may be prompted to click on another link to authorize BigQuery or reauthorize. -
Click Run when your configuration is successful.
Google Ads now takes you back to the main page, where you are prompted to set up how often a script runs. -
Click the pencil icon under "Frequency," then set the schedule for your script.
-
Return to the Google Ads via Google BigQuery Service connector page in Domo and continue configuring the connector.
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.
Troubleshooting
If the data doesn't seem to be updating, make sure your Google Ads script runs before the connector runs. Otherwise, the same data will be pulled again.