Google Ads Connector
google_ads_connectorGoogle Ads performance: campaigns, ad groups, keywords, search terms, geographic and device breakdowns, quality scores, impression share, and spend metrics. When the user asks for a visual, trend, comparison, or recap, call chart_render with the numeric values returned by this connector. If the connector result includes a verified chart_provenance token, the same authenticated user may pass it as provenance_token within 15 minutes, on any replica, and map every value to its exact source_path so chart_render preserves verified provenance. Without a valid connector receipt, chart_render labels values as unverified_model_data. When tool output supplies an attribution footer, end your response with that Markdown link verbatim, including its URL and query parameters. Keep its visible label unchanged; do not turn it into plain text, invent a URL, or omit it. Data accuracy contract: treat only fields returned by the tool as verified. Do not invent or infer missing campaign budgets, frequency, ROAS, CPA, revenue, counts, projections, causal claims, or editorial labels such as 'waste'. Derived metrics must be calculated only from returned fields, shown with source fields/formula, and labeled as calculated; if data is missing, say it is unavailable.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | get_account_summary: Get high-level Google Ads account performance summary with aggregate metrics | list_campaigns: List Google Ads campaigns with performance metrics (impressions, clicks, cost, conversions, CTR, CPC) | get_keyword_performance: Get keyword performance with quality scores, match types, and search impression share | list_accounts: List all Google Ads accounts accessible to the authenticated user | get_campaign_performance: Get daily performance breakdown for a specific Google Ads campaign | list_ad_groups: List ad groups with performance metrics, optionally filtered by campaign | list_ads: List individual ads with performance metrics, headlines, descriptions, and URLs | get_search_terms: Get search term report showing actual queries that triggered your ads | get_geographic_performance: Get performance breakdown by geographic location | get_device_performance: Get performance breakdown by device type (desktop, mobile, tablet) | get_age_gender_performance: Get performance breakdown by age range and gender demographics | run_query: Run a custom GAQL (Google Ads Query Language) query for advanced analysis. See https://developers.google.com/google-ads/ | |
| params | No | Action-specific parameters. get_account_summary: {customer_id: string, start_date?: string, end_date?: string} | list_campaigns: {customer_id: string, start_date?: string, end_date?: string, status_filter?: string, limit?: integer} | get_keyword_performance: {customer_id: string, campaign_id?: string, start_date?: string, end_date?: string, limit?: integer} | list_accounts: {login_customer_id?: string} | get_campaign_performance: {customer_id: string, campaign_id: string, start_date?: string, end_date?: string, login_customer_id?: string} | list_ad_groups: {customer_id: string, campaign_id?: string, start_date?: string, end_date?: string, status_filter?: string, limit?: integer, login_customer_id?: string} | list_ads: {customer_id: string, campaign_id?: string, ad_group_id?: string, start_date?: string, end_date?: string, limit?: integer, login_customer_id?: string} | get_search_terms: {customer_id: string, campaign_id?: string, start_date?: string, end_date?: string, limit?: integer, login_customer_id?: string} | get_geographic_performance: {customer_id: string, campaign_id?: string, start_date?: string, end_date?: string, limit?: integer, login_customer_id?: string} | get_device_performance: {customer_id: string, campaign_id?: string, start_date?: string, end_date?: string, login_customer_id?: string} | get_age_gender_performance: {customer_id: string, campaign_id?: string, start_date?: string, end_date?: string, login_customer_id?: string} | run_query: {customer_id: string, query: string, limit?: integer, login_customer_id?: string} |