@cesteral/tiktok-mcp 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE.md +201 -0
- package/README.md +347 -0
- package/dist/auth/index.d.ts +3 -0
- package/dist/auth/index.d.ts.map +1 -0
- package/dist/auth/index.js +3 -0
- package/dist/auth/index.js.map +1 -0
- package/dist/auth/tiktok-auth-adapter.d.ts +40 -0
- package/dist/auth/tiktok-auth-adapter.d.ts.map +1 -0
- package/dist/auth/tiktok-auth-adapter.js +126 -0
- package/dist/auth/tiktok-auth-adapter.js.map +1 -0
- package/dist/auth/tiktok-auth-strategy.d.ts +14 -0
- package/dist/auth/tiktok-auth-strategy.d.ts.map +1 -0
- package/dist/auth/tiktok-auth-strategy.js +54 -0
- package/dist/auth/tiktok-auth-strategy.js.map +1 -0
- package/dist/config/index.d.ts +120 -0
- package/dist/config/index.d.ts.map +1 -0
- package/dist/config/index.js +55 -0
- package/dist/config/index.js.map +1 -0
- package/dist/index.d.ts +3 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +47 -0
- package/dist/index.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js +127 -0
- package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js +104 -0
- package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/creative-upload-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/creative-upload-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/creative-upload-workflow.prompt.js +121 -0
- package/dist/mcp-server/prompts/definitions/creative-upload-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.js +299 -0
- package/dist/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/cross-platform-performance.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/cross-platform-performance.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/cross-platform-performance.prompt.js +170 -0
- package/dist/mcp-server/prompts/definitions/cross-platform-performance.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/entity-duplication-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/entity-duplication-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/entity-duplication-workflow.prompt.js +198 -0
- package/dist/mcp-server/prompts/definitions/entity-duplication-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/entity-update-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/entity-update-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/entity-update-workflow.prompt.js +189 -0
- package/dist/mcp-server/prompts/definitions/entity-update-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.js +126 -0
- package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.js +200 -0
- package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.js +93 -0
- package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.js +111 -0
- package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/index.d.ts +9 -0
- package/dist/mcp-server/prompts/index.d.ts.map +1 -0
- package/dist/mcp-server/prompts/index.js +97 -0
- package/dist/mcp-server/prompts/index.js.map +1 -0
- package/dist/mcp-server/resources/definitions/entity-examples.resource.d.ts +4 -0
- package/dist/mcp-server/resources/definitions/entity-examples.resource.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/entity-examples.resource.js +182 -0
- package/dist/mcp-server/resources/definitions/entity-examples.resource.js.map +1 -0
- package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.d.ts +3 -0
- package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.js +147 -0
- package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.js.map +1 -0
- package/dist/mcp-server/resources/definitions/entity-schemas.resource.d.ts +4 -0
- package/dist/mcp-server/resources/definitions/entity-schemas.resource.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/entity-schemas.resource.js +135 -0
- package/dist/mcp-server/resources/definitions/entity-schemas.resource.js.map +1 -0
- package/dist/mcp-server/resources/definitions/index.d.ts +8 -0
- package/dist/mcp-server/resources/definitions/index.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/index.js +79 -0
- package/dist/mcp-server/resources/definitions/index.js.map +1 -0
- package/dist/mcp-server/resources/definitions/reporting-reference.resource.d.ts +3 -0
- package/dist/mcp-server/resources/definitions/reporting-reference.resource.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/reporting-reference.resource.js +165 -0
- package/dist/mcp-server/resources/definitions/reporting-reference.resource.js.map +1 -0
- package/dist/mcp-server/resources/definitions/targeting-reference.resource.d.ts +3 -0
- package/dist/mcp-server/resources/definitions/targeting-reference.resource.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/targeting-reference.resource.js +134 -0
- package/dist/mcp-server/resources/definitions/targeting-reference.resource.js.map +1 -0
- package/dist/mcp-server/resources/index.d.ts +3 -0
- package/dist/mcp-server/resources/index.d.ts.map +1 -0
- package/dist/mcp-server/resources/index.js +2 -0
- package/dist/mcp-server/resources/index.js.map +1 -0
- package/dist/mcp-server/resources/types.d.ts +8 -0
- package/dist/mcp-server/resources/types.d.ts.map +1 -0
- package/dist/mcp-server/resources/types.js +2 -0
- package/dist/mcp-server/resources/types.js.map +1 -0
- package/dist/mcp-server/server.d.ts +5 -0
- package/dist/mcp-server/server.d.ts.map +1 -0
- package/dist/mcp-server/server.js +134 -0
- package/dist/mcp-server/server.js.map +1 -0
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts +209 -0
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.js +141 -0
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts +151 -0
- package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js +112 -0
- package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts +193 -0
- package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js +130 -0
- package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts +153 -0
- package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js +137 -0
- package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts +119 -0
- package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/check-report-status.tool.js +89 -0
- package/dist/mcp-server/tools/definitions/check-report-status.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts +115 -0
- package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/create-entity.tool.js +103 -0
- package/dist/mcp-server/tools/definitions/create-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts +100 -0
- package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/delete-entity.tool.js +110 -0
- package/dist/mcp-server/tools/definitions/delete-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/download-report.tool.d.ts +297 -0
- package/dist/mcp-server/tools/definitions/download-report.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/download-report.tool.js +105 -0
- package/dist/mcp-server/tools/definitions/download-report.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/duplicate-entity.tool.d.ts +105 -0
- package/dist/mcp-server/tools/definitions/duplicate-entity.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/duplicate-entity.tool.js +85 -0
- package/dist/mcp-server/tools/definitions/duplicate-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-ad-preview.tool.d.ts +89 -0
- package/dist/mcp-server/tools/definitions/get-ad-preview.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-ad-preview.tool.js +74 -0
- package/dist/mcp-server/tools/definitions/get-ad-preview.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-ad-previews.tool.d.ts +89 -0
- package/dist/mcp-server/tools/definitions/get-ad-previews.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-ad-previews.tool.js +83 -0
- package/dist/mcp-server/tools/definitions/get-ad-previews.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-audience-estimate.tool.d.ts +85 -0
- package/dist/mcp-server/tools/definitions/get-audience-estimate.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-audience-estimate.tool.js +88 -0
- package/dist/mcp-server/tools/definitions/get-audience-estimate.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts +76 -0
- package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-entity.tool.js +71 -0
- package/dist/mcp-server/tools/definitions/get-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.d.ts +295 -0
- package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.js +174 -0
- package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-report.tool.d.ts +303 -0
- package/dist/mcp-server/tools/definitions/get-report.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-report.tool.js +178 -0
- package/dist/mcp-server/tools/definitions/get-report.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-targeting-options.tool.d.ts +127 -0
- package/dist/mcp-server/tools/definitions/get-targeting-options.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-targeting-options.tool.js +120 -0
- package/dist/mcp-server/tools/definitions/get-targeting-options.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/index.d.ts +26 -0
- package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/index.js +78 -0
- package/dist/mcp-server/tools/definitions/index.js.map +1 -0
- package/dist/mcp-server/tools/definitions/list-advertisers.tool.d.ts +54 -0
- package/dist/mcp-server/tools/definitions/list-advertisers.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/list-advertisers.tool.js +58 -0
- package/dist/mcp-server/tools/definitions/list-advertisers.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts +167 -0
- package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/list-entities.tool.js +114 -0
- package/dist/mcp-server/tools/definitions/list-entities.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts +131 -0
- package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/search-targeting.tool.js +123 -0
- package/dist/mcp-server/tools/definitions/search-targeting.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts +153 -0
- package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/submit-report.tool.js +117 -0
- package/dist/mcp-server/tools/definitions/submit-report.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts +111 -0
- package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/update-entity.tool.js +89 -0
- package/dist/mcp-server/tools/definitions/update-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/upload-image.tool.d.ts +87 -0
- package/dist/mcp-server/tools/definitions/upload-image.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/upload-image.tool.js +82 -0
- package/dist/mcp-server/tools/definitions/upload-image.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/upload-video.tool.d.ts +88 -0
- package/dist/mcp-server/tools/definitions/upload-video.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/upload-video.tool.js +113 -0
- package/dist/mcp-server/tools/definitions/upload-video.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/validate-entity.tool.d.ts +197 -0
- package/dist/mcp-server/tools/definitions/validate-entity.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/validate-entity.tool.js +237 -0
- package/dist/mcp-server/tools/definitions/validate-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/index.d.ts +2 -0
- package/dist/mcp-server/tools/index.d.ts.map +1 -0
- package/dist/mcp-server/tools/index.js +2 -0
- package/dist/mcp-server/tools/index.js.map +1 -0
- package/dist/mcp-server/tools/utils/entity-mapping.d.ts +22 -0
- package/dist/mcp-server/tools/utils/entity-mapping.d.ts.map +1 -0
- package/dist/mcp-server/tools/utils/entity-mapping.js +121 -0
- package/dist/mcp-server/tools/utils/entity-mapping.js.map +1 -0
- package/dist/mcp-server/tools/utils/resolve-session.d.ts +4 -0
- package/dist/mcp-server/tools/utils/resolve-session.d.ts.map +1 -0
- package/dist/mcp-server/tools/utils/resolve-session.js +6 -0
- package/dist/mcp-server/tools/utils/resolve-session.js.map +1 -0
- package/dist/mcp-server/transports/streamable-http-transport.d.ts +59 -0
- package/dist/mcp-server/transports/streamable-http-transport.d.ts.map +1 -0
- package/dist/mcp-server/transports/streamable-http-transport.js +107 -0
- package/dist/mcp-server/transports/streamable-http-transport.js.map +1 -0
- package/dist/services/session-services.d.ts +21 -0
- package/dist/services/session-services.d.ts.map +1 -0
- package/dist/services/session-services.js +25 -0
- package/dist/services/session-services.js.map +1 -0
- package/dist/services/tiktok/tiktok-http-client.d.ts +19 -0
- package/dist/services/tiktok/tiktok-http-client.d.ts.map +1 -0
- package/dist/services/tiktok/tiktok-http-client.js +184 -0
- package/dist/services/tiktok/tiktok-http-client.js.map +1 -0
- package/dist/services/tiktok/tiktok-reporting-service.d.ts +62 -0
- package/dist/services/tiktok/tiktok-reporting-service.d.ts.map +1 -0
- package/dist/services/tiktok/tiktok-reporting-service.js +129 -0
- package/dist/services/tiktok/tiktok-reporting-service.js.map +1 -0
- package/dist/services/tiktok/tiktok-service.d.ts +86 -0
- package/dist/services/tiktok/tiktok-service.d.ts.map +1 -0
- package/dist/services/tiktok/tiktok-service.js +217 -0
- package/dist/services/tiktok/tiktok-service.js.map +1 -0
- package/dist/services/tiktok/types.d.ts +161 -0
- package/dist/services/tiktok/types.d.ts.map +1 -0
- package/dist/services/tiktok/types.js +31 -0
- package/dist/services/tiktok/types.js.map +1 -0
- package/dist/types-global/mcp.d.ts +2 -0
- package/dist/types-global/mcp.d.ts.map +1 -0
- package/dist/types-global/mcp.js +2 -0
- package/dist/types-global/mcp.js.map +1 -0
- package/dist/utils/errors/index.d.ts +2 -0
- package/dist/utils/errors/index.d.ts.map +1 -0
- package/dist/utils/errors/index.js +2 -0
- package/dist/utils/errors/index.js.map +1 -0
- package/dist/utils/platform.d.ts +3 -0
- package/dist/utils/platform.d.ts.map +1 -0
- package/dist/utils/platform.js +5 -0
- package/dist/utils/platform.js.map +1 -0
- package/dist/utils/security/rate-limiter.d.ts +3 -0
- package/dist/utils/security/rate-limiter.d.ts.map +1 -0
- package/dist/utils/security/rate-limiter.js +5 -0
- package/dist/utils/security/rate-limiter.js.map +1 -0
- package/dist/utils/telemetry/index.d.ts +2 -0
- package/dist/utils/telemetry/index.d.ts.map +1 -0
- package/dist/utils/telemetry/index.js +2 -0
- package/dist/utils/telemetry/index.js.map +1 -0
- package/dist/utils/telemetry/tracing.d.ts +3 -0
- package/dist/utils/telemetry/tracing.d.ts.map +1 -0
- package/dist/utils/telemetry/tracing.js +4 -0
- package/dist/utils/telemetry/tracing.js.map +1 -0
- package/package.json +55 -0
|
@@ -0,0 +1,104 @@
|
|
|
1
|
+
export const campaignSetupWorkflowPrompt = {
|
|
2
|
+
name: "tiktok_campaign_setup_workflow",
|
|
3
|
+
description: "Step-by-step guide for creating a complete TikTok Ads campaign structure (Campaign > Ad Group > Ad)",
|
|
4
|
+
arguments: [
|
|
5
|
+
{
|
|
6
|
+
name: "advertiserId",
|
|
7
|
+
description: "TikTok Advertiser ID (e.g., 1234567890)",
|
|
8
|
+
required: true,
|
|
9
|
+
},
|
|
10
|
+
{
|
|
11
|
+
name: "objective",
|
|
12
|
+
description: "Campaign objective (e.g., TRAFFIC, APP_PROMOTION, WEB_CONVERSIONS)",
|
|
13
|
+
required: false,
|
|
14
|
+
},
|
|
15
|
+
],
|
|
16
|
+
};
|
|
17
|
+
export function getCampaignSetupWorkflowMessage(args) {
|
|
18
|
+
const advertiserId = args?.advertiserId || "{advertiserId}";
|
|
19
|
+
const objective = args?.objective || "TRAFFIC";
|
|
20
|
+
return `# TikTok Campaign Setup Workflow
|
|
21
|
+
|
|
22
|
+
## Prerequisites
|
|
23
|
+
- Advertiser ID: \`${advertiserId}\`
|
|
24
|
+
- Verify access: \`tiktok_list_advertisers\`
|
|
25
|
+
|
|
26
|
+
## Step 1: Create Campaign
|
|
27
|
+
|
|
28
|
+
\`\`\`json
|
|
29
|
+
tiktok_create_entity({
|
|
30
|
+
"entityType": "campaign",
|
|
31
|
+
"advertiserId": "${advertiserId}",
|
|
32
|
+
"data": {
|
|
33
|
+
"campaign_name": "Your Campaign Name",
|
|
34
|
+
"objective_type": "${objective}",
|
|
35
|
+
"budget_mode": "BUDGET_MODE_DAY",
|
|
36
|
+
"budget": 100
|
|
37
|
+
}
|
|
38
|
+
})
|
|
39
|
+
\`\`\`
|
|
40
|
+
|
|
41
|
+
**Campaign Objectives:** TRAFFIC, APP_PROMOTION, WEB_CONVERSIONS, ENGAGEMENT, VIDEO_VIEWS, LEAD_GENERATION, PRODUCT_SALES
|
|
42
|
+
|
|
43
|
+
## Step 2: Create Ad Group
|
|
44
|
+
|
|
45
|
+
\`\`\`json
|
|
46
|
+
tiktok_create_entity({
|
|
47
|
+
"entityType": "adGroup",
|
|
48
|
+
"advertiserId": "${advertiserId}",
|
|
49
|
+
"data": {
|
|
50
|
+
"campaign_id": "CAMPAIGN_ID_FROM_STEP_1",
|
|
51
|
+
"adgroup_name": "Your Ad Group Name",
|
|
52
|
+
"placements": ["PLACEMENT_TIKTOK"],
|
|
53
|
+
"budget_mode": "BUDGET_MODE_DAY",
|
|
54
|
+
"budget": 50,
|
|
55
|
+
"schedule_type": "SCHEDULE_START_END",
|
|
56
|
+
"pacing": "PACING_MODE_SMOOTH",
|
|
57
|
+
"schedule_start_time": "2026-03-01 00:00:00",
|
|
58
|
+
"schedule_end_time": "2026-12-31 23:59:59",
|
|
59
|
+
"optimization_goal": "CLICK",
|
|
60
|
+
"bid_price": 0.5,
|
|
61
|
+
"age": ["AGE_18_24", "AGE_25_34"],
|
|
62
|
+
"gender": ["GENDER_UNLIMITED"],
|
|
63
|
+
"location_ids": ["US"]
|
|
64
|
+
}
|
|
65
|
+
})
|
|
66
|
+
\`\`\`
|
|
67
|
+
|
|
68
|
+
## Step 3: Create Ad(s)
|
|
69
|
+
|
|
70
|
+
\`\`\`json
|
|
71
|
+
tiktok_create_entity({
|
|
72
|
+
"entityType": "ad",
|
|
73
|
+
"advertiserId": "${advertiserId}",
|
|
74
|
+
"data": {
|
|
75
|
+
"adgroup_id": "ADGROUP_ID_FROM_STEP_2",
|
|
76
|
+
"creatives": [
|
|
77
|
+
{
|
|
78
|
+
"ad_name": "Your Ad Name",
|
|
79
|
+
"video_id": "YOUR_VIDEO_ID",
|
|
80
|
+
"call_to_action": "LEARN_MORE",
|
|
81
|
+
"landing_page_url": "https://example.com"
|
|
82
|
+
}
|
|
83
|
+
]
|
|
84
|
+
}
|
|
85
|
+
})
|
|
86
|
+
\`\`\`
|
|
87
|
+
|
|
88
|
+
## Step 4: Verify & Activate
|
|
89
|
+
|
|
90
|
+
1. Review: \`tiktok_get_entity\` for each created entity
|
|
91
|
+
2. Preview ad: \`tiktok_get_ad_preview\`
|
|
92
|
+
3. Activate: \`tiktok_bulk_update_status\` with operationStatus: "ENABLE"
|
|
93
|
+
|
|
94
|
+
## Common Gotchas
|
|
95
|
+
|
|
96
|
+
- ⚠️ Campaigns are created in **ENABLE** status by default — use DISABLE if not ready
|
|
97
|
+
- ⚠️ Ad groups require \`schedule_start_time\` when \`schedule_type\` is SCHEDULE_START_END
|
|
98
|
+
- ⚠️ Video IDs must be uploaded to TikTok Creative Library first
|
|
99
|
+
- ⚠️ Budget values are in account currency (NOT cents)
|
|
100
|
+
- ⚠️ All status updates use separate /status/update/ endpoints — use \`tiktok_bulk_update_status\`
|
|
101
|
+
- ⚠️ Reporting has a 24-48h lag for finalized data
|
|
102
|
+
`;
|
|
103
|
+
}
|
|
104
|
+
//# sourceMappingURL=campaign-setup-workflow.prompt.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"campaign-setup-workflow.prompt.js","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,2BAA2B,GAAW;IACjD,IAAI,EAAE,gCAAgC;IACtC,WAAW,EACT,qGAAqG;IACvG,SAAS,EAAE;QACT;YACE,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,yCAAyC;YACtD,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,WAAW;YACjB,WAAW,EAAE,oEAAoE;YACjF,QAAQ,EAAE,KAAK;SAChB;KACF;CACF,CAAC;AAEF,MAAM,UAAU,+BAA+B,CAAC,IAA6B;IAC3E,MAAM,YAAY,GAAG,IAAI,EAAE,YAAY,IAAI,gBAAgB,CAAC;IAC5D,MAAM,SAAS,GAAG,IAAI,EAAE,SAAS,IAAI,SAAS,CAAC;IAE/C,OAAO;;;qBAGY,YAAY;;;;;;;;qBAQZ,YAAY;;;yBAGR,SAAS;;;;;;;;;;;;;;qBAcb,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;qBAyBZ,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BhC,CAAC;AACF,CAAC"}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
import type { Prompt } from "@modelcontextprotocol/sdk/types.js";
|
|
2
|
+
export declare const tiktokCreativeUploadWorkflowPrompt: Prompt;
|
|
3
|
+
export declare function getTiktokCreativeUploadWorkflowMessage(args?: Record<string, string>): string;
|
|
4
|
+
//# sourceMappingURL=creative-upload-workflow.prompt.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"creative-upload-workflow.prompt.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/creative-upload-workflow.prompt.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAEjE,eAAO,MAAM,kCAAkC,EAAE,MAehD,CAAC;AAEF,wBAAgB,sCAAsC,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CA4G5F"}
|
|
@@ -0,0 +1,121 @@
|
|
|
1
|
+
export const tiktokCreativeUploadWorkflowPrompt = {
|
|
2
|
+
name: "creative_upload_workflow",
|
|
3
|
+
description: "Step-by-step guide for uploading creative assets and creating TikTok Ads creatives",
|
|
4
|
+
arguments: [
|
|
5
|
+
{
|
|
6
|
+
name: "advertiserId",
|
|
7
|
+
description: "TikTok Advertiser ID",
|
|
8
|
+
required: true,
|
|
9
|
+
},
|
|
10
|
+
{
|
|
11
|
+
name: "creativeType",
|
|
12
|
+
description: "Type of creative: image or video",
|
|
13
|
+
required: false,
|
|
14
|
+
},
|
|
15
|
+
],
|
|
16
|
+
};
|
|
17
|
+
export function getTiktokCreativeUploadWorkflowMessage(args) {
|
|
18
|
+
const advertiserId = args?.advertiserId || "{advertiserId}";
|
|
19
|
+
const creativeType = args?.creativeType || "video";
|
|
20
|
+
return `# TikTok Ads Creative Upload Workflow
|
|
21
|
+
|
|
22
|
+
## Prerequisites
|
|
23
|
+
- Advertiser ID: \`${advertiserId}\`
|
|
24
|
+
- A publicly accessible URL for your media file
|
|
25
|
+
|
|
26
|
+
## Overview
|
|
27
|
+
TikTok creative workflow: Upload media → Create Ad Group → Create Ad with creative
|
|
28
|
+
|
|
29
|
+
---
|
|
30
|
+
|
|
31
|
+
## Step 1: Upload ${creativeType === "image" ? "Image" : "Video"}
|
|
32
|
+
|
|
33
|
+
${creativeType === "image"
|
|
34
|
+
? `
|
|
35
|
+
\`\`\`json
|
|
36
|
+
tiktok_upload_image({
|
|
37
|
+
"advertiserId": "${advertiserId}",
|
|
38
|
+
"mediaUrl": "https://example.com/your-image.jpg"
|
|
39
|
+
})
|
|
40
|
+
\`\`\`
|
|
41
|
+
|
|
42
|
+
**Returns:** \`imageId\`
|
|
43
|
+
|
|
44
|
+
**Image requirements:**
|
|
45
|
+
- Formats: JPEG, PNG
|
|
46
|
+
- Max 100KB for feed ads
|
|
47
|
+
- Recommended: 1200x628px, 1080x1080px, 720x1280px
|
|
48
|
+
`
|
|
49
|
+
: `
|
|
50
|
+
\`\`\`json
|
|
51
|
+
tiktok_upload_video({
|
|
52
|
+
"advertiserId": "${advertiserId}",
|
|
53
|
+
"mediaUrl": "https://example.com/your-video.mp4",
|
|
54
|
+
"videoName": "Campaign Video"
|
|
55
|
+
})
|
|
56
|
+
\`\`\`
|
|
57
|
+
|
|
58
|
+
**Returns:** \`videoId\`
|
|
59
|
+
|
|
60
|
+
⚠️ **GOTCHA**: Video processing takes 20-120 seconds. The tool polls automatically (20s intervals, up to 10 min).
|
|
61
|
+
When \`video_status == "bind_success"\`, the video is ready.
|
|
62
|
+
|
|
63
|
+
**Video requirements:**
|
|
64
|
+
- Formats: MP4, MOV, AVI
|
|
65
|
+
- Max 500MB
|
|
66
|
+
- Min resolution: 540x960 (9:16), 960x540 (16:9), or 640x640 (1:1)
|
|
67
|
+
- Duration: 5-60 seconds for In-Feed ads
|
|
68
|
+
`}
|
|
69
|
+
|
|
70
|
+
## Step 2: Create Ad
|
|
71
|
+
|
|
72
|
+
\`\`\`json
|
|
73
|
+
tiktok_create_entity({
|
|
74
|
+
"entityType": "ad",
|
|
75
|
+
"advertiserId": "${advertiserId}",
|
|
76
|
+
"data": {
|
|
77
|
+
"adgroup_id": "{your_adgroup_id}",
|
|
78
|
+
"ad_name": "Your Ad Name",
|
|
79
|
+
"ad_format": "SINGLE_VIDEO",
|
|
80
|
+
${creativeType === "image"
|
|
81
|
+
? `"image_ids": ["{imageId_from_step_1}"],
|
|
82
|
+
"ad_text": "Your ad copy here",`
|
|
83
|
+
: `"video_id": "{videoId_from_step_1}",
|
|
84
|
+
"ad_text": "Your ad copy here",`}
|
|
85
|
+
"landing_page_url": "https://yoursite.com",
|
|
86
|
+
"call_to_action": "LEARN_MORE",
|
|
87
|
+
"status": "DISABLE"
|
|
88
|
+
}
|
|
89
|
+
})
|
|
90
|
+
\`\`\`
|
|
91
|
+
|
|
92
|
+
⚠️ **GOTCHA**: TikTok ads go through a review process. Initial status should be DISABLE (paused) until ready to launch.
|
|
93
|
+
|
|
94
|
+
## Step 3: Preview Ad
|
|
95
|
+
|
|
96
|
+
\`\`\`json
|
|
97
|
+
tiktok_get_ad_preview({
|
|
98
|
+
"advertiserId": "${advertiserId}",
|
|
99
|
+
"adId": "{ad_id_from_step_2}",
|
|
100
|
+
"adFormat": "FEED"
|
|
101
|
+
})
|
|
102
|
+
\`\`\`
|
|
103
|
+
|
|
104
|
+
## Common Errors
|
|
105
|
+
|
|
106
|
+
| Error | Cause | Fix |
|
|
107
|
+
|-------|-------|-----|
|
|
108
|
+
| "Video processing failed" | Unsupported codec | Re-encode to H.264 MP4 |
|
|
109
|
+
| "Image size exceeded" | File too large | Compress to < 100KB |
|
|
110
|
+
| "Ad review rejected" | Policy violation | Review TikTok ad policies |
|
|
111
|
+
| "bind_success timeout" | Slow processing | Check video_status manually |
|
|
112
|
+
|
|
113
|
+
## Success Criteria
|
|
114
|
+
- [ ] Media uploaded (imageId or videoId obtained)
|
|
115
|
+
- [ ] Ad created with DISABLE status
|
|
116
|
+
- [ ] Preview reviewed
|
|
117
|
+
- [ ] Status changed to ENABLE when ready to launch
|
|
118
|
+
|
|
119
|
+
`;
|
|
120
|
+
}
|
|
121
|
+
//# sourceMappingURL=creative-upload-workflow.prompt.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"creative-upload-workflow.prompt.js","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/creative-upload-workflow.prompt.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,kCAAkC,GAAW;IACxD,IAAI,EAAE,0BAA0B;IAChC,WAAW,EAAE,oFAAoF;IACjG,SAAS,EAAE;QACT;YACE,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,sBAAsB;YACnC,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,kCAAkC;YAC/C,QAAQ,EAAE,KAAK;SAChB;KACF;CACF,CAAC;AAEF,MAAM,UAAU,sCAAsC,CAAC,IAA6B;IAClF,MAAM,YAAY,GAAG,IAAI,EAAE,YAAY,IAAI,gBAAgB,CAAC;IAC5D,MAAM,YAAY,GAAG,IAAI,EAAE,YAAY,IAAI,OAAO,CAAC;IAEnD,OAAO;;;qBAGY,YAAY;;;;;;;;oBAQb,YAAY,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO;;EAG9D,YAAY,KAAK,OAAO;QACtB,CAAC,CAAC;;;qBAGe,YAAY;;;;;;;;;;;CAWhC;QACG,CAAC,CAAC;;;qBAGe,YAAY;;;;;;;;;;;;;;;;CAiBjC;;;;;;;qBAOqB,YAAY;;;;;MAM3B,YAAY,KAAK,OAAO;QACtB,CAAC,CAAC;oCAC0B;QAC5B,CAAC,CAAC;oCAEN;;;;;;;;;;;;;;qBAciB,YAAY;;;;;;;;;;;;;;;;;;;;;CAqBhC,CAAC;AACF,CAAC"}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
import type { Prompt } from "@modelcontextprotocol/sdk/types.js";
|
|
2
|
+
export declare const crossPlatformCampaignSetupPrompt: Prompt;
|
|
3
|
+
export declare function getCrossPlatformCampaignSetupMessage(args?: Record<string, string>): string;
|
|
4
|
+
//# sourceMappingURL=cross-platform-campaign-setup.prompt.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"cross-platform-campaign-setup.prompt.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAQjE,eAAO,MAAM,gCAAgC,EAAE,MAiB9C,CAAC;AAEF,wBAAgB,oCAAoC,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CA0R1F"}
|
|
@@ -0,0 +1,299 @@
|
|
|
1
|
+
export const crossPlatformCampaignSetupPrompt = {
|
|
2
|
+
name: "cross_platform_campaign_setup",
|
|
3
|
+
description: "Guide for setting up a coordinated multi-platform campaign across DV360 (dv360-mcp), The Trade Desk (ttd-mcp), Google Ads (gads-mcp), Meta Ads (meta-mcp), LinkedIn (linkedin-mcp), TikTok (tiktok-mcp), Pinterest (pinterest-mcp), Snapchat (snapchat-mcp), and Amazon DSP (amazon-dsp-mcp). Covers platform selection, budget allocation, naming conventions, and phased launch.",
|
|
4
|
+
arguments: [
|
|
5
|
+
{
|
|
6
|
+
name: "totalBudget",
|
|
7
|
+
description: "Total campaign budget across all platforms (e.g., '50000' for $50,000)",
|
|
8
|
+
required: false,
|
|
9
|
+
},
|
|
10
|
+
{
|
|
11
|
+
name: "objective",
|
|
12
|
+
description: "Campaign objective: 'awareness', 'consideration', or 'conversion' (default: conversion)",
|
|
13
|
+
required: false,
|
|
14
|
+
},
|
|
15
|
+
],
|
|
16
|
+
};
|
|
17
|
+
export function getCrossPlatformCampaignSetupMessage(args) {
|
|
18
|
+
const totalBudget = args?.totalBudget || "{totalBudget}";
|
|
19
|
+
const objective = args?.objective || "conversion";
|
|
20
|
+
return `# Cross-Platform Coordinated Campaign Setup
|
|
21
|
+
|
|
22
|
+
Total Budget: \$${totalBudget}
|
|
23
|
+
Objective: \`${objective}\`
|
|
24
|
+
|
|
25
|
+
This workflow guides you through setting up campaigns across multiple ad platforms in a coordinated manner. You must be connected to the relevant MCP servers.
|
|
26
|
+
|
|
27
|
+
---
|
|
28
|
+
|
|
29
|
+
## Step 1: Platform Selection
|
|
30
|
+
|
|
31
|
+
Choose platforms based on your objective and audience:
|
|
32
|
+
|
|
33
|
+
| Objective | Recommended Platforms | Rationale |
|
|
34
|
+
|-----------|----------------------|-----------|
|
|
35
|
+
| **Awareness** | DV360 + Meta + TikTok + Pinterest | DV360 for programmatic display/video reach, Meta/TikTok for social reach, Pinterest for visual discovery |
|
|
36
|
+
| **Consideration** | DV360 + TTD + Meta + LinkedIn | Broad programmatic reach with social engagement and B2B professional targeting |
|
|
37
|
+
| **Conversion** | Google Ads + Meta + TTD + Amazon DSP | Search intent (Google) + social retargeting (Meta) + programmatic (TTD) + retail intent (Amazon) |
|
|
38
|
+
| **B2B** | LinkedIn + Google Ads + Meta | Professional audience targeting on LinkedIn, search intent, social retargeting |
|
|
39
|
+
| **Gen Z / Video** | TikTok + Snapchat + Meta | Short-form video engagement across Gen Z/Millennial audiences |
|
|
40
|
+
| **Shopping / E-commerce** | Pinterest + Meta + Google Ads + Amazon DSP | Visual discovery + social + search + retail intent |
|
|
41
|
+
| **Full-Funnel** | All 9 platforms | Maximum reach across all touchpoints |
|
|
42
|
+
|
|
43
|
+
---
|
|
44
|
+
|
|
45
|
+
## Step 2: Budget Allocation
|
|
46
|
+
|
|
47
|
+
Split the total budget across platforms. Common allocation strategies:
|
|
48
|
+
|
|
49
|
+
### Performance-Based (Recommended for existing campaigns)
|
|
50
|
+
Allocate based on historical CPA/ROAS data. Use the \`cross_platform_performance_comparison\` prompt to gather data first.
|
|
51
|
+
|
|
52
|
+
### Equal Split (New campaigns with no history)
|
|
53
|
+
|
|
54
|
+
| Platform | Allocation | Budget |
|
|
55
|
+
|----------|-----------|--------|
|
|
56
|
+
| DV360 | 15% | \$${totalBudget} × 0.15 |
|
|
57
|
+
| TTD | 15% | \$${totalBudget} × 0.15 |
|
|
58
|
+
| Google Ads | 15% | \$${totalBudget} × 0.15 |
|
|
59
|
+
| Meta | 15% | \$${totalBudget} × 0.15 |
|
|
60
|
+
| LinkedIn | 10% | \$${totalBudget} × 0.10 |
|
|
61
|
+
| TikTok | 10% | \$${totalBudget} × 0.10 |
|
|
62
|
+
| Pinterest | 10% | \$${totalBudget} × 0.10 |
|
|
63
|
+
| Snapchat | 5% | \$${totalBudget} × 0.05 |
|
|
64
|
+
| Amazon DSP | 5% | \$${totalBudget} × 0.05 |
|
|
65
|
+
|
|
66
|
+
### Objective-Weighted
|
|
67
|
+
|
|
68
|
+
| Platform | Awareness | Consideration | Conversion | B2B | Shopping |
|
|
69
|
+
|----------|-----------|---------------|------------|-----|----------|
|
|
70
|
+
| DV360 | 25% | 20% | 10% | 5% | 5% |
|
|
71
|
+
| TTD | 15% | 15% | 15% | 5% | 10% |
|
|
72
|
+
| Google Ads | 5% | 15% | 30% | 20% | 20% |
|
|
73
|
+
| Meta | 20% | 20% | 15% | 15% | 20% |
|
|
74
|
+
| LinkedIn | 5% | 10% | 5% | 35% | 2% |
|
|
75
|
+
| TikTok | 15% | 10% | 10% | 5% | 8% |
|
|
76
|
+
| Pinterest | 10% | 5% | 5% | 0% | 20% |
|
|
77
|
+
| Snapchat | 5% | 5% | 5% | 0% | 5% |
|
|
78
|
+
| Amazon DSP | 0% | 0% | 5% | 15% | 10% |
|
|
79
|
+
|
|
80
|
+
---
|
|
81
|
+
|
|
82
|
+
## Step 3: Naming Convention
|
|
83
|
+
|
|
84
|
+
Use consistent naming across all platforms for easy cross-platform tracking:
|
|
85
|
+
|
|
86
|
+
**Pattern:** \`{Brand}_{Objective}_{Platform}_{Geo}_{Audience}_{YYYYMM}\`
|
|
87
|
+
|
|
88
|
+
**Examples:**
|
|
89
|
+
- \`Acme_Conv_DV360_US_Retargeting_202603\`
|
|
90
|
+
- \`Acme_Conv_TTD_US_Retargeting_202603\`
|
|
91
|
+
- \`Acme_Conv_GADS_US_Search_202603\`
|
|
92
|
+
- \`Acme_Conv_META_US_Lookalike_202603\`
|
|
93
|
+
- \`Acme_B2B_LI_US_Professionals_202603\`
|
|
94
|
+
- \`Acme_Aware_TT_US_GenZ_202603\`
|
|
95
|
+
- \`Acme_Shop_PIN_US_ShoppingIntent_202603\`
|
|
96
|
+
- \`Acme_Aware_SNAP_US_GenZ_202603\`
|
|
97
|
+
- \`Acme_Conv_AMZN_US_Retargeting_202603\`
|
|
98
|
+
|
|
99
|
+
---
|
|
100
|
+
|
|
101
|
+
## Step 4: Create Campaigns on Each Platform
|
|
102
|
+
|
|
103
|
+
### DV360 (via dv360-mcp)
|
|
104
|
+
|
|
105
|
+
Use the \`full_campaign_setup_workflow\` prompt for detailed guidance.
|
|
106
|
+
|
|
107
|
+
Key steps:
|
|
108
|
+
1. Create Campaign (PAUSED status)
|
|
109
|
+
2. Create Insertion Order (DRAFT status)
|
|
110
|
+
3. Create Line Items (DRAFT status)
|
|
111
|
+
4. Assign targeting
|
|
112
|
+
5. Activate via \`entity_activation_workflow\`
|
|
113
|
+
|
|
114
|
+
⚠️ **DV360 budget values are in micros** (1,000,000 = $1.00)
|
|
115
|
+
|
|
116
|
+
### The Trade Desk (via ttd-mcp)
|
|
117
|
+
|
|
118
|
+
Use the \`ttd_campaign_setup_workflow\` prompt for detailed guidance.
|
|
119
|
+
|
|
120
|
+
Key steps:
|
|
121
|
+
1. Create Campaign
|
|
122
|
+
2. Create Ad Groups with RTBAttributes
|
|
123
|
+
3. Create Ads and link Creatives
|
|
124
|
+
4. Set availability to "Available"
|
|
125
|
+
|
|
126
|
+
⚠️ **TTD budget values are in dollars** ($100.00 = 100.00)
|
|
127
|
+
|
|
128
|
+
### Google Ads (via gads-mcp)
|
|
129
|
+
|
|
130
|
+
Use the \`gads_campaign_setup_workflow\` prompt for detailed guidance.
|
|
131
|
+
|
|
132
|
+
Key steps:
|
|
133
|
+
1. Create Campaign Budget
|
|
134
|
+
2. Create Campaign (PAUSED)
|
|
135
|
+
3. Create Ad Groups
|
|
136
|
+
4. Create Keywords (for Search)
|
|
137
|
+
5. Create Responsive Search Ads
|
|
138
|
+
6. Enable campaign
|
|
139
|
+
|
|
140
|
+
⚠️ **Google Ads budget values are in micros** (1,000,000 = $1.00)
|
|
141
|
+
|
|
142
|
+
### Meta Ads (via meta-mcp)
|
|
143
|
+
|
|
144
|
+
Use the \`meta_campaign_setup_workflow\` prompt for detailed guidance.
|
|
145
|
+
|
|
146
|
+
Key steps:
|
|
147
|
+
1. Create Campaign (PAUSED)
|
|
148
|
+
2. Create Ad Creative
|
|
149
|
+
3. Create Ad Sets with targeting
|
|
150
|
+
4. Create Ads
|
|
151
|
+
5. Activate
|
|
152
|
+
|
|
153
|
+
⚠️ **Meta budget values are in cents** (5000 = $50.00)
|
|
154
|
+
|
|
155
|
+
### LinkedIn Ads (via linkedin-mcp)
|
|
156
|
+
|
|
157
|
+
Use the \`linkedin_campaign_setup_workflow\` prompt for detailed guidance.
|
|
158
|
+
|
|
159
|
+
Key steps:
|
|
160
|
+
1. Create Campaign Group (ACTIVE or PAUSED)
|
|
161
|
+
2. Create Campaign with targeting criteria and CPM bid
|
|
162
|
+
3. Create Creative linked to the campaign
|
|
163
|
+
4. Activate via \`linkedin_bulk_update_status\`
|
|
164
|
+
|
|
165
|
+
⚠️ **LinkedIn budget values are in dollars** ($100.00 = 100.00)
|
|
166
|
+
|
|
167
|
+
Best for: B2B, professional audiences, job title/company/skill targeting
|
|
168
|
+
|
|
169
|
+
### TikTok Ads (via tiktok-mcp)
|
|
170
|
+
|
|
171
|
+
Use the \`tiktok_campaign_setup_workflow\` prompt for detailed guidance.
|
|
172
|
+
|
|
173
|
+
Key steps:
|
|
174
|
+
1. Create Campaign with objective and budget
|
|
175
|
+
2. Create Ad Group with targeting and schedule
|
|
176
|
+
3. Upload creatives via \`tiktok_upload_video\` or \`tiktok_upload_image\`
|
|
177
|
+
4. Create Ads referencing the creative
|
|
178
|
+
5. Enable via \`tiktok_bulk_update_status\`
|
|
179
|
+
|
|
180
|
+
⚠️ **TikTok budget values are in dollars** ($100.00 = 100.00)
|
|
181
|
+
|
|
182
|
+
Best for: Short-form video, Gen Z/Millennial audiences, entertainment and lifestyle brands
|
|
183
|
+
|
|
184
|
+
### Pinterest (via pinterest-mcp)
|
|
185
|
+
|
|
186
|
+
Use the \`pinterest_campaign_setup_workflow\` prompt for detailed guidance.
|
|
187
|
+
|
|
188
|
+
Key steps:
|
|
189
|
+
1. Create Campaign (ACTIVE or PAUSED)
|
|
190
|
+
2. Create Ad Groups with targeting_spec
|
|
191
|
+
3. Upload/identify Pinterest Pin to promote
|
|
192
|
+
4. Create Ads referencing the Pin by pin_id
|
|
193
|
+
5. Activate via \`pinterest_bulk_update_status\`
|
|
194
|
+
|
|
195
|
+
⚠️ **Pinterest budget values are in micro-currency** (50000000 = $50.00)
|
|
196
|
+
|
|
197
|
+
Best for: E-commerce, lifestyle, food/beauty brands — high visual discovery and shopping intent
|
|
198
|
+
|
|
199
|
+
### Snapchat (via snapchat-mcp)
|
|
200
|
+
|
|
201
|
+
Use the \`snapchat_campaign_setup_workflow\` prompt for detailed guidance.
|
|
202
|
+
|
|
203
|
+
Key steps:
|
|
204
|
+
1. Create Campaign with objective and budget
|
|
205
|
+
2. Create Ad Squad (Ad Group) with targeting and placement
|
|
206
|
+
3. Upload creative via \`snapchat_upload_media\`
|
|
207
|
+
4. Create Ads referencing the creative
|
|
208
|
+
5. Activate via \`snapchat_bulk_update_status\`
|
|
209
|
+
|
|
210
|
+
⚠️ **Snapchat budget values are in micro-currency** (1 = $0.000001, so $100.00 = 100000000)
|
|
211
|
+
|
|
212
|
+
Best for: Gen Z audiences, AR lenses, video/story formats
|
|
213
|
+
|
|
214
|
+
### Amazon DSP (via amazon-dsp-mcp)
|
|
215
|
+
|
|
216
|
+
Use the \`amazon_dsp_campaign_setup_workflow\` prompt for detailed guidance.
|
|
217
|
+
|
|
218
|
+
Key steps:
|
|
219
|
+
1. Create Order (equivalent to Campaign) with flight dates and budget
|
|
220
|
+
2. Create Line Item with targeting and bid
|
|
221
|
+
3. Create Creative and attach to Line Item
|
|
222
|
+
4. Activate Order
|
|
223
|
+
|
|
224
|
+
⚠️ **Amazon DSP budget values are in dollars** ($100.00 = 100.00)
|
|
225
|
+
|
|
226
|
+
Best for: Retail/commerce intent, first-party Amazon audience data, programmatic display
|
|
227
|
+
|
|
228
|
+
---
|
|
229
|
+
|
|
230
|
+
## Step 5: Budget Value Reference
|
|
231
|
+
|
|
232
|
+
Critical — each platform uses different units:
|
|
233
|
+
|
|
234
|
+
| Platform | Unit | $100.00 Budget | $5.00 Bid | Best For |
|
|
235
|
+
|----------|------|---------------|-----------|----------|
|
|
236
|
+
| **DV360** | Micros | 100000000 | 5000000 | Programmatic display/video |
|
|
237
|
+
| **TTD** | Dollars | 100.00 | 5.00 | Programmatic DSP |
|
|
238
|
+
| **Google Ads** | Micros | 100000000 | 5000000 | Search intent |
|
|
239
|
+
| **Meta** | Cents | 10000 | 500 | Social retargeting |
|
|
240
|
+
| **LinkedIn** | Dollars | 100.00 | 5.00 | B2B professional audiences |
|
|
241
|
+
| **TikTok** | Dollars | 100.00 | 5.00 | Short-form video, Gen Z |
|
|
242
|
+
| **Pinterest** | Micro-currency | 100000000 | 5000000 | Visual discovery, shopping |
|
|
243
|
+
| **Snapchat** | Micro-currency | 100000000 | 5000000 | Gen Z, AR/video |
|
|
244
|
+
| **Amazon DSP** | Dollars | 100.00 | 5.00 | Retail/commerce intent |
|
|
245
|
+
|
|
246
|
+
---
|
|
247
|
+
|
|
248
|
+
## Step 6: Phased Launch
|
|
249
|
+
|
|
250
|
+
Don't activate all platforms simultaneously. Launch in phases to monitor:
|
|
251
|
+
|
|
252
|
+
### Phase 1: Pilot (Week 1)
|
|
253
|
+
- Launch on **one platform** (e.g., Google Ads for conversion, Meta for awareness)
|
|
254
|
+
- Allocate 25% of total budget
|
|
255
|
+
- Establish baseline CPA/ROAS
|
|
256
|
+
|
|
257
|
+
### Phase 2: Expand (Week 2)
|
|
258
|
+
- Add **second platform** (e.g., Meta or TTD)
|
|
259
|
+
- Compare performance with Phase 1 baseline
|
|
260
|
+
- Adjust bids based on early results
|
|
261
|
+
|
|
262
|
+
### Phase 3: Full Launch (Week 3+)
|
|
263
|
+
- Activate remaining platforms
|
|
264
|
+
- Use \`cross_platform_performance_comparison\` prompt to monitor
|
|
265
|
+
- Reallocate budget based on performance data
|
|
266
|
+
|
|
267
|
+
---
|
|
268
|
+
|
|
269
|
+
## Step 7: Cross-Platform Tracking
|
|
270
|
+
|
|
271
|
+
Set up consistent conversion tracking across platforms:
|
|
272
|
+
|
|
273
|
+
1. **UTM parameters**: Use consistent UTM source/medium/campaign across all platforms
|
|
274
|
+
2. **Conversion pixels**: Ensure all platforms track the same conversion events
|
|
275
|
+
3. **Attribution window**: Note that each platform uses different attribution models — cross-platform CPA comparisons are directional
|
|
276
|
+
|
|
277
|
+
---
|
|
278
|
+
|
|
279
|
+
## Post-Launch Monitoring
|
|
280
|
+
|
|
281
|
+
After all platforms are live:
|
|
282
|
+
|
|
283
|
+
1. **Daily**: Check pacing on each platform
|
|
284
|
+
2. **Weekly**: Run \`cross_platform_performance_comparison\` to compare metrics
|
|
285
|
+
3. **Bi-weekly**: Reallocate budget from underperformers to top performers
|
|
286
|
+
4. **Monthly**: Review overall campaign ROAS and adjust strategy
|
|
287
|
+
|
|
288
|
+
---
|
|
289
|
+
|
|
290
|
+
## Gotchas
|
|
291
|
+
|
|
292
|
+
- **Create campaigns PAUSED/DRAFT on all platforms first**, then activate in a controlled sequence
|
|
293
|
+
- **Budget units differ per platform** — double-check the conversion table above
|
|
294
|
+
- **Targeting alignment**: Try to match audiences across platforms as closely as possible for valid comparisons
|
|
295
|
+
- **Creative formats differ**: Each platform has different ad format requirements — plan creative assets accordingly
|
|
296
|
+
- **Time zones**: Campaigns on different platforms may use different timezone settings — align flight dates carefully
|
|
297
|
+
`;
|
|
298
|
+
}
|
|
299
|
+
//# sourceMappingURL=cross-platform-campaign-setup.prompt.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"cross-platform-campaign-setup.prompt.js","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,gCAAgC,GAAW;IACtD,IAAI,EAAE,+BAA+B;IACrC,WAAW,EACT,oXAAoX;IACtX,SAAS,EAAE;QACT;YACE,IAAI,EAAE,aAAa;YACnB,WAAW,EAAE,wEAAwE;YACrF,QAAQ,EAAE,KAAK;SAChB;QACD;YACE,IAAI,EAAE,WAAW;YACjB,WAAW,EACT,yFAAyF;YAC3F,QAAQ,EAAE,KAAK;SAChB;KACF;CACF,CAAC;AAEF,MAAM,UAAU,oCAAoC,CAAC,IAA6B;IAChF,MAAM,WAAW,GAAG,IAAI,EAAE,WAAW,IAAI,eAAe,CAAC;IACzD,MAAM,SAAS,GAAG,IAAI,EAAE,SAAS,IAAI,YAAY,CAAC;IAElD,OAAO;;kBAES,WAAW;eACd,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAiCJ,WAAW;kBACb,WAAW;yBACJ,WAAW;mBACjB,WAAW;uBACP,WAAW;qBACb,WAAW;wBACR,WAAW;sBACb,WAAW;wBACT,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyOlC,CAAC;AACF,CAAC"}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
import type { Prompt } from "@modelcontextprotocol/sdk/types.js";
|
|
2
|
+
export declare const crossPlatformPerformancePrompt: Prompt;
|
|
3
|
+
export declare function getCrossPlatformPerformanceMessage(args?: Record<string, string>): string;
|
|
4
|
+
//# sourceMappingURL=cross-platform-performance.prompt.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"cross-platform-performance.prompt.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/cross-platform-performance.prompt.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAQjE,eAAO,MAAM,8BAA8B,EAAE,MAY5C,CAAC;AAEF,wBAAgB,kCAAkC,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CA8JxF"}
|