Get Ad Set Insights
get_adset_insightsRetrieve performance metrics for a specific ad set by its ID, including impressions, clicks, spend, CPC, CPM, CTR, and reach.
Instructions
Get performance insights for a specific ad set by ID. Returns metrics like impressions, clicks, spend, cpc, cpm, ctr, reach.
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 |
|---|---|---|---|
| limit | No | Max number of rows to return (default: 5000, max: 5000) | |
| since | No | Start date (YYYY-MM-DD). Used with 'until' to build time_range. | |
| until | No | End date (YYYY-MM-DD). Used with 'since' to build time_range. | |
| fields | No | Comma-separated list of metrics/dimensions. Common: impressions, clicks, spend, cpc, cpm, ctr, reach, frequency, actions, cost_per_action_type, conversions, cost_per_conversion. Default: impressions,clicks,spend,cpc,cpm,ctr,reach | |
| adset_id | Yes | Ad Set ID | |
| filtering | No | JSON array of filter objects. Example: [{"field":"impressions","operator":"GREATER_THAN","value":"0"}] | |
| breakdowns | No | Comma-separated breakdowns. Common: age, gender, country, publisher_platform, device_platform, impression_device | |
| time_increment | No | Time granularity: 1 (daily), 7, 14, monthly, or all_days (default: all_days) |