get_adset_insights
Retrieve performance insights for a specific ad set, including impressions, clicks, spend, CTR, and custom breakdowns, to analyze and optimize Meta ad set results.
Instructions
Get performance insights for a specific ad set.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"adset_id": "<adset_id>"
},
"name": "get_adset_insights"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| level | No | Aggregation level: campaign, adset, ad | |
| fields | No | Comma-separated insight fields | impressions,clicks,spend,reach,frequency,cpc,cpm,ctr,actions,cost_per_action_type |
| adset_id | Yes | Ad Set ID | |
| filtering | No | JSON string for filtering | |
| breakdowns | No | Breakdown dimensions: age,gender,country,region,publisher_platform,platform_position,device_platform,comscore_market (replaces dma). Some accounts must opt in in Ads Manager for impression_device, hourly_stats_aggregated_by_audience_time_zone, and frequency_value; empty results do not necessarily mean zero performance. | |
| time_range | No | JSON string {since,until} in YYYY-MM-DD format | |
| date_preset | No | Lowercase date preset, for example: today, yesterday, last_7d, last_14d, last_30d, this_month, last_month, this_quarter, last_quarter, this_year, last_year | |
| time_increment | No | Time granularity: all_days, 1, 7, monthly |