Skip to main content

Google Ads

The Google Ads integration lets agents report on your Google Ads campaigns.

Before you start​

Google Ads API calls need a developer token as well as the Google sign-in. Find it in a Google Ads manager account under Tools → API Center. A token with test access only works with test accounts; apply for Basic access to report on live accounts.

Connect​

  1. Open your project and go to Tools → Add tool → From template.
  2. Find Google Ads and click Connect with Google.
  3. Sign in with a Google account that can access your Google Ads accounts and click Allow. VoisX requests the adwords permission.
  4. Back in the VoisX console, enter your Developer token.
  5. Select the actions you want to enable and click Install integration.

Actions​

ActionWhat it does
List Accessible CustomersLists the Google Ads account IDs the connected user can access
Get Campaign PerformanceReturns impressions, clicks, cost and conversions per campaign for a date range
Run GAQL QueryRuns a custom Google Ads Query Language report

Put the customer ID (10 digits, no dashes) in the agent's prompt, or let the agent find it with List Accessible Customers.

Troubleshooting​

DEVELOPER_TOKEN_NOT_APPROVED​

The developer token only has test access. Use a test account, or apply for Basic access.

USER_PERMISSION_DENIED​

The connected Google account cannot access that customer ID. If the account is managed through a manager account, connect with a user who has direct access to it.

Was this page helpful?
On this page
Try it in the consoleBuild an agent and test it in the Playground.Open console →