google_ads_ad_performance_report
Retrieve per-ad performance metrics from Google Ads, including impressions, clicks, cost, conversions, and CTR. Filter by ad group or campaign ID to analyze individual ad results across specified time periods.
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. |