Skip to main content
The get_performance_report tool fetches performance metrics from your Google Ads account. You can segment results by campaign, ad group, or keyword, and specify any date range using named presets or custom start and end dates.

​
Parameters

​
level
string
required
Segmentation level. Accepted values:
  • CAMPAIGN — one row per campaign
  • AD_GROUP — one row per ad group
  • KEYWORD — one row per keyword
​
date_range
string
Named date range. Accepted values: TODAY, YESTERDAY, LAST_7_DAYS, LAST_30_DAYS, LAST_MONTH, THIS_MONTH, THIS_YEAR. Defaults to LAST_30_DAYS.
​
start_date
string
Custom start date in YYYY-MM-DD format. Overrides date_range when provided.
​
end_date
string
Custom end date in YYYY-MM-DD format. Required when start_date is set.
​
campaign_id
string
Filter results to a specific campaign. Returns all campaigns if omitted.
​
customer_id
string
The 10-digit Google Ads account ID. Uses configured default if not specified.

​
Returned metrics

MetricDescription
clicksTotal clicks
impressionsTotal impressions
ctrClick-through rate (clicks / impressions)
average_cpcAverage cost per click
costTotal spend in account currency
conversionsTotal conversions tracked
conversion_rateConversions per click
roasReturn on ad spend (revenue / cost)

​
Example prompts

Show me campaign performance for last 30 days

Get keyword-level performance for the "Summer Sale" campaign from July 1 to July 31

Compare ad group performance this month vs last month

​
Example response

[
  {
    "campaign_id": "98765432",
    "campaign_name": "Summer Sale",
    "clicks": 1842,
    "impressions": 34210,
    "ctr": 0.054,
    "average_cpc": 1.18,
    "cost": 2173.56,
    "conversions": 142,
    "conversion_rate": 0.077,
    "roas": 5.2
  }
]
Ask your AI assistant to format results as a markdown table for easier reading: “Show campaign performance last month as a table.”