/digital-marketing-pro:campaign-status

/digital-marketing-pro:campaign-status

Script location. If your host does not set ${CLAUDE_PLUGIN_ROOT}, the scripts are in this plugin's scripts/ folder, next to skills/. Run them with Python 3.10 or newer: python, or python3 where python is not found (macOS, many Linux systems).

Purpose

Provide a unified view of all active campaigns across every connected platform — ads, email, social, blog — with their current status, live performance metrics, execution history, and any pending approvals or scheduled actions. Eliminates the need to check each platform individually and surfaces issues (paused campaigns, failed executions, stale content) before they become problems.

Input Required

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

• Scope: All active campaigns, a specific campaign by name or ID, or a specific platform (e.g., "Google Ads campaigns only", "email campaigns", "campaign named Q1-Launch")
• Detail level: Summary (one-line status per campaign) or detailed (full metrics, execution history, and next actions per campaign)
• Time window (optional): How far back to include execution history. Defaults to last 7 days
• Status filter (optional): Filter by campaign status — active, paused, scheduled, completed, failed. Defaults to active + paused + scheduled
• Sort order (optional): Sort campaigns by spend, performance, recency, or status. Defaults to platform grouping

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. List all tracked campaigns: Execute python "${CLAUDE_PLUGIN_ROOT}/scripts/campaign-tracker.py" --brand {slug} --action list-campaigns to get the campaign registry with names, platforms, statuses, creation dates, and assigned KPI targets.
3. Pull execution history: Execute python "${CLAUDE_PLUGIN_ROOT}/scripts/execution-tracker.py" --brand {slug} --action get-history --limit {N} to retrieve recent execution logs — what ran, when it ran, outcome (success/failure/skipped), error messages if any, and the user or automation that triggered it.
4. Check pending approvals: Execute python "${CLAUDE_PLUGIN_ROOT}/scripts/approval-manager.py" --brand {slug} --action list-pending to surface any campaigns, creatives, or content pieces awaiting review before they can go live. Include submission date and age in hours for each pending item.
5. Pull live metrics from connected MCPs: For each active campaign, query the relevant platform MCP (google-ads, meta-marketing, linkedin-marketing, tiktok-ads, mailchimp, etc.) for current performance:
   • Spend: total spend, daily spend, budget consumed
   • Performance: impressions, clicks, CTR, conversions, CPA, ROAS
   • Engagement: open rate, click-through rate, bounce rate, video views
   • Platform-specific: quality score, relevance score, deliverability rate
6. Aggregate by platform and status: Group campaigns by platform and status, calculate platform-level totals