Articles in this section

Set up a connection to Google Ads

Google Ads is online advertising platform that helps to promote your business, sell products or services, raise awareness, and increase traffic to your website.

Set up a connection

After you start the connection , configure it in the Create connection panel and complete all of the required * authentication settings:

Setting

Instructions

Name your connection * 

Enter a clear and distinguishable name.

Throughout integrator.io imports and exports, you will have the option to choose this new connection. A unique identifier will prove helpful later when selecting it from a list of the connections in your account.

Version * 

Enter your Google Ads version. For example, v15.

OAuth 2.0 client *  

Select the OAuth 2.0 client that stores the client ID and client secret provided by Google Ads.

How to retrieve the client ID and client secret 

To add an OAuth 2.0 client and configure your credentials, click the plus (+) button. Click the edit ( edit.svg ) button to modify a selected OAuth 2.0 client. For more information, see  Create an OAuth 2.0 iClient resource.

Developer token * 

Enter your Google Ads account developer token.

Multiple layers of protection, including AES 256 encryption, are in place to keep your developer token safe. When editing this connection, you must re-enter this value each time; it is stored only when the connection is saved and never displayed as text.

Fetch data {//theme.zdassets.com/theme_assets/1098969/5157503509223f89f9b3e7578d2ca78ce882fc18.svg}How to retrieve the developer token 

Customer ID * 

Enter your Google Ads account customer ID.

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.

While you specify the Customer ID , remove all hyphens (-). For example, if your Customer ID is 123-456-7890 , then enter 1234567890 .

Fetch data {//theme.zdassets.com/theme_assets/1098969/5157503509223f89f9b3e7578d2ca78ce882fc18.svg}How to retrieve the customer ID 

Login customer ID * 

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.

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

While you specify the Login customer ID , remove all hyphens (-). For example, if your Login customer ID is 123-456-7890 , then enter 1234567890 .

Fetch data {//theme.zdassets.com/theme_assets/1098969/5157503509223f89f9b3e7578d2ca78ce882fc18.svg}How to retrieve the login customer ID 

Tip: This connector documentation describes only the settings shown for the Simple view. For the corresponding HTTP settings, see  OAuth 2.0 auth universal connector documentation.

{{start input collapse count=1}}

{{a name=Client-Info3}}

{{label=How to retrieve the client ID and client secret}}

  1. Sign in to your Google Developer Console account.

  2. Create a new project or select an existing one.

  3. In the search bar, type Google Ads API and click Enable.

  4. Navigate to APIs and services.

  5. Make sure to configure your OAuth consent screen with the required information. For detailed information, see  Configure the OAuth consent screen.

  6. Navigate to Credentials > Create credentials and click OAuth client ID. The Create OAuth client ID page appears.

{{img class=screenshot-frame id=1}}

4.png
  1. From the Application type drop-down list, select the Web application.

  2. Provide a Name.

  3. Paste the integrator.io redirect URL in the Authorized redirect URIs, and click Create.

    • For NA: paste https://integrator.io/connection/oauth2callback

    • For EU: paste https://eu․integrator.io/connection/oauth2callback

{{img class=screenshot-frame id=2}}

5.png
  • Copy your ClientID and Clientsecret.

{{img class=screenshot-frame id=3}}

6.png

{{start input collapse count=2}}

{{a name=Client-Info1}}

{{label=How to retrieve the developer token}}

  1. Sign in to your Google Ads manager account.

  2. Navigate to Tools and settings > Setup > API center . The API access page appears.

  3. Copy the Developer token . For detailed information, see  Obtain a developer token .

Note: The API center option is available only for the Google Ads manager account.

{{img class=screenshot-frame id=4}}

API-access.png

{{start input collapse count=3}}

{{a name=Client-Info2}}

{{label=How to retrieve the customer ID and login customer ID}}

  1. Sign in to your Google Ads account.

  2. Your customer ID displays at the top right corner of the portal.

  3. Copy the Customer ID/Login customer ID.

{{img class=screenshot-frame id=5}}

GAds.png

{{end input collapse count=3}}

{{start input collapse count=4}}

{{a name=Client-Info4}}

{{label=Save and authorize}}

Click Save and authorize to commit your changes and proceed to sign in with Google Ads.

Caution

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

{{img class=screenshot-frame id=6}}

google-warning.png
google-warning.png

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.

{{img class=screenshot-frame id=7}}

319d2a03-3de0-42d5-b21a-40d6a2048950.png

{{end input collapse count=4}}

Additional references

{{end input collapse count=2}}

{{end input collapse count=1}}