name: launch-ad-campaign description: "Create and launch a paid ad campaign on Google, Meta, LinkedIn, or TikTok through the connected ad-platform MCP — campaign structure, audience targeting, bid strategy, negative targeting, creative quality scoring, compliance review, and a post-launch monitoring schedule. A mandatory execution gate shows the full spend summary and requires an explicit typed yes before anything goes live; budgets over brand thresholds force re-confirmation and every approval is recorded via approval-manager.py. Triggers on "/digital-marketing-pro:launch-ad-campaign", "launch the Google Ads campaign", "put these Meta ads live", "start the LinkedIn campaign tomorrow", "deploy our TikTok ads". Reads the brand profile's budget thresholds, guidelines, and agency SOPs; it is the paid-ads subset that /digital-marketing-pro:launch-campaign delegates to." disable-model-invocation: false argument-hint: "[platform]"

/digital-marketing-pro:launch-ad-campaign

Purpose

Create and launch a paid advertising campaign on the specified ad platform with proper campaign structure, audience targeting, bid strategy, budget controls, and compliance checks. Includes mandatory budget safeguards that require explicit re-confirmation when spend exceeds brand thresholds, and sets up post-launch monitoring to catch early performance issues before budget is wasted on underperforming configurations.

Execution gate (MANDATORY — cannot be skipped)

1. Present the full preview — recipients / spend / changes / compliance — as an Execution Summary before touching any live system.
2. The user must type yes (or an equivalent explicit approval). ANY other input — ambiguous, implied, partial, or absent approval — cancels the run.
3. Never proceed on ambiguous input. Never auto-retry a failed execution; a failure needs human review before any re-run.
4. Record the approval with python "${CLAUDE_PLUGIN_ROOT}/scripts/approval-manager.py" --brand {slug} --action create-approval --data '{"risk_level":"<tier>","summary":"..."}' before executing, then python "${CLAUDE_PLUGIN_ROOT}/scripts/approval-manager.py" --brand {slug} --action mark-executed --id {approval_id} after the platform confirms success.

Executing through the official ad-platform MCP servers (checked 2026-10-04)

The platforms now publish their own MCP servers (catalog: .mcp.json.connectors-reference; details and sources: CONNECTORS.md → "Official ad-platform and CRM MCP servers"). None is active by default. They change how step 12 runs, never whether the gate above runs.

| Server | What DMP may do through it | |---|---| | meta-ads — Meta Ads AI Connectors, https://mcp.facebook.com/ads (open beta) | Create campaigns, ad sets and ads, set status, read results; catalogs and signal checks | | amazon-ads-mcp — Amazon Ads MCP Server (open beta, partners with API credentials) | Create and update campaigns, read reports. Never delete, even though the server can | | google-ads-mcp — Google's open-source server | Read only. Use it for step 13 (verify the campaign exists with the right settings) and for pacing reports. Google: it "cannot modify bids, pause campaigns, or create new assets". It cannot create or launch anything |

Rules that apply to every write through these servers:

1. The typed approval gate comes first. Execution Summary → the user types yes → approval-manager.py --action create-approval → only then the tool call → approval-manager.py --action mark-executed after the platform confirms. A tool's own confirmation prompt does not replace this gate.
2. Create PAUSED by default. Every new campaign, ad set/ad group and ad is created with status PAUSED, set explicitly in the tool call; don't rely on a server default. Ignore the user preference in step 12 for creation — creation is always PAUSED.
3. Going live is a second, separately approved write. Show a short activation summary (what turns on, daily spend, start time), get a fresh typed yes, record a new approval, then switch to ACTIVE (or schedule the start date). /digital-marketing-pro:doctor / connector_resolver.py reports this as the launch-ads action with create_status: PAUSED.
4. Read-only servers never take writes. The resolver skips any connector whose registry access is read-only for write actions. If only google-ads-mcp is connected, a Google launch stays manual (or uses a write-capable connector) — say so, don't improvise.
5. Log both writes (creation and activation) with execution-tracker.py, including the approval ids.

Input Required

The user must provide (or will be prompted for):

