@cesteral/ttd-mcp 1.0.0

package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js

@@ -0,0 +1,245 @@
+export const campaignSetupWorkflowPrompt = {
+    name: "ttd_campaign_setup_workflow",
+    description: "Step-by-step workflow for creating a complete TTD campaign hierarchy (Advertiser → Campaign → Ad Group → Ad)",
+    arguments: [
+        {
+            name: "advertiserId",
+            description: "TTD Advertiser ID to create the campaign under",
+            required: true,
+        },
+    ],
+};
+export function getCampaignSetupWorkflowMessage(args) {
+    const advertiserId = args?.advertiserId || "{advertiserId}";
+    return `# TTD Campaign Setup Workflow
+
+## Context
+- Advertiser ID: \`${advertiserId}\`
+- Platform: The Trade Desk (TTD API v3)
+
+This workflow guides you through creating a full campaign hierarchy. Each step depends on the previous one.
+
+---
+
+## Step 1: Verify the Advertiser
+
+Before creating anything, confirm the advertiser exists and note its currency.
+
+\`\`\`
+Tool: ttd_get_entity
+Input: { "entityType": "advertiser", "entityId": "${advertiserId}" }
+\`\`\`
+
+**Check**: Note the \`CurrencyCode\` — all budgets must use this currency.
+
+> Fetch \`entity-schema://advertiser\` for full field reference.
+
+---
+
+## Step 2: Create the Campaign
+
+\`\`\`
+Tool: ttd_create_entity
+Input: {
+  "entityType": "campaign",
+  "advertiserId": "${advertiserId}",
+  "data": {
+    "CampaignName": "Your Campaign Name",
+    "AdvertiserId": "${advertiserId}",
+    "Budget": { "Amount": 50000, "CurrencyCode": "USD" },
+    "StartDate": "2025-03-01T00:00:00",
+    "EndDate": "2025-03-31T23:59:59",
+    "PacingMode": "PaceAhead"
+  }
+}
+\`\`\`
+
+**Save**: Note the returned \`CampaignId\` — you'll need it for ad groups.
+
+> Fetch \`entity-examples://campaign\` for more campaign creation patterns.
+
+### Common Gotchas
+- \`StartDate\` must be in the future
+- \`Budget.Amount\` is **lifetime** budget, not daily
+- \`PacingMode\` defaults to \`Off\` if omitted — usually you want \`PaceAhead\`
+
+---
+
+## Step 3: Create Ad Group(s)
+
+Ad groups contain targeting and bidding configuration.
+
+\`\`\`
+Tool: ttd_create_entity
+Input: {
+  "entityType": "adGroup",
+  "advertiserId": "${advertiserId}",
+  "data": {
+    "AdGroupName": "Your Ad Group Name",
+    "CampaignId": "{CampaignId from Step 2}",
+    "AdvertiserId": "${advertiserId}",
+    "RTBAttributes": {
+      "BudgetSettings": {
+        "Budget": { "Amount": 10000, "CurrencyCode": "USD" },
+        "DailyBudget": { "Amount": 500, "CurrencyCode": "USD" },
+        "PacingMode": "PaceAhead"
+      },
+      "BaseBidCPM": { "Amount": 5.00, "CurrencyCode": "USD" },
+      "MaxBidCPM": { "Amount": 12.00, "CurrencyCode": "USD" }
+    }
+  }
+}
+\`\`\`
+
+**Save**: Note the returned \`AdGroupId\`.
+
+> Fetch \`entity-schema://adGroup\` for targeting options (geo, audience, site).
+
+### Common Gotchas
+- \`RTBAttributes\` is **required** — must include \`BudgetSettings\` and \`BaseBidCPM\`
+- Ad group budget cannot exceed parent campaign budget
+- Targeting (geo, audience, device) is set at the ad group level, not the ad level
+
+---
+
+## Step 4: Create Creative(s) (if needed)
+
+Creatives must exist before ads can reference them.
+
+\`\`\`
+Tool: ttd_create_entity
+Input: {
+  "entityType": "creative",
+  "advertiserId": "${advertiserId}",
+  "data": {
+    "CreativeName": "Banner 300x250 - Version A",
+    "AdvertiserId": "${advertiserId}",
+    "CreativeType": "Banner",
+    "Width": 300,
+    "Height": 250,
+    "Tag": "<script src='https://cdn.example.com/ad.js'></script>",
+    "LandingPageUrl": "https://www.example.com/landing",
+    "IsHTTPS": true
+  }
+}
+\`\`\`
+
+**Save**: Note the returned \`CreativeId\`.
+
+> Fetch \`entity-schema://creative\` for full field reference (Banner, Video, Native types).
+
+---
+
+## Step 5: Create Ad(s)
+
+Ads associate creatives with the ad group.
+
+\`\`\`
+Tool: ttd_create_entity
+Input: {
+  "entityType": "ad",
+  "advertiserId": "${advertiserId}",
+  "data": {
+    "AdName": "Your Ad Name",
+    "AdGroupId": "{AdGroupId from Step 3}",
+    "AdvertiserId": "${advertiserId}",
+    "CreativeIds": ["{CreativeId from Step 4}"],
+    "LandingPageUrl": "https://www.example.com/landing"
+  }
+}
+\`\`\`
+
+### Common Gotchas
+- \`CreativeIds\` must reference **existing** creatives (created in Step 4)
+- Multiple creatives in one ad enables TTD auto-optimization (A/B testing)
+- Ads inherit targeting from their parent ad group
+
+---
+
+## Step 6: Optional — Set Up Ancillary Entities
+
+### Conversion Tracking (for CPA/ROAS campaigns)
+\`\`\`
+Tool: ttd_create_entity
+Input: {
+  "entityType": "conversionTracker",
+  "advertiserId": "${advertiserId}",
+  "data": {
+    "TrackingTagName": "Purchase - Thank You Page",
+    "AdvertiserId": "${advertiserId}",
+    "TrackingTagType": "Standard",
+    "TrackingTagCategory": "Purchase",
+    "ConversionType": "Both"
+  }
+}
+\`\`\`
+
+### Site Lists (for inventory targeting)
+\`\`\`
+Tool: ttd_create_entity
+Input: {
+  "entityType": "siteList",
+  "advertiserId": "${advertiserId}",
+  "data": {
+    "SiteListName": "Premium Publishers",
+    "AdvertiserId": "${advertiserId}",
+    "SiteListType": "Whitelist",
+    "Sites": ["nytimes.com", "bbc.com"]
+  }
+}
+\`\`\`
+
+### Bid Lists (for dimensional bid adjustments)
+\`\`\`
+Tool: ttd_create_entity
+Input: {
+  "entityType": "bidList",
+  "advertiserId": "${advertiserId}",
+  "data": {
+    "BidListName": "Geo Bid Modifiers",
+    "AdvertiserId": "${advertiserId}",
+    "BidListDimension": "GeoRegion",
+    "BidListAdjustmentType": "PercentageAdjustment",
+    "BidListEntries": [
+      { "DimensionValue": "US-CA", "AdjustmentValue": 50, "IsEnabled": true }
+    ]
+  }
+}
+\`\`\`
+
+---
+
+## Step 7: Verify the Hierarchy
+
+Confirm everything was created correctly:
+
+1. List campaigns: \`ttd_list_entities\` with \`{ "entityType": "campaign", "advertiserId": "${advertiserId}" }\`
+2. List ad groups: \`ttd_list_entities\` with \`{ "entityType": "adGroup", "campaignId": "{CampaignId}" }\`
+3. List ads: \`ttd_list_entities\` with \`{ "entityType": "ad", "filter": { "AdGroupId": "{AdGroupId}" } }\`
+
+---
+
+## Success Checklist
+
+- [ ] Advertiser verified with correct currency
+- [ ] Campaign created with budget and flight dates
+- [ ] Ad group created with bidding, targeting, and channel settings
+- [ ] Creative(s) created (Banner, Video, or Native)
+- [ ] Ad(s) created with creative associations
+- [ ] (Optional) Conversion tracker deployed for CPA/ROAS
+- [ ] (Optional) Site lists configured for inventory targeting
+- [ ] (Optional) Bid lists configured for dimensional optimization
+- [ ] Hierarchy verified via list queries
+
+## Related Resources
+- \`entity-hierarchy://all\` — Entity relationships and parent ID requirements (9 entity types)
+- \`entity-schema://{entityType}\` — Full field reference per entity type
+- \`entity-examples://{entityType}\` — CRUD payload examples
+
+## Bulk Alternative
+For creating multiple campaigns or ad groups at once, use:
+- \`ttd_bulk_create_entities\` — batch create up to 50 items
+- \`ttd_bulk_update_status\` — batch pause/resume after verification
+`;
+}
+//# sourceMappingURL=campaign-setup-workflow.prompt.js.map

