First User Integration - Ads

Steps to set up Google Ads with Xkit if you haven't connected to any Google apps before

📘

Important

This guide walks you through how to set up Google Ads if you have not connected to another Google app before.

If you have connected to another Google app already, please see: Google Ads as an additional Google integration.

Google's Guide: https://developers.google.com/google-ads/api/docs/start
Authorization protocol: OAuth 2.0

1. Add the Google Ads connector in the Xkit platform.

  • In the Xkit platform, click "New connector" in the sidebar or at the bottom of the "Connectors" screen.
  • Click "Google Ads". At this point you'll see a callback url, which you'll provide to Google in one of the following steps, and places to input the Client ID and Client Secret that you'll get from Google after registering your app with them.

2. Register your application with Google.

  • Next, in a separate window, sign in to your Google account.
  • Visit the Google API Console.
  • Click "CREATE PROJECT", enter the name of your application and click "CREATE".

3. Enable the Google Ads API.

  • From the Google API console, click "ENABLE APIS AND SERVICES".
  • Search "Google Ads" and click on it.
  • Click "ENABLE".

4. Set the permissions/scopes.

  • From the Google API Console dashboard, click "OAuth consent screen" in the sidebar and submit the requested general information about your application.
  • Under "Scopes for Google APIs", click "Add scope" and then "Manually paste." In the box that appears below, copy/paste the following: https://www.googleapis.com/auth/adwords (additional details about the scopes are available here).
  • Click "Add".
  • Complete the remaining general information and click "Save".

5. Provide Google Ads with the callback url.

  • Click "Credentials" in the sidebar.
  • Click "Create Credentials" and then "OAuth client ID" in the dropdown.
  • Input the requested information about your app, including copying/pasting the callback URL from the Xkit platform into the "Authorized redirect URIs" field on the Google page.
  • Click "CREATE".

6. Provide Xkit with the credentials.

  • After completing the last step, you should see the credentials you just created under "OAuth 2.0 Client IDs". Click this to see details.
  • Copy/paste your Client ID and Client secret onto the Xkit page.

7. Complete the Xkit connection setup.

  • Now that you've provided the callback URL to Google and entered the Client ID and Client Secret into the Xkit platform, click "Save" on the Xkit page.
  • Fill out the Catalog Settings page and again click "Save".
  • On the next page, select the Google Ads scope and click "Save".

8. Create your Google Ads Developer Token.

  • Google Ads additionally requires a developer token in order to make calls to the API. To create your developer token, first visit https://ads.google.com/home and sign in to your Google Ads Manager account.
  • Click "TOOLS & SETTINGS" in the top toolbar, then "SETUP" and then "API Center".
  • Input the requested information about your app and click "CREATE TOKEN".
  • At this point, you will be provided with a test developer token. Click "Access level" and then "Apply for Basic Access" and fill out the additional requested information to be granted a production developer token.

You've now successfully connected Google Ads with Xkit!