campaign-status

/digital-marketing-pro:campaign-status

脚本位置。 如果你的宿主未设置 ${CLAUDE_PLUGIN_ROOT}，脚本位于此插件的 scripts/ 文件夹中，与 skills/ 并列。使用 Python 3.10 或更高版本运行：python；如果找不到 python，则使用 python3（macOS 和许多 Linux 系统）。

目的

统一查看所有已连接平台上的活跃营销活动，包括广告、电子邮件、社交媒体和博客，并查看其当前状态、实时效果指标、执行历史，以及待审批事项或计划操作。无需再逐个平台检查，并能在问题演变为麻烦之前发现它们（营销活动已暂停、执行失败、内容过时）。

所需输入

用户必须提供（或将收到提示以提供）：

• 范围：所有活跃营销活动、按名称或 ID 指定的营销活动，或特定平台 （例如，“仅 Google Ads 营销活动”、“电子邮件营销活动”、“名为 Q1-Launch 的营销活动”）
• 详细程度：摘要（每个营销活动一行状态）或详细信息（每个营销活动的完整指标、执行历史和后续操作）
• 时间范围（可选）：执行历史的回溯范围。默认为最近 7 天
• 状态筛选（可选）：按营销活动状态筛选——活跃、已暂停、已计划、已完成、失败。 默认为活跃 + 已暂停 + 已计划
• 排序方式（可选）：按花费、效果、最近时间或状态对营销活动排序。 默认为按平台分组

流程

1. 加载品牌背景信息：读取 ~/.claude-marketing/brands/_active-brand.json 获取当前使用的品牌 slug，然后加载 ~/.claude-marketing/brands/{slug}/profile.json。应用品牌语气、目标市场的合规规则（skills/context-engine/compliance-rules.md）和行业背景信息。另请检查 ~/.claude-marketing/brands/{slug}/guidelines/_manifest.json 中是否有指南文件——如果存在，则加载相关限制。检查 ~/.claude-marketing/sops/ 中是否有代理机构的标准操作流程。如果不存在品牌，请询问：“先设置品牌（/digital-marketing-pro:brand-setup）？”——也可以使用默认设置继续。
2. 列出所有已跟踪的营销活动：执行 python "${CLAUDE_PLUGIN_ROOT}/scripts/campaign-tracker.py" --brand {slug} --action list-campaigns 以获取营销活动登记表，其中包含名称、平台、状态、创建日期和指定的 KPI 目标。
3. 获取执行历史记录：执行 python "${CLAUDE_PLUGIN_ROOT}/scripts/execution-tracker.py" --brand {slug} --action get-history --limit {N} 以获取近期执行日志——包括执行了什么、执行时间、结果（成功/失败/已跳过）、错误消息（如有）， 以及触发执行的用户或自动化程序。
4. 检查待审批事项：执行 python "${CLAUDE_PLUGIN_ROOT}/scripts/approval-manager.py" --brand {slug} --action list-pending 以列出所有上线前仍需审核的营销活动、创意素材或内容。 包括每个待审批项目的提交日期和已等待小时数。
5. 从已连接的 MCP 获取实时指标：对于每个有效营销活动，查询相关平台 MCP （google-ads、meta-marketing、linkedin-marketing、tiktok-ads、mailchimp 等）以获取当前表现：
   • 支出：总支出、每日支出、已用预算
   • 效果：展示量、点击量、CTR、转化量、CPA、ROAS
   • 互动：打开率、点击率、退信率、视频观看量
   • 平台专属指标：质量得分、相关性得分、送达率
6. 按平台和状态汇总：按平台和状态对营销活动分组，计算各平台的总计 （营销活动总数、总支出、总转化量、平均 CPA/ROAS），并标记已跟踪的营销活动 与实时平台报告之间的任何差异。
7. 计算实际表现与 KPI 的差距：对于每个设有目标的有效营销活动，计算主要 KPI 的实际值与目标值 之间的差距。分类如下：
   • 进展顺利（绿色）：达到或超出目标
   • 存在风险（黄色）：与目标的差距在 15% 以内且趋势为负
   • 落后（红色）：未达目标，差距超过 15%
8. 标记需要处理的问题：找出需要采取行动的问题：
   • 营销活动意外暂停或被平台暂停（违反政策、账单问题）
   • 执行失败并出现错误
   • 营销活动超过计划结束日期仍在运行
   • 超过 7 天没有活动的过时营销活动
   • 营销活动的预算消耗进度超出计划 20% 以上
   • 等待超过 48 小时的审批积压
9. 汇总下一步计划操作：列出执行日志中的即将安排事项，包括计划上线、预算变更、创意素材轮换、 A/B 测试完成或自动优化，并注明日期和依赖项。

输出

结构化的营销活动状态仪表板，包含：

• 营销活动摘要表：营销活动名称、平台、状态（投放中/已暂停/已排期/已完成/失败）、 运行天数、总支出、关键指标（转化次数或潜在客户数）、CPA 或 ROAS，以及健康状况指示器（绿色/黄色/红色）
• 按平台分组的投放中营销活动：按平台分组的视图，包含平台级汇总数据——营销活动数量、总支出、 总转化次数、平均 CPA、平均 ROAS，以及平台健康状态
• 执行历史记录（最近 7 天）：按时间顺序记录已采取的操作——营销活动启动、暂停、预算 变更、创意替换、出价调整、邮件发送——并注明时间戳、结果和执行者（手动或自动）
• 待审批事项：列出等待审核的项目，包括申请人姓名、提交日期、类型（创意、 营销活动启动、预算变更、内容）、等待时长（小时），以及该项目的直接引用
• 与 KPI 的表现对比：针对每个投放中的营销活动，将实际表现与创建营销活动时设定的 KPI 目标进行对比—— 达标、有风险或落后，并注明偏差百分比和趋势方向
• 标记的问题：按优先级排列的待处理问题列表，包含严重程度（严重/警告/提示）、 描述、受影响的营销活动以及建议的解决方案
• 下一步排期操作：即将执行的自动或计划操作，包括日期、描述、依赖项 和负责人
• 快速操作：根据当前状态建议的即时后续步骤——审批待处理事项、调查 失败、暂停表现不佳的营销活动、扩大表现优异的营销活动、延长成功的营销活动

使用的 Agent

• execution-coordinator — 检索执行历史、管理审批队列、跟踪排期操作、汇总跨平台状态，以及标记问题
• analytics-analyst — 解读实时表现指标、对比 KPI、评估营销活动健康状况，以及基于表现提供建议