get_tiktok_campaign_stats
Retrieve TikTok campaign performance metrics including impressions, clicks, spend, CTR, CPC, and conversions for analysis and optimization.
Instructions
Get performance metrics for a TikTok campaign: impressions, clicks, spend, CTR, CPC, conversions. Requires Pro plan or higher ($69/mo).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| campaign_id | Yes | TikTok campaign ID. | |
| start_date | No | Start date YYYY-MM-DD. Default: 7 days ago. | |
| end_date | No | End date YYYY-MM-DD. Default: today. |
Implementation Reference
- src/index.ts:610-625 (handler)Handler logic for the get_tiktok_campaign_stats tool in src/index.ts
case 'get_tiktok_campaign_stats': { const denied = licenseCheck('tiktok'); if (denied) return fail(denied); if (!args.campaign_id) return fail('campaign_id required.'); const now = new Date(), weekAgo = new Date(now.getTime() - 7 * 86400000); const fmt = (d: Date) => d.toISOString().split('T')[0]; return ok(await tikTokGet('/report/integrated/get/', { advertiser_id: cfg.tikTokAdvId(), report_type: 'BASIC', dimensions: '["campaign_id","stat_time_day"]', metrics: '["spend","impressions","clicks","ctr","cpc","conversion","cost_per_conversion"]', data_level: 'AUCTION_CAMPAIGN', start_date: (args.start_date as string) || fmt(weekAgo), end_date: (args.end_date as string) || fmt(now), filtering: JSON.stringify([{ field_name: 'campaign_ids', filter_type: 'IN', filter_value: `["${args.campaign_id}"]` }]), })); } - src/index.ts:340-351 (schema)Registration and schema definition for the get_tiktok_campaign_stats tool in src/index.ts
name: 'get_tiktok_campaign_stats', description: 'Get performance metrics for a TikTok campaign: impressions, clicks, spend, CTR, CPC, conversions. Requires Pro plan or higher ($69/mo).', inputSchema: { type: 'object', properties: { campaign_id: { type: 'string', description: 'TikTok campaign ID.' }, start_date: { type: 'string', description: 'Start date YYYY-MM-DD. Default: 7 days ago.' }, end_date: { type: 'string', description: 'End date YYYY-MM-DD. Default: today.' }, }, required: ['campaign_id'], }, },