Google Ads Connection

Connects your agent to Google Ads for search, display, and Performance Max campaign data. Pull campaign metrics, ad group performance, keyword data, quality scores, and conversion tracking. Read-only access.

Authentication

OAuth2 with developer token.

• client_id — Google API OAuth client ID
• client_secret — Google API OAuth client secret
• developer_token — Google Ads developer token
• customer_id — Google Ads customer ID (XXX-XXX-XXXX)
• login_customer_id — Manager account ID (if using MCC)

Endpoints

Campaigns

• POST /v16/customers/{customerId}/googleAds:searchStream — GAQL query for campaign metrics
• Campaign fields: impressions, clicks, cost, conversions, conversion_value, ROAS

Ad Groups

• GAQL query for ad group performance with CTR, CPC, quality scores

Keywords

• GAQL query for keyword metrics with match type, quality score components
• Search terms report for actual search queries triggering ads

Conversions

• GAQL query for conversion actions with attribution model breakdown

Asset Groups (PMax)

• GAQL query for Performance Max asset group performance

Rules

• Rate limit: 1,600 queries/day per developer token (standard access)
• The agent constructs GAQL queries from natural language
• Quality Score components (expected CTR, ad relevance, landing page experience) included automatically
• Date ranges default to last 30 days unless specified
• The agent flags keywords with Quality Score below 5 for optimization review