get_campaign_performance
Fetch campaign performance KPIs from Meta Ads Manager (results, spend, conversions). Filter by date range and aggregate by campaign, ad set, or ad for deeper analysis.
Instructions
Get performance KPIs for campaigns. Results match the Ads Manager — only the optimization event of each ad set counts as a 'Result'.
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_account_id": "<ad_account_id>",
"campaign_ids": "<campaign_ids>"
},
"name": "get_campaign_performance"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| level | No | Aggregation level | campaign |
| adset_ids | No | Optional: filter by specific ad set IDs | |
| time_range | No | Custom date range (YYYY-MM-DD). Overrides date_preset. | |
| date_preset | No | Date preset for the report | last_7d |
| campaign_ids | Yes | Array of campaign IDs to get performance for | |
| ad_account_id | Yes | Ad account ID (e.g. act_123456789) |