get_account_insights
Retrieve performance metrics and analytics for Meta ad accounts, including impressions, clicks, spend, reach, and breakdowns by demographics, placement, and time periods.
Instructions
Get performance insights for the ad account. Returns metrics like impressions, clicks, spend, reach, etc.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| 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 |