get_ad_insights
Analyze ad performance metrics like impressions, clicks, spend, and CTR to optimize Facebook and Instagram campaigns using customizable breakdowns and time ranges.
Instructions
Get performance insights for a specific ad.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ad_id | Yes | Ad ID | |
| fields | No | Comma-separated insight fields | impressions,clicks,spend,reach,frequency,cpc,cpm,ctr,actions,cost_per_action_type |
| breakdowns | No | Breakdown dimensions: age,gender,country,region,placement,device_platform | |
| date_preset | No | Date preset: TODAY,YESTERDAY,LAST_7D,LAST_14D,LAST_30D,THIS_MONTH,LAST_MONTH,THIS_QUARTER,LAST_QUARTER,THIS_YEAR,LAST_YEAR | |
| time_range | No | JSON string {since,until} in YYYY-MM-DD format | |
| time_increment | No | Time granularity: all_days, 1, 7, monthly | |
| filtering | No | JSON string for filtering | |
| level | No | Aggregation level: campaign, adset, ad |