get_meta_campaign_stats
Retrieve Meta campaign performance metrics including impressions, clicks, spend, CTR, CPM, and conversions to evaluate effectiveness before adjusting budgets.
Instructions
Get performance metrics for a Meta campaign: impressions, clicks, spend (USD), CTR, CPM, and conversions. Use to evaluate performance before budget decisions. Requires Starter plan or higher.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| campaign_id | Yes | Meta campaign ID. | |
| date_preset | No | Time range: today, yesterday, last_7d, last_14d, last_30d, this_month. Default: last_7d. |
Implementation Reference
- src/index.ts:509-517 (handler)Handler implementation for the get_meta_campaign_stats tool.
case 'get_meta_campaign_stats': { const denied = licenseCheck('meta'); if (denied) return fail(denied); if (!args.campaign_id) return fail('campaign_id required.'); return ok(await metaGet(`/${args.campaign_id}/insights`, { fields: 'campaign_name,impressions,clicks,spend,ctr,cpm,actions', date_preset: (args.date_preset as string) || 'last_7d', })); } - src/index.ts:262-273 (schema)Registration and schema definition for the get_meta_campaign_stats tool.
{ name: 'get_meta_campaign_stats', description: 'Get performance metrics for a Meta campaign: impressions, clicks, spend (USD), CTR, CPM, and conversions. Use to evaluate performance before budget decisions. Requires Starter plan or higher.', inputSchema: { type: 'object', properties: { campaign_id: { type: 'string', description: 'Meta campaign ID.' }, date_preset: { type: 'string', description: 'Time range: today, yesterday, last_7d, last_14d, last_30d, this_month. Default: last_7d.' }, }, required: ['campaign_id'], }, },