package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"campaign-setup-workflow.prompt.js","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,2BAA2B,GAAW;IACjD,IAAI,EAAE,6BAA6B;IACnC,WAAW,EACT,8GAA8G;IAChH,SAAS,EAAE;QACT;YACE,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,gDAAgD;YAC7D,QAAQ,EAAE,IAAI;SACf;KACF;CACF,CAAC;AAEF,MAAM,UAAU,+BAA+B,CAAC,IAA6B;IAC3E,MAAM,YAAY,GAAG,IAAI,EAAE,YAAY,IAAI,gBAAgB,CAAC;IAE5D,OAAO;;;qBAGY,YAAY;;;;;;;;;;;;;oDAamB,YAAY;;;;;;;;;;;;;;;qBAe3C,YAAY;;;uBAGV,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBA4Bd,YAAY;;;;uBAIV,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAiCd,YAAY;;;uBAGV,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;qBAyBd,YAAY;;;;uBAIV,YAAY;;;;;;;;;;;;;;;;;;;;;qBAqBd,YAAY;;;uBAGV,YAAY;;;;;;;;;;;;;qBAad,YAAY;;;uBAGV,YAAY;;;;;;;;;;;;qBAYd,YAAY;;;uBAGV,YAAY;;;;;;;;;;;;;;;;+FAgB4D,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2B1G,CAAC;AACF,CAAC"}

