create_async_report
Generate asynchronous insight reports for large Meta Ads data queries, returning a report ID for polling detailed campaign performance metrics.
Instructions
Create an async insight report for large data queries. Returns a report_run_id to poll with get_async_report.
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 |