get_ad_insights
Pull performance metrics for a specific ad to compare creative effectiveness at the individual-ad level using breakdowns like age, gender, or platform.
Instructions
Pull performance metrics for ONE ad. Same fields/breakdowns as get_campaign_insights. Use this to compare creative performance at the individual-ad level.
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": {
"ad_id": "<ad_id>"
},
"name": "get_ad_insights"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ad_id | Yes | ||
| date_preset | No | Default last_7d | |
| time_range | No | {since:'YYYY-MM-DD', until:'YYYY-MM-DD'} — overrides date_preset | |
| breakdowns | No | e.g. ['age','gender'] or ['country','publisher_platform'] | |
| action_breakdowns | No | e.g. ['action_type'] | |
| time_increment | No | 1 = per-day rows, 7 = weekly, 'monthly', etc. | |
| filtering | No | Meta filtering spec | |
| fields | No | Override default metric list | |
| limit | No | ||
| after | No |