segment-audience

/digital-marketing-pro:segment-audience

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

用途

根据行为、人口统计或参与度标准，在品牌的 CRM 或电子邮件平台中创建或更新受众细分。细分可用于广告定向、电子邮件营销活动、再营销或个性化。确保细分定义明确、规模适当、可在各个平台执行，并记录清晰的标准以便复现，从而让团队准确了解某个细分包含哪些人以及原因。支持 RFM（最近一次消费时间、消费频率、消费金额）建模、基于生命周期的细分，以及用于高级受众策略的预测评分标准。

使用此命令可在营销活动启动前创建定向受众。若要先将新联系人导入 CRM，请使用 /digital-marketing-pro:lead-import。 要将细分成员数据导出到外部工具，请在创建细分后使用 /digital-marketing-pro:data-export。

执行门槛（强制 — 不可跳过）

1. 在接触任何线上系统之前，先提供完整预览——收件人 / 花费 / 变更 / 合规性——作为执行摘要。
2. 用户必须输入 yes（或等效的明确批准）。任何其他输入——含糊、暗示、部分批准或未提供批准——都会取消执行。
3. 不要根据含糊的输入继续执行。执行失败后不得自动重试；再次执行前必须由人工审核。
4. 只有在用户输入 yes 后，才记录批准：python "${CLAUDE_PLUGIN_ROOT}/scripts/approval-manager.py" --brand {slug} --action create-approval --data '{"type":"segment-audience","platform":"<platform>","content_summary":"<one line from the Execution Summary>","risk_level":"<tier>"}'，然后运行 python "${CLAUDE_PLUGIN_ROOT}/scripts/approval-manager.py" --brand {slug} --action approve --id {approval_id}。如果任一命令出错，请停止并报告错误；不得使用其他工具绕过。此记录可证明此操作执行了批准步骤，但无法证明是谁输入了 yes。
5. 执行操作。通过 connector_executor.py 发送的写入操作需要 --approval-id，且仅在匹配的记录未使用且未过期时才会执行（参见 /digital-marketing-pro:execute-action）。通过已连接的 MCP 服务工具执行的写入操作不受该代码检查约束：此类操作依赖用户输入的 yes 和宿主的权限提示。之后运行 python "${CLAUDE_PLUGIN_ROOT}/scripts/approval-manager.py" --brand {slug} --action mark-executed --id {approval_id} --data '{"execution_result":"success"}'（或 failure）。

所需输入

用户必须提供（或系统将提示用户提供）：

• 细分条件：定义细分成员资格的规则——人口统计信息（年龄、地点、职位、公司规模、行业）、行为（访问的页面、打开的邮件、点击的链接、进行的购买、参加的活动）、参与度（最近 30/60/90 天活跃、已流失、存在风险、已流失客户）、购买历史（最近购买时间、购买频率、消费金额、产品类别）、生命周期阶段（订阅者、潜在客户、MQL、客户）或自定义字段筛选条件
• 目标平台：创建细分的位置——CRM（Salesforce、HubSpot、Zoho、Pipedrive）、邮件平台（ActiveCampaign、Mailchimp）或广告平台（Meta Custom Audiences、Google Ads Customer Match、LinkedIn Matched Audiences、TikTok Custom Audiences）
• 细分名称：符合品牌命名规范的描述性标准名称，例如 “High-Value-Customers-Last-90d” 或 “MQL-SaaS-Enterprise-US”
• 细分用途：此细分的用途——邮件营销活动定向、付费广告受众、再营销池、个性化群组、抑制/排除名单、相似受众种子群组或交叉销售/追加销售定向
• 动态或静态：细分应在联系人符合或不再符合条件时自动更新（动态/智能列表），还是在创建时保持固定（静态/快照）——动态细分适用于持续开展的营销活动，静态细分适用于一次性发送或特定时间点的分析
• 刷新频率（如为动态细分）：重新计算细分成员资格的频率——实时（由事件触发）、每天、每周，或在每次营销活动发送前按需刷新
• 排除条件（可选）：明确排除的联系人——已退订、硬退信、竞争对手、内部团队成员、现有客户（用于获客营销活动）、参与其他正在进行的营销活动的联系人（频次控制）或合作伙伴提供的抑制名单
• 最小细分规模（可选）：符合预期用途的最小细分规模——广告平台通常需要 1,000 人以上才能有效投放；相似受众种子群组以 1,000–10,000 人为佳；邮件细分规模则应足以确保 A/B 测试具有统计显著性
• 跨平台同步（可选）：是否将此细分自动同步到其他平台，例如在 CRM 中创建细分后，同时推送到 Meta Custom Audiences 和 Google Ads
• 细分说明：以易读的文字解释细分的用途和条件，供团队存档——与细分一同保存，以便日后查阅和传递知识
• RFM 参数（可选）：如果采用最近购买时间、购买频率和消费金额进行细分——定义每个维度的评分阈值、交易历史的回溯时间范围以及要创建的细分数量（例如 Champions、Loyal、At Risk、Lost）
• 相似受众扩展（可选）：如果此细分将用作相似受众的种子群组——指定扩展百分比（1–10%）和目标平台，以便优化种子群组质量，而不只是规模

