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
- Open your project and go to Tools → Add tool → From template.
- Find Google Ads and click Connect with Google.
- Sign in with a Google account that can access your Google Ads accounts and click Allow. VoisX requests the
adwordspermission. - Back in the VoisX console, enter your Developer token.
- Select the actions you want to enable and click Install integration.
Actions
| Action | What it does |
|---|---|
| List Accessible Customers | Lists the Google Ads account IDs the connected user can access |
| Get Campaign Performance | Returns impressions, clicks, cost and conversions per campaign for a date range |
| Run GAQL Query | Runs 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?