Google Ads

To connect Google Ads to Polytomic On Premises, you must create a Google OAuth client in a Google Cloud project that has Google Ads API access.

Enable Google Ads API access

1. In the Google Cloud console, select your project and enable these APIs:

   • Google Ads API
   • Data Manager API

2. On the Google Ads API Overview page, apply for Explorer access or higher. Enabling the API only grants Test access, which can't reach production accounts. See Google's access levels.

Create an OAuth client

1. Open Google Auth Platform. If you haven't set it up for this project, complete Branding and Audience.

   🚧

   Testing mode

   Google expires refresh tokens after 7 days for external apps in testing. Make sure to designate your app as internal in the Google console to avoid this.

2. Under Data Access, add these scopes:

   • https://www.googleapis.com/auth/adwords
   • https://www.googleapis.com/auth/userinfo.email
   • https://www.googleapis.com/auth/datamanager

3. Under Clients, create a client with these options:

   • Application type: Web application.
   • Name: Any name, for example Polytomic Google Ads client.
   • Authorized redirect URIs: {POLYTOMIC_URL}/connect/googleads. For example, if you access Polytomic at https://polytomic.acmecorp.com, use https://polytomic.acmecorp.com/connect/googleads.

4. Copy the client ID and client secret.

Set the credentials in Polytomic

Set these credentials in your Polytomic deployment:

• GOOGLEADS_CLIENT_ID: the client ID.
• GOOGLEADS_CLIENT_SECRET: the client secret.

⚠️

Releases before rel2026.10.28.01

Releases before rel2026.10.28.01 don't offer Google Ads until GOOGLEADS_DEVELOPER_TOKEN has a value. On those releases, set it to your existing developer token, or to a placeholder such as unused. Google ignores the value it receives. Later releases don't need this variable.

Then follow the Google Ads instructions to create a Connection.