package/dist/mcp-server/prompts/definitions/creative-setup-workflow.prompt.d.ts

@@ -0,0 +1,4 @@
+import type { Prompt } from "@modelcontextprotocol/sdk/types.js";
+export declare const ttdCreativeSetupWorkflowPrompt: Prompt;
+export declare function getTtdCreativeSetupWorkflowMessage(_args?: Record<string, string>): string;
+//# sourceMappingURL=creative-setup-workflow.prompt.d.ts.map

package/dist/mcp-server/prompts/definitions/creative-setup-workflow.prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"creative-setup-workflow.prompt.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/creative-setup-workflow.prompt.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAEjE,eAAO,MAAM,8BAA8B,EAAE,MAI5C,CAAC;AAEF,wBAAgB,kCAAkC,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAgGzF"}

package/dist/mcp-server/prompts/definitions/creative-setup-workflow.prompt.js

@@ -0,0 +1,102 @@
+export const ttdCreativeSetupWorkflowPrompt = {
+    name: "creative_setup_workflow",
+    description: "Step-by-step guide for creating The Trade Desk creatives and attaching them to ad groups",
+};
+export function getTtdCreativeSetupWorkflowMessage(_args) {
+    return `# TTD Creative Setup Workflow
+
+## Overview
+TTD Creative workflow: Create Creative entity → Attach to Ad Group via Ad
+
+---
+
+## Step 1: Explore Creative Schema
+
+\`\`\`
+entity-schema://creative
+\`\`\`
+
+Or check examples:
+\`\`\`
+entity-examples://creative
+\`\`\`
+
+## Step 2: Create a Creative
+
+\`\`\`json
+ttd_create_entity({
+  "entityType": "creative",
+  "data": {
+    "AdvertiserId": "{your_advertiser_id}",
+    "CreativeName": "Display Banner 300x250",
+    "Width": 300,
+    "Height": 250,
+    "CreativeType": "banner",
+    "Url": "https://your-click-url.com",
+    "ImageUrl": "https://your-hosted-banner.jpg",
+    "ClickThroughUrl": "https://your-landing-page.com"
+  }
+})
+\`\`\`
+
+⚠️ **GOTCHA**: TTD requires externally hosted creative assets. Images must be publicly accessible URLs.
+
+**Creative types:** banner, video, native, audio
+
+## Step 3: Create a Video Creative (VAST)
+
+\`\`\`json
+ttd_create_entity({
+  "entityType": "creative",
+  "data": {
+    "AdvertiserId": "{your_advertiser_id}",
+    "CreativeName": "Pre-roll Video",
+    "Width": 1920,
+    "Height": 1080,
+    "CreativeType": "video",
+    "VastXml": "<VAST version=\\"3.0\\">...</VAST>",
+    "ClickThroughUrl": "https://your-landing-page.com"
+  }
+})
+\`\`\`
+
+## Step 4: Preview Creative
+
+\`\`\`json
+ttd_get_ad_preview({
+  "creativeId": "{creativeId_from_step_2}"
+})
+\`\`\`
+
+## Step 5: Create Ad linking Creative to Ad Group
+
+\`\`\`json
+ttd_create_entity({
+  "entityType": "ad",
+  "data": {
+    "AdGroupId": "{your_adgroup_id}",
+    "CreativeId": "{creativeId_from_step_2}",
+    "AdName": "Your Ad Name",
+    "IsEnabled": false
+  }
+})
+\`\`\`
+
+## Common Errors
+
+| Error | Cause | Fix |
+|-------|-------|-----|
+| "Image URL not accessible" | Private URL | Use a publicly accessible URL |
+| "Invalid dimensions" | Wrong size | Match ad group placement dimensions |
+| "VAST parsing failed" | Invalid VAST XML | Validate XML before submitting |
+| "Creative rejected" | Policy violation | Review TTD creative policies |
+
+## Success Criteria
+- [ ] Creative created and ID obtained
+- [ ] Preview URL validated
+- [ ] Ad created linking creative to ad group
+- [ ] Ad enabled when ready to serve
+
+`;
+}
+//# sourceMappingURL=creative-setup-workflow.prompt.js.map

