需要为联盟营销项目定义绩效仪表盘指标与布局时…

当用户提到联盟项目报表、联盟 KPI、联盟 ROI、收入集中度或仪表盘该放什么时，产出一份仪表盘规格文档（只定义指标，不搭建 BI 工具）。

适用场景

解决思路

1. 先做访谈再写规格：每条消息只问一个问题，尽量用多选题，已答过的跳过；问清业务类型（B2B SaaS、B2C 电商或两者）、项目规模与成熟度（活跃伙伴数、月佣金支出、项目年龄）、读者是谁（高管、运营或两者）及要驱动什么决策、佣金模式及是否有循环佣金、验证/锁定窗口长度与追回政策、归因模型与 cookie 窗口、现有数据源（联盟平台、账单/订单、CRM、数仓）以及伙伴 ID 是否能到达账单或订单、是否按伙伴记录伙伴类型/推广方式、是否按转化记录新客与回头客、刷新能力与工具限制、当前痛点、现有报表节奏与评审会议、首版交付日期、是一次性解决争议问题还是每周使用的复利资产、投入上限（分析师工时、谁负责数据 join、是否可承担长期维护）。
2. 明确说出最后三个答案如何改变选项排序：临近交付日期会把规格钉在订单主轴上并删掉所有需要尚不存在 join 的指标；复利使命会提升客户文件 join、队列视图和按流失调整的伙伴 LTV；投入上限薄会直接删掉建模数仓、品牌竞价告警和创意切片，而不是把它们排在规格底部。
3. 固定事实来源并先写可比性契约——事件定义、日期基准、时区、货币、计数方法——再定义任何指标；之后更改这些会作废全部历史。三种数据基础按单位投入价值排序：效率为 `billing/orders spine > customer-file join > modeled warehouse`，价值为 `modeled warehouse > customer-file join > billing/orders spine`，投入从大到小为 `modeled warehouse > customer-file join > billing/orders spine`；默认选主轴，只有明确决策需要时才升级。
4. 把联盟平台自身导出从事实来源中删除而非降级：那是申报方的数字，省多少工都不值得；平台仍是点击和流量来源，需与资金主轴对账。
5. 选择指标层级集合：业务/头条层、输入/驱动层、健康/护栏层。四个指标是底线而非可选，因为不满足它们就无法通过通过阈值：净项目贡献、销售成本、Top-N 伙伴集中度、B2B 的伙伴来源 MRR/ARR。
6. 底线之外是菜单：取所在细分效率排序的顶部条目（B2B 与 B2C 分开排序，并标明每种排序会饿死什么）；拒绝任何不满足四条好指标标准（可比较、是比率或速率、可理解、能改变行为）的指标；在仪表盘变成什么都显示因而什么都不显示之前停止加条目；删除访谈表明数据不存在的每个指标，并在 Open items 中列出，而不是留在规格里当愿望。
7. 为每个指标写规格行，明确解决所有竞争定义：所选分子、分母、窗口和计数方法写进行里，不留在任何人脑子里。
8. 选择项目数据真正支持的切片维度，按效率顺序：`partner > partner type > product/plan > geography > device > landing page > creative`；伙伴类型不是最便宜的切片，但它是能带来回报的那个，无论如何都要建。
9. 每个受众一个视图：高管视图与运营视图在指标上不同，而不只是详细程度不同。
10. 按层级设置刷新与评审节奏——每个层级有自己的自然节奏；整个仪表盘用一个刷新率是缺陷。
11. 设置告警阈值，每个都有负责人、渠道和预期响应时间；优先使用滚动基线动态阈值而非静态阈值；按效率顺序交付——`reversal-rate spike > single-partner share spike > click-to-conversion anomaly > EPC drop > brand-bidding flag`——在团队注意力耗尽时停止，而不是填满告警条。
12. 从项目自身历史推导基线；不采用任何供应商基准作为基线，已发布数字只用于校准预期。
13. 在组装最终文档前，逐节与用户验证规格——先定义，再视图，再节奏，再告警；用匹配的已做示例作为基础。
14. 检查通过阈值并迭代直到每条都成立：每个头条数字都能由未搭建仪表盘的人按书面公式复现；净项目贡献（已验证佣金加网络/代理费对归因净收入）无需离开顶层视图即可见；Top 伙伴集中度在同一顶层视图可见；仪表盘上每个指标都有具名决策；零个指标的定义无法用一句话陈述；每个未进入规格的指标、维度和告警都出现在 Open items 中并说明什么能让它可计算。
15. 按此工件交付规格：`DASHBOARD SPEC - <program>`，包含 Header（项目、受众、事实来源、周期约定：时区、日期基准、货币、验证窗口）、Metrics（每指标一行：Metric | Definition（公式、窗口、计数方法）| Tier | Source | Visualization | Target | Alert threshold | Provenance）、Views（按受众布局：KPI 磁贴（值 + 相对声明的前期变化）-> 趋势/构成图 -> 排行榜/明细表 -> 告警条）、Dimensions（切片维度）、Cadence（层级 -> 刷新率 + 评审仪式：谁评审、何时、决定什么）、Alerts（登记表：指标 | 触发 | 负责人 | 渠道 | 预期响应时间）、Open items（数据缺口、未确认定义、因数据或投入上限被删的指标和维度及什么能让每个可计算、下版问题）。
16. 在 Header 中记录选择了哪种数据基础以及是什么把它推到那里——后来的读者无法仅从指标行重新推导该选择。
17. 遵守基本规则：只报告已验证/已批准佣金和净收入，绝不报告毛额；每个指标给一句话定义，命名分子、分母、窗口、时区和计数方法；为每个基准打来源标签（供应商、行业组织、综合、项目自身推导基线）；绝不把伙伴来源和伙伴影响收入相加，作为两个独立且有上限的数字报告；绝不比较验证窗口不同的两个周期；把欺诈和合规信号与绩效放在同一视图，绝不放在单独工具中。
18. 区分 B2B SaaS 与 B2C 电商：两者同样适用可比性契约、指标分层、集中度分析、节奏纪律、告警设计和已验证而非毛额报告；真正不同的是收入对象（B2B 跟踪伙伴来源 MRR/ARR 和按流失调整的伙伴 LTV；B2C 跟踪订单级 CPA、AOV 和购物篮构成）、漏斗（B2B 增加试用转付费作为第二转化阶段以及交易登记和 MQL/SQL 管道阶段；B2C 是点击到订单，新客是额外维度）、窗口（B2B cookie 窗口 60-180 天，B2C 默认约 30 天，优惠券/返现流量更短；窗口范围由 `mbfinotti/partnerships-skills@affiliate-commission-structure` 拥有，按其数字读窗口）、反转驱动（B2B：试用失败、退款、降级、流失，循环佣金使反转成为每周期事件；B2C：退货窗口内的退货和拒付）。
19. 避免并修复这些失败模式：虚荣指标上头条（每个指标需具名决策，把计数降为诊断）；报告毛佣金而非已验证（头条只用已验证/已批准，待处理单独显示）；仅最后点击的项目 ROI（增加新客占比和增量测试，分开报告来源与影响）；无集中度视图（高管视图显示 Top-1/5/10% 占比，每季度评审）；待处理和已批准状态混合（可比性契约按指标固定状态）；忽略反转滞后（只比较完全验证的周期，标记不成熟周期）；比较验证窗口不同的周期（绝不比较，在每个图表上标注窗口变化）；把子网络算作多个伙伴（每次转化只计一个受信实体，子网络单独拆分）；来源与影响相加（两个有上限数字，同时符合时来源优先）；销售成本排除网络/代理费（销售成本包括佣金、网络、代理和投放费）；采用供应商基准作为项目基线（从项目自身历史推导基线，供应商数字只作校准）；静态告警阈值（滚动基线动态阈值，带负责人、渠道、响应时间）；指标无决策（在规格行中命名决策或删除指标）。
20. 如果运行环境有持久记忆，记住可比性契约、商定的指标定义和推导基线，以便后续运行从它们开始而不是重新协商。
21. 按需阅读参考文件：写指标规格行时读 `references/metric-definitions.md`；指定 ROI 指标或判断结账邻近伙伴时读 `references/roi-and-incrementality.md`；添加集中度视图、生命周期阶段和招募队列分析时读 `references/concentration-and-cohorts.md`；布局视图、选择维度和设计节奏与告警时读 `references/layout-cadence-and-alerts.md`；塑造交付物时读 `references/worked-examples.md`（一个 B2B SaaS 规格、一个 B2C 电商规格、一个反面示例）。

适用边界 · 注意事项

• 不要用于单个创作者活动的衡量计划——应使用 mbfinotti/partnerships-skills@influencer-measurement-framework。
• 不要用于一次付款运行发放前的准确性审计——应使用 mbfinotti/partnerships-skills@affiliate-payout-audit；本技能跟踪持续项目而非单次运行。
• 不要用于定义欺诈规则——应使用 mbfinotti/partnerships-skills@affiliate-fraud-detection；本仪表盘只呈现其信号。
• 不要用于 B2B 渠道伙伴记分卡和 QBR 结构——应使用 mbfinotti/partnerships-skills@partner-performance。
• 不要用于验证窗口和追回背后的合同条款——应使用 mbfinotti/partnerships-skills@affiliate-program-terms。