• Ad platform: Where to launch — Google Ads, Meta Ads, LinkedIn Ads, or TikTok Ads — must have the corresponding MCP server connected
• Campaign objective: Primary goal — awareness (reach/impressions), consideration (traffic/engagement/video views), or conversion (leads/sales/app installs/ROAS target)
• Budget: Daily budget or lifetime budget with currency and any maximum CPC or CPA caps the brand requires
• Campaign dates: Start date, end date, and any dayparting or ad scheduling preferences (hours of day, days of week)
• Audience targeting: Demographics (age, gender, income), interests, behaviors, custom audiences (email lists, website visitors), lookalike or similar audiences, and retargeting segments — with geographic and language targeting
• Ad creative: Headlines (multiple variants for responsive ads), descriptions, images or video assets, display URLs, final URLs, and sitelink extensions or callout assets where applicable
• Bid strategy preference: Manual CPC, maximize conversions, target CPA, target ROAS, maximize clicks, or platform-recommended — with any bid caps, floors, or portfolio bid strategy settings
• Conversion tracking: Which conversion events to optimize for, pixel or tag installation status, conversion value assignment, and attribution window preference (7-day click, 1-day view, etc.)
• Negative targeting: Negative keywords (Search), placement exclusions (Display/Video), or audience exclusions to prevent wasted spend on irrelevant traffic
• Landing page: Destination URL(s) with confirmation that the page is live, loads under 3 seconds, and has conversion tracking installed
• Campaign naming convention: Custom naming format or use the brand's standard naming convention from agency SOPs for consistent cross-platform reporting
• Ad extensions or assets: Optional — sitelinks, callout extensions, structured snippets, price extensions, or lead form extensions for Google Ads; instant experience or lead forms for Meta; conversation ads or message ads for LinkedIn
• Remarketing strategy: Optional — whether this campaign should feed into a retargeting funnel, and if so, which audiences to build from campaign engagers (website visitors, video viewers, lead form openers)
• UTM parameters: Tracking parameters for all destination URLs (source, medium, campaign, content), or auto-generate based on campaign naming conventions

Process

1. Load brand context: Read ~/.claude-marketing/brands/_active-brand.json for the active slug, then load ~/.claude-marketing/brands/{slug}/profile.json. Apply brand voice, compliance rules for target markets (skills/context-engine/compliance-rules.md), and industry context. Also check for guidelines at ~/.claude-marketing/brands/{slug}/guidelines/_manifest.json — if present, load restrictions. Check for agency SOPs at ~/.claude-marketing/sops/. If no brand exists, ask: "Set up a brand first (/digital-marketing-pro:brand-setup)?" — or proceed with defaults.
2. Verify budget against brand thresholds: Check the campaign budget against budget_range in profile.json. If the daily or lifetime budget exceeds the brand's defined maximum, halt and require explicit re-confirmation from the user with the exact dollar amount displayed prominently. This safeguard cannot be bypassed — it protects against accidental overspend.
3. Verify ad platform connection: Check which ad platform MCP server is connected and confirm it matches the user's target platform. Verify conversion tracking pixel or tag is active on the brand's website. If not connected, instruct the user to configure the MCP server and tracking first.
4. Build campaign structure: Design the campaign hierarchy per platform conventions — campaign level (objective, budget, schedule), ad group or ad set level (audience, placement, bid), and ad level (creative). Apply naming conventions from brand profile or agency SOPs for clean reporting. Structure ad groups by audience segment, keyword theme, or funnel stage.
5. Configure audience targeting: Set up targeting parameters per platform specs — consult skills/context-engine/platform-publishing-specs.md for audience field mappings, custom audience upload formats, lookalike source requirements, exclusion list configuration, and any platform-specific targeting features (Google affinity audiences, Meta detailed targeting, LinkedIn job title targeting, TikTok interest categories).
6. Conduct compliance review: Check all ad creative against industry-specific requirements — mandatory disclaimers (financial services, healthcare, real estate), prohibited content categories, platform advertising policies (restricted content, special ad categories), and regulated industry restrictions. Flag any creative that needs modification before launch.
7. Score ad creative quality: Evaluate ad creative — headline character limits and keyword relevance, description effectiveness and CTA clarity, image and video specs (dimensions, file size, text overlay percentage for Meta), landing page relevance, and ad-to-landing-page message match. Score against platform-specific quality benchmarks and provide improvement recommendations.
8. Configure bid strategy and budget controls: Set bid strategy per user preference with appropriate guardrails — bid caps or target CPA/ROAS values, budget pacing (standard vs. accelerated), frequency caps to prevent ad fatigue, placement controls (automatic vs. manual), and device targeting adjustments. Verify conversion tracking is active and receiving data if using conversion-based bidding.
9. Apply negative targeting: Configure negative keywords for Search campaigns, placement exclusions for Display and Video, and audience exclusions to prevent overlap and wasted spend. Include brand safety exclusion lists if defined in brand guidelines.
10. Create approval record: Create the record via approval-manager.py --action create-approval with the risk level inside the --data JSON — {"risk_level":"high",...} (use "critical" if daily budget exceeds $1,000). There is no --risk-level flag; see the Execution gate above for the exact command. Generate a campaign summary with projected reach, estimated cost per result, targeting details, creative preview, budget safeguard verification, and compliance status.
11. Present detailed campaign summary: Display the complete campaign configuration for user review — platform, objective, budget with safeguard status, audience size estimates per ad group, creative preview with quality scores, bid strategy and caps, projected reach and cost range, and compliance checklist. Wait for explicit approval.
12. Execute campaign creation via MCP: On approval, create the campaign through the connected ad platform MCP server with status PAUSED (all new campaigns, ad sets/ad groups and ads). Then apply the user's launch preference as a second, separately approved write (see "Executing through the official ad-platform MCP servers"):
    • active: activate now, after a fresh typed yes
    • paused: leave it for review in the platform
    • scheduled: activate on the start date
13. Verify campaign status: After creation, query the platform API to confirm the campaign exists