google_ads_performance_report
Aggregate campaign-level performance metrics for a Google Ads account over a specified reporting window. Returns impressions, clicks, cost, conversions, and derived metrics per campaign.
Instructions
Aggregate campaign-level performance metrics for a Google Ads account over a reporting window. Returns one row per campaign shaped as {campaign_id, campaign_name, metrics}, where the metrics object contains impressions, clicks, cost_micros, cost (currency-formatted), conversions, ctr, average_cpc_micros, average_cpc, cost_per_conversion_micros, and cost_per_conversion. Read-only; no mutation. Use this for campaign-level totals. For per-ad breakdowns use google_ads_ad_performance_report; for Google Search vs. Search Partners splits use google_ads_network_performance_report; for query-level detail use google_ads_search_terms_report; for conversion-action slicing use google_ads_conversions_performance.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| customer_id | No | Google Ads customer ID as a 10-digit string without dashes (e.g. '1234567890'). Optional — falls back to GOOGLE_ADS_CUSTOMER_ID / GOOGLE_ADS_LOGIN_CUSTOMER_ID from the configured credentials when omitted. | |
| campaign_id | No | Restrict the report to a single campaign by numeric ID (e.g. '23743184133'). Omit to aggregate across every campaign in the account. | |
| period | No | Reporting window for the metrics. Default 'LAST_30_DAYS'. Use a shorter window (LAST_7_DAYS / LAST_14_DAYS) when diagnosing recent changes; use LAST_90_DAYS for trend baselines. |