Set up a connection to Google Ads

Google Ads documentation: API guide, Authentication

A. Set up a Google Ads connection

Start establishing a connection to Google Ads in either of the following ways:

• From the Resources menu, select Connections. Then, click + Create connection at the top right.
  – or –
• While working in a new or existing integration, you can add an application to a flow simply by clicking Add source or Add destination/lookup.

In the resulting Application list, select Google Ads.

The Create connection pane opens with required and advanced settings.

B. Describe the Google Ads connection

Edit the General settings specific to your account and this connection resource.

Name (required): Provide a clear and distinguishable name. Throughout integrator.io imports and exports, you will have the option to choose this new connection, and a unique identifier will prove helpful later when selecting among a list of connections that you’ve created.

Application (required, non-editable): A reminder of the app you’re editing.

C. Supply required Google Ads account information

The Application details section contains settings for Google Ads authentication.

Developer token (required): Enter the developer token that integrator.io will use to make calls to the API. Use the following steps to retrieve the developer token:

1. Log in to your Google Ads manager account.
2. Navigate to TOOLS > MORE TOOLS > API Center. The API Center option is only available for Google Ads manager accounts.
3. The developer token is in the API Access section.

Customer ID (required): This field is required by all API calls. You can find the client customer ID in the Accounts tab in the left pane, in your Google Ads account. If you are making a call to a client account through a manager account, you must also provide the Login customer ID. If you are making calls to a manager account, the same value must be entered in both this field AND the Login customer ID field. Use the following steps to retrieve your customer ID.

1. Log in to your Google Ads account.
2. Click the help icon (?) in the upper right corner.
3. The customer ID displays at the bottom of the menu.

Login customer ID (required): Enter the Google Ads customer ID of the manager making the API call. This value is required for Google Ads API calls made by a manager to a client account. When specifying the Customer ID or Login customer ID, remove all hyphens (-). For example, if your Customer ID or Login customer ID is 123-456-7890, enter 1234567890.

Note: If you are making API calls directly to a manager account, enter the same value entered in the Customer ID field.

iClient (required): Select the iClient pair that stores the client ID and client secret provided to you by Google Ads. To add an iClient and configure your credentials, click the plus (+) button. Click the edit ( ) button to modify a selected iClient. Be sure to give the iClient a recognizable name for use in any other connections. Use the following steps to retrieve the required information for your iClient:

1. Sign in to your Google API Console.
2. Create a new project or select an existing one.
3. Search for Google Ads API and enable it.
4. Navigate to the APIs & Services page.
5. Make sure to configure your OAuth consent screen with appropriate info.
6. Select the credentials menu. Click + CREATE CREDENTIALS and select the OAuth Client ID option.
7. Give the web application a name and other details.
8. Enter the integrator.io callback URL in the Authorized redirect URIs: https://integrator.io/connection/oauth2callback
9. The Client ID and Client secret will display once you save the details. Enter these credentials in the iClient section of integrator.io.

Callback URL (read-only): Copy this integrator.io callback URL to provide directions to Google Ads for where to go after authentication. (This URL should be whitelisted with the authorization server.)

D. Edit advanced Google Ads settings

Before continuing, you have the opportunity to provide additional configuration information, if needed, for the Google Ads connection.

E. Test the connection

Once you have configured the Google Ads connection, you have a couple options for continuing:

• Save & authorize – Click this button to test the connection and commit it so that it will be available to all integrations for your account. (If you created it within a flow it will be applied to the current source or destination app as well.)
• Cancel – Click to exit without saving any new changes

When you click Save & authorize, Google prompts you to sign in.

Caution: Depending on your browser history and the permissions you’ve granted, you may see the following screen when attempting to sign in:

If so, click Advanced, and then click Go to integrator.io (unsafe) to allow the exception and continue.

After signing in, review the permissions for the integration and click Allow.

The new connection is now successfully added to your account. If you created it within a flow, it is applied to the current source or destination app. Otherwise, you can proceed to register the connection with an integration.

Need more help?

Check out these related topics and community posts:

• Import example: Add rows to a Google sheet
• HOW TO: Populate data into Google Ads
• HOW TO: Extract data from Google Ads and get data rows into name/value pairs