Google Ads
Manage Google Ads campaigns, ad groups, ads, keywords, budgets, and performance reporting
The Google Ads integration lets your agents manage advertising campaigns — create and update campaigns, ad groups, ads, and keywords, adjust budgets, run performance reports with GAQL queries, generate keyword ideas, use AI to create ad text and images, apply Google's optimization recommendations, and upload offline conversions.
You need:
- Google Ads Manager (MCC) Account — A Manager account is required for API access. Create one at ads.google.com/home/tools/manager-accounts and link your ad accounts under it.
- Developer Token — From your Manager account, go to Admin → API Center to get your developer token. A test token is issued immediately; production access requires Google review.
- OAuth — Each chat user authorizes with their own Google account to access their ad data.
- Open your agent in Agent Studio
- In the Integrations panel, click Add Integration Config
- Select Google Ads from the integration list
- Give the config a display name (e.g., "Google Ads")
- Enter your Developer Token from the API Center
- Optionally enter your Login Customer ID (MCC account ID without hyphens) — required when accessing client accounts via a manager account
- Under authentication, click Connect to start the Google OAuth flow
- Save the agent revision
- In an Agent Step, attach Google Ads tools from the tools panel
- Tools are referenced as
google_ads.search, google_ads.mutate_campaigns, etc.
| Tool | Description | Action Type |
|---|
list_accounts | List all Google Ads customer accounts accessible to the authenticated user | ReadOnly |
| Tool | Description | Action Type |
|---|
search | Run a GAQL (Google Ads Query Language) query to read any data or generate reports — campaigns, ads, keywords, performance metrics, search terms, and more | ReadOnly |
| Tool | Description | Action Type |
|---|
mutate_campaign_budgets | Create, update, or remove campaign budgets (must be created before creating a campaign) | Irreversible |
| Tool | Description | Action Type |
|---|
mutate_campaigns | Create, update, pause, enable, or remove campaigns (Search, Display, Shopping, Video, Performance Max) | Reversible |
| Tool | Description | Action Type |
|---|
mutate_ad_groups | Create, update, pause, or remove ad groups within a campaign | Reversible |
| Tool | Description | Action Type |
|---|
mutate_ads | Create, update, pause, or remove ads (responsive search ads require at least 3 headlines and 2 descriptions) | Reversible |
| Tool | Description | Action Type |
|---|
mutate_keywords | Create, update, or remove keywords with match types: Exact, Phrase, or Broad | Reversible |
| Tool | Description | Action Type |
|---|
keyword_ideas | Generate keyword suggestions based on seed keywords, with search volume, competition level, and bid estimates | ReadOnly |
| Tool | Description | Action Type |
|---|
generate_audience | Use AI to translate a plain-text audience description into structured targeting attributes (affinity, in-market, life-event segments) | ReadOnly |
generate_text_assets | Use AI to generate ad headlines and descriptions from a landing page URL, prompt, or keywords | ReadOnly |
generate_image_assets | Use AI to generate marketing images from a landing page URL or text prompt | ReadOnly |
| Tool | Description | Action Type |
|---|
apply_recommendation | Apply Google's optimization recommendations (keywords, bidding, ads, budgets) to improve campaign performance | Reversible |
dismiss_recommendation | Dismiss optimization recommendations that are not relevant | Irreversible |
| Tool | Description | Action Type |
|---|
upload_conversions | Upload offline click conversions (phone calls, in-store purchases) back to Google Ads for better optimization | Irreversible |