package/dist/mcp-server/prompts/definitions/creative-setup-workflow.prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"creative-setup-workflow.prompt.js","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/creative-setup-workflow.prompt.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,8BAA8B,GAAW;IACpD,IAAI,EAAE,yBAAyB;IAC/B,WAAW,EACT,0FAA0F;CAC7F,CAAC;AAEF,MAAM,UAAU,kCAAkC,CAAC,KAA8B;IAC/E,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8FR,CAAC;AACF,CAAC"}

package/dist/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.d.ts

@@ -0,0 +1,4 @@
+import type { Prompt } from "@modelcontextprotocol/sdk/types.js";
+export declare const crossPlatformCampaignSetupPrompt: Prompt;
+export declare function getCrossPlatformCampaignSetupMessage(args?: Record<string, string>): string;
+//# sourceMappingURL=cross-platform-campaign-setup.prompt.d.ts.map

package/dist/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.d.ts.map

@@ -0,0 +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"}

package/dist/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.js

@@ -0,0 +1,299 @@
+export const crossPlatformCampaignSetupPrompt = {
+    name: "cross_platform_campaign_setup",
+    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.",
+    arguments: [
+        {
+            name: "totalBudget",
+            description: "Total campaign budget across all platforms (e.g., '50000' for $50,000)",
+            required: false,
+        },
+        {
+            name: "objective",
+            description: "Campaign objective: 'awareness', 'consideration', or 'conversion' (default: conversion)",
+            required: false,
+        },
+    ],
+};
+export function getCrossPlatformCampaignSetupMessage(args) {
+    const totalBudget = args?.totalBudget || "{totalBudget}";
+    const objective = args?.objective || "conversion";
+    return `# Cross-Platform Coordinated Campaign Setup
+
+Total Budget: \$${totalBudget}
+Objective: \`${objective}\`
+
+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.
+
+---
+
+## Step 1: Platform Selection
+
+Choose platforms based on your objective and audience:
+
+| Objective | Recommended Platforms | Rationale |
+|-----------|----------------------|-----------|
+| **Awareness** | DV360 + Meta + TikTok + Pinterest | DV360 for programmatic display/video reach, Meta/TikTok for social reach, Pinterest for visual discovery |
+| **Consideration** | DV360 + TTD + Meta + LinkedIn | Broad programmatic reach with social engagement and B2B professional targeting |
+| **Conversion** | Google Ads + Meta + TTD + Amazon DSP | Search intent (Google) + social retargeting (Meta) + programmatic (TTD) + retail intent (Amazon) |
+| **B2B** | LinkedIn + Google Ads + Meta | Professional audience targeting on LinkedIn, search intent, social retargeting |
+| **Gen Z / Video** | TikTok + Snapchat + Meta | Short-form video engagement across Gen Z/Millennial audiences |
+| **Shopping / E-commerce** | Pinterest + Meta + Google Ads + Amazon DSP | Visual discovery + social + search + retail intent |
+| **Full-Funnel** | All 9 platforms | Maximum reach across all touchpoints |
+
+---
+
+## Step 2: Budget Allocation
+
+Split the total budget across platforms. Common allocation strategies:
+
+### Performance-Based (Recommended for existing campaigns)
+Allocate based on historical CPA/ROAS data. Use the \`cross_platform_performance_comparison\` prompt to gather data first.
+
+### Equal Split (New campaigns with no history)
+
+| Platform | Allocation | Budget |
+|----------|-----------|--------|
+| DV360 | 15% | \$${totalBudget} × 0.15 |
+| TTD | 15% | \$${totalBudget} × 0.15 |
+| Google Ads | 15% | \$${totalBudget} × 0.15 |
+| Meta | 15% | \$${totalBudget} × 0.15 |
+| LinkedIn | 10% | \$${totalBudget} × 0.10 |
+| TikTok | 10% | \$${totalBudget} × 0.10 |
+| Pinterest | 10% | \$${totalBudget} × 0.10 |
+| Snapchat | 5% | \$${totalBudget} × 0.05 |
+| Amazon DSP | 5% | \$${totalBudget} × 0.05 |
+
+### Objective-Weighted
+
+| Platform | Awareness | Consideration | Conversion | B2B | Shopping |
+|----------|-----------|---------------|------------|-----|----------|
+| DV360 | 25% | 20% | 10% | 5% | 5% |
+| TTD | 15% | 15% | 15% | 5% | 10% |
+| Google Ads | 5% | 15% | 30% | 20% | 20% |
+| Meta | 20% | 20% | 15% | 15% | 20% |
+| LinkedIn | 5% | 10% | 5% | 35% | 2% |
+| TikTok | 15% | 10% | 10% | 5% | 8% |
+| Pinterest | 10% | 5% | 5% | 0% | 20% |
+| Snapchat | 5% | 5% | 5% | 0% | 5% |
+| Amazon DSP | 0% | 0% | 5% | 15% | 10% |
+
+---
+
+## Step 3: Naming Convention
+
+Use consistent naming across all platforms for easy cross-platform tracking:
+
+**Pattern:** \`{Brand}_{Objective}_{Platform}_{Geo}_{Audience}_{YYYYMM}\`
+
+**Examples:**
+- \`Acme_Conv_DV360_US_Retargeting_202603\`
+- \`Acme_Conv_TTD_US_Retargeting_202603\`
+- \`Acme_Conv_GADS_US_Search_202603\`
+- \`Acme_Conv_META_US_Lookalike_202603\`
+- \`Acme_B2B_LI_US_Professionals_202603\`
+- \`Acme_Aware_TT_US_GenZ_202603\`
+- \`Acme_Shop_PIN_US_ShoppingIntent_202603\`
+- \`Acme_Aware_SNAP_US_GenZ_202603\`
+- \`Acme_Conv_AMZN_US_Retargeting_202603\`
+
+---
+
+## Step 4: Create Campaigns on Each Platform
+
+### DV360 (via dv360-mcp)
+
+Use the \`full_campaign_setup_workflow\` prompt for detailed guidance.
+
+Key steps:
+1. Create Campaign (PAUSED status)
+2. Create Insertion Order (DRAFT status)
+3. Create Line Items (DRAFT status)
+4. Assign targeting
+5. Activate via \`entity_activation_workflow\`
+
+⚠️ **DV360 budget values are in micros** (1,000,000 = $1.00)
+
+### The Trade Desk (via ttd-mcp)
+
+Use the \`ttd_campaign_setup_workflow\` prompt for detailed guidance.
+
+Key steps:
+1. Create Campaign
+2. Create Ad Groups with RTBAttributes
+3. Create Ads and link Creatives
+4. Set availability to "Available"
+
+⚠️ **TTD budget values are in dollars** ($100.00 = 100.00)
+
+### Google Ads (via gads-mcp)
+
+Use the \`gads_campaign_setup_workflow\` prompt for detailed guidance.
+
+Key steps:
+1. Create Campaign Budget
+2. Create Campaign (PAUSED)
+3. Create Ad Groups
+4. Create Keywords (for Search)
+5. Create Responsive Search Ads
+6. Enable campaign
+
+⚠️ **Google Ads budget values are in micros** (1,000,000 = $1.00)
+
+### Meta Ads (via meta-mcp)
+
+Use the \`meta_campaign_setup_workflow\` prompt for detailed guidance.
+
+Key steps:
+1. Create Campaign (PAUSED)
+2. Create Ad Creative
+3. Create Ad Sets with targeting
+4. Create Ads
+5. Activate
+
+⚠️ **Meta budget values are in cents** (5000 = $50.00)
+
+### LinkedIn Ads (via linkedin-mcp)
+
+Use the \`linkedin_campaign_setup_workflow\` prompt for detailed guidance.
+
+Key steps:
+1. Create Campaign Group (ACTIVE or PAUSED)
+2. Create Campaign with targeting criteria and CPM bid
+3. Create Creative linked to the campaign
+4. Activate via \`linkedin_bulk_update_status\`
+
+⚠️ **LinkedIn budget values are in dollars** ($100.00 = 100.00)
+
+Best for: B2B, professional audiences, job title/company/skill targeting
+
+### TikTok Ads (via tiktok-mcp)
+
+Use the \`tiktok_campaign_setup_workflow\` prompt for detailed guidance.
+
+Key steps:
+1. Create Campaign with objective and budget
+2. Create Ad Group with targeting and schedule
+3. Upload creatives via \`tiktok_upload_video\` or \`tiktok_upload_image\`
+4. Create Ads referencing the creative
+5. Enable via \`tiktok_bulk_update_status\`
+
+⚠️ **TikTok budget values are in dollars** ($100.00 = 100.00)
+
+Best for: Short-form video, Gen Z/Millennial audiences, entertainment and lifestyle brands
+
+### Pinterest (via pinterest-mcp)
+
+Use the \`pinterest_campaign_setup_workflow\` prompt for detailed guidance.
+
+Key steps:
+1. Create Campaign (ACTIVE or PAUSED)
+2. Create Ad Groups with targeting_spec
+3. Upload/identify Pinterest Pin to promote
+4. Create Ads referencing the Pin by pin_id
+5. Activate via \`pinterest_bulk_update_status\`
+
+⚠️ **Pinterest budget values are in micro-currency** (50000000 = $50.00)
+
+Best for: E-commerce, lifestyle, food/beauty brands — high visual discovery and shopping intent
+
+### Snapchat (via snapchat-mcp)
+
+Use the \`snapchat_campaign_setup_workflow\` prompt for detailed guidance.
+
+Key steps:
+1. Create Campaign with objective and budget
+2. Create Ad Squad (Ad Group) with targeting and placement
+3. Upload creative via \`snapchat_upload_media\`
+4. Create Ads referencing the creative
+5. Activate via \`snapchat_bulk_update_status\`
+
+⚠️ **Snapchat budget values are in micro-currency** (1 = $0.000001, so $100.00 = 100000000)
+
+Best for: Gen Z audiences, AR lenses, video/story formats
+
+### Amazon DSP (via amazon-dsp-mcp)
+
+Use the \`amazon_dsp_campaign_setup_workflow\` prompt for detailed guidance.
+
+Key steps:
+1. Create Order (equivalent to Campaign) with flight dates and budget
+2. Create Line Item with targeting and bid
+3. Create Creative and attach to Line Item
+4. Activate Order
+
+⚠️ **Amazon DSP budget values are in dollars** ($100.00 = 100.00)
+
+Best for: Retail/commerce intent, first-party Amazon audience data, programmatic display
+
+---
+
+## Step 5: Budget Value Reference
+
+Critical — each platform uses different units:
+
+| Platform | Unit | $100.00 Budget | $5.00 Bid | Best For |
+|----------|------|---------------|-----------|----------|
+| **DV360** | Micros | 100000000 | 5000000 | Programmatic display/video |
+| **TTD** | Dollars | 100.00 | 5.00 | Programmatic DSP |
+| **Google Ads** | Micros | 100000000 | 5000000 | Search intent |
+| **Meta** | Cents | 10000 | 500 | Social retargeting |
+| **LinkedIn** | Dollars | 100.00 | 5.00 | B2B professional audiences |
+| **TikTok** | Dollars | 100.00 | 5.00 | Short-form video, Gen Z |
+| **Pinterest** | Micro-currency | 100000000 | 5000000 | Visual discovery, shopping |
+| **Snapchat** | Micro-currency | 100000000 | 5000000 | Gen Z, AR/video |
+| **Amazon DSP** | Dollars | 100.00 | 5.00 | Retail/commerce intent |
+
+---
+
+## Step 6: Phased Launch
+
+Don't activate all platforms simultaneously. Launch in phases to monitor:
+
+### Phase 1: Pilot (Week 1)
+- Launch on **one platform** (e.g., Google Ads for conversion, Meta for awareness)
+- Allocate 25% of total budget
+- Establish baseline CPA/ROAS
+
+### Phase 2: Expand (Week 2)
+- Add **second platform** (e.g., Meta or TTD)
+- Compare performance with Phase 1 baseline
+- Adjust bids based on early results
+
+### Phase 3: Full Launch (Week 3+)
+- Activate remaining platforms
+- Use \`cross_platform_performance_comparison\` prompt to monitor
+- Reallocate budget based on performance data
+
+---
+
+## Step 7: Cross-Platform Tracking
+
+Set up consistent conversion tracking across platforms:
+
+1. **UTM parameters**: Use consistent UTM source/medium/campaign across all platforms
+2. **Conversion pixels**: Ensure all platforms track the same conversion events
+3. **Attribution window**: Note that each platform uses different attribution models — cross-platform CPA comparisons are directional
+
+---
+
+## Post-Launch Monitoring
+
+After all platforms are live:
+
+1. **Daily**: Check pacing on each platform
+2. **Weekly**: Run \`cross_platform_performance_comparison\` to compare metrics
+3. **Bi-weekly**: Reallocate budget from underperformers to top performers
+4. **Monthly**: Review overall campaign ROAS and adjust strategy
+
+---
+
+## Gotchas
+
+- **Create campaigns PAUSED/DRAFT on all platforms first**, then activate in a controlled sequence
+- **Budget units differ per platform** — double-check the conversion table above
+- **Targeting alignment**: Try to match audiences across platforms as closely as possible for valid comparisons
+- **Creative formats differ**: Each platform has different ad format requirements — plan creative assets accordingly
+- **Time zones**: Campaigns on different platforms may use different timezone settings — align flight dates carefully
+`;
+}
+//# sourceMappingURL=cross-platform-campaign-setup.prompt.js.map

package/dist/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.js.map

@@ -0,0 +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"}

package/dist/mcp-server/prompts/definitions/cross-platform-performance.prompt.d.ts

@@ -0,0 +1,4 @@
+import type { Prompt } from "@modelcontextprotocol/sdk/types.js";
+export declare const crossPlatformPerformancePrompt: Prompt;
+export declare function getCrossPlatformPerformanceMessage(args?: Record<string, string>): string;
+//# sourceMappingURL=cross-platform-performance.prompt.d.ts.map

package/dist/mcp-server/prompts/definitions/cross-platform-performance.prompt.d.ts.map

@@ -0,0 +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"}