流程

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/ 中是否有代理机构的 SOP。如果没有品牌，询问：“先设置品牌？(/digital-marketing-pro:brand-setup)”——或者使用默认设置继续。
2. 确定可用数据源：查询已连接的平台，确定哪些数据可用于细分——CRM 联系人字段和自定义属性、电子邮件参与度指标（打开、点击、退信）、广告平台受众数据、网站行为数据（如果连接了分析 MCP），以及购买/交易记录。明确哪些来源可用于评估哪些条件，并标记无法根据可用数据支持的条件。
3. 构建细分条件逻辑：将用户的条件转换为平台专属的筛选逻辑——AND/OR 条件、嵌套分组、日期范围、相对日期窗口（例如，动态重新计算的“最近 30 天”）、数值阈值、字符串匹配规则和列表成员资格检查。验证所有引用字段都存在于目标平台的架构中。
4. 根据可用数据估算细分规模：在目标平台上运行计数查询或进行估算，预测细分成员数量。如果细分规模过小，不适合预期用途（例如，广告定向少于 1,000 人，电子邮件 A/B 测试少于 100 人），或范围过广（例如，超过总数据库的 80%——这可能意味着筛选不足、定向精度不够），则予以标记。
5. 检查与现有细分的重叠情况：查询平台上的现有细分，找出与当前营销活动所用活跃细分重叠的联系人。展示重叠百分比和重复联系人数量，并根据细分用途和营销活动频次上限规则，建议排除重叠联系人、合并细分或接受重叠。
6. 应用排除条件：添加排除规则——已退订联系人、硬退信、抑制名单、竞争对手、内部团队成员以及用户指定的任何排除项。分别展示每条排除规则对细分规模的影响，以及所有规则累积后的影响。
7. 验证广告平台受众的合规性：如果要同步到广告平台，验证联系人是否已针对广告用途获得适当同意（而不只是电子邮件同意），确认受众符合平台特定要求（Customer Match 所需的哈希电子邮件格式、最低受众规模），并检查是否符合平台服务条款。
8. 创建细分定义载荷：构建平台专属的细分定义——使用平台 API 格式的筛选条件、细分名称、描述、类型（动态/静态）、刷新计划、用于整理的文件夹或标签分配，以及任何跨平台同步配置。
9. 设置审批关卡：将所有细分操作的风险评估为中等。展示细分预览，其中包括易读的条件摘要、估算成员数量、占总数据库的百分比、与现有细分的重叠情况、排除项的影响、示例成员档案（5 位有代表性的联系人）以及创建细分的平台。
10. 获批后，通过平台 MCP 创建细分：通过相应的 MCP 将细分定义推送到目标平台。对于广告平台受众，启动受众同步，等待处理确认并验证匹配率。对于 CRM/电子邮件细分，确认已创建，并核实初始成员数量。
11. 启动跨平台同步（如有请求）：对于多平台细分，将受众推送到其他目标平台——对用于广告平台 Customer Match 上传的电子邮件进行哈希处理，按平台要求格式化电话号码，并启动同步任务。监控匹配率，并标记来源端与目标端数量之间的显著差异。
12. 验证细分创建情况并记录结果：确认已在所有目标平台上成功创建细分——验证成员数量与估算值的差异在可接受范围内，抽查示例成员是否符合条件，确认细分在每个平台的界面中显示正确，并记录任何匹配率差异。将执行记录写入 ~/.claude-marketing/brands/{slug}/logs/segment-log.json。

