google_ads_ad_performance_report
Retrieve per-ad performance data from Google Ads with metrics like impressions, clicks, cost, and conversions. Filter results by ad group or campaign to isolate specific performance.
Instructions
Report per-ad performance across Google Ads ad_group_ad rows. Returns one row per ad shaped as {ad_id, ad_type, status ('ENABLED'|'PAUSED'|'REMOVED'), ad_group_id, ad_group_name, campaign_id, campaign_name, metrics} where metrics contains impressions, clicks, cost_micros, cost (currency), conversions, ctr, average_cpc_micros, average_cpc, cost_per_conversion_micros, cost_per_conversion. Filterable by ad_group_id and/or campaign_id (both optional, both numeric). Read-only; no mutation. For ENABLED-only A/B comparison within a single ad group with WINNER/LOSER verdicts use google_ads_ad_performance_compare; for campaign-level aggregates use google_ads_performance_report.
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. | |
| ad_group_id | No | Optional ad group ID as a numeric string (e.g. '145680123456') to restrict results to a single ad group. Omit to include every ad group matching the campaign filter. | |
| campaign_id | No | Optional campaign ID as a numeric string (e.g. '23743184133') to restrict the report to a single campaign. 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. |