输出

结构化的受众细分报告，包含：

• 细分 ID 和平台确认信息：细分在目标平台上的唯一标识符、创建时间戳、细分类型（动态／静态），以及平台界面中该细分的直接链接
• 成员数量：应用所有条件和排除规则后，细分中的联系人总数；与初始估算值的对比、占数据库总量的百分比，以及与既定用途的最低规模要求的对比
• 条件文档：所用条件的完整易读说明，包括每条筛选规则、逻辑运算符（AND／OR）、日期范围、数值阈值和排除项；格式应便于团队知识交接和今后维护细分
• 平台筛选逻辑：平台上实际采用的精确筛选配置，包括用于审计、调试和在其他平台上复现的 API 级条件
• 重叠分析：与每个活跃细分的重叠百分比、各细分间的共享联系人数量，以及对重叠是否会导致受众疲劳风险、预算浪费（为触达同一人而重复付费）或属于有意安排（例如，对某个子集进行再营销）的评估
• 排除影响报告：每条排除规则分别移除的联系人数量、累计排除数量，以及最终纳入与排除人数的比例，并按排除原因细分
• 成员资料示例：展示细分中 5 位代表性联系人的关键字段，包括姓名、电子邮件、公司、互动程度、生命周期阶段、评分，以及他们匹配的具体条件
• 跨平台同步状态：如已同步至广告平台，则报告各平台的匹配率、各目标平台的受众规模、处理状态、预计完全填充所需时间，以及应用的哈希或格式转换
• 细分规模趋势（用于更新）：如在更新现有细分，则报告成员数量变化（新增、移除、净变化）、已应用的条件修改，以及过去 5 次刷新中的细分规模趋势（如有）
• 相似受众就绪度：评估该细分是否适合作为相似受众种子，包括规模是否处于最佳范围（1,000-10,000）、互动质量评分、人口统计特征一致性，以及各广告平台建议的相似受众扩展百分比
• 细分质量评分：评估细分的定向精准度，包括条件具体程度（狭窄或宽泛）、细分内的互动程度分布、人口统计特征一致性，以及与完整数据库相比的预测响应率
• 建议的后续步骤：建议的操作包括同步至广告平台以创建相似受众、触发电子邮件培育序列、构建个性化着陆页变体、创建互补的排除细分、为动态细分安排定期刷新，或拆分测试细分条件以进行优化
• 相关细分：可与此新细分合并、配合使用或明确排除的现有细分，并附上重叠百分比和用例建议
• 执行日志：细分处理过程的带时间戳记录，包括平台 API 调用、响应状态、受众生成耗时、匹配率、跨平台同步结果，以及遇到的任何警告或错误

使用的 Agent

• crm-manager — 细分条件逻辑、CRM 数据查询、去重、重叠分析、平台特定筛选条件构建、合规性验证、跨平台同步和细分创建管理
• email-specialist — 基于电子邮件互动的细分条件、抑制名单管理、送达能力考量、频次上限逻辑和电子邮件平台细分优化
• media-buyer — 广告平台受众要求、相似受众种子质量评估、Customer Match 格式设置和广告平台受众同步验证