# GreenLeaf 报告数据词典——v1 语义契约

**撰写：**2026-10-29 · **状态：** 合成示例数据生成前已冻结的源规范；英文编辑输入。CSV 是新的合成重建，并非恢复的课程数据。[简报](brief-v1.md) 管理决策；[来源映射](course-source-map.json) 管理出处。不包含真实客户、健康信息或客户账户。 引用证据中的数字保留英文原始资料的格式：逗号分隔千位，句点表示小数，金额以USD计。页面上的摘要指标则可能按所选语言和地区显示。

## 粒度、窗口与归因

一条规范行是英国境内一个 UTC 付费点击日期 × 渠道 × 设备 × 受众 × 创意。十四个日期 × 三个渠道 × 两种设备 × 两种受众 × 两种创意 = **336 行**。原始导出有 **337 行**，包括一条完全重复行。活动属于渠道，不增加维度。

第 1 周：`2026-09-01`–`2026-09-07`（含）。第 2 周：`2026-09-08`–`2026-09-14`（含）。快照：**`2026-09-22T23:59:59Z`**。日期为 UTC，`date` 始终表示付费点击队列日期，而非购买/事件日期。漏斗事件和首次购买在合格付费点击后的七天内观察。不导出精确事件时间戳；七天归因/观察窗口是生成器构造假设。两个完整期间在快照时均已成熟。所有已发布的主行均具有 `is_provisional=false`。

支出、展示量和点击量描述分配给该队列日期的获客活动。落地、测验和购买计数跟随其带来源标签的付费点击队列和设备/受众/创意分组。每个合成的首次购买客户和收入金额只分配一次，分配给七天内的最后一次合格付费点击；所有事件阶段遵循相同的排他性分配。不测量跨设备身份对账。排他性由构造保证，并非由这一聚合文件独立确立。

## 字段

| 字段 | 类型/单位 | 含义与验证 |
|---|---|---|
| `row_id` | 非空字符串 | 稳定且唯一的规范行 ID。原始完全重复行会重复该 ID；具有相同 ID 的冲突行属于错误。 |
| `date` | ISO `YYYY-MM-DD` | UTC 源付费点击队列日期，在九月 1–14 内。 |
| `market` | 枚举 | 仅限 `UK`；范围是虚构英国发布中的付费队列。 |
| `channel` | 枚举 | `google-search`、`linkedin`、`reddit-paid`。排除自然 Reddit 活动。 |
| `campaign_id` | 规范化后枚举 | 每个渠道一个活动；查找见下文。 |
| `device` | 枚举 | `mobile` 或 `desktop`，所分配源付费点击的设备。 |
| `audience_id` | 枚举 | `skeptical` 或 `exploring`；在渠道内构建的互斥分组，并非经过验证的客户特征。 |
| `creative_id` | 枚举 | `traceability` 或 `value`；具有渠道特定格式的信息假设，查找见下文。 |
| `spend_cents` | 非负整数 USD 美分 | 仅媒体成本。不含代理、创意、工具、薪资或其他获客成本。 |
| `impressions` | 非负整数 | 该分组中的获客广告展示量；不是独立人数或频次。 |
| `clicks` | 非负整数 | 分配给该分组的付费点击；不是独立访客。 |
| `landing_sessions` | 非负整数 | 在合格付费点击后七天内观察到的带来源标签落地会话。每个合成漏斗旅程最多保留一次会话。 |
| `quiz_starts` | 非负整数 | 在同一七天窗口内开始的不同保留带来源标签测验旅程；每个旅程保留一次开始。完成率分母。 |
| `quiz_completions` | 非负整数 | 在同一七天窗口内完成的已保留测验旅程；不重复计算完成。 |
| `attributed_new_customers` | 非负整数 | 在七天内完成此构建的测验主导漏斗的首次购买客户，按声明的最后付费点击规则仅分配一次。并非全站新客户。 |
| `attributed_first_purchase_revenue_cents` | 非负整数 USD 美分 | 来自这些客户的首次购买收入，为折扣后、不含税费和运费的金额。本合成示例数据中无退款；无续费收入。为算术清晰，生成器为每位首次购买客户分配 USD $80（8,000 美分）；这是重建假设，并非课程定价或 LTV。 |
| `is_provisional` | 布尔值 | `false` 表示该行的七天观察窗口在声明快照时已成熟。拒绝不支持的字符串/布尔强制转换。 |

逐行不等式：`impressions >= clicks >= landing_sessions >= quiz_starts >= quiz_completions >= attributed_new_customers`。这是显式的简化测验主导漏斗构造，并非广告导出的普遍属性。客户数为零的行必须具有零首次购买收入；客户数为正的行必须具有正收入。这些约束不提供个人层面的证据。

## 规范查找与原始清理

| 渠道 | 规范活动 ID | 显示名称 | 允许的原始活动 ID 别名 |
|---|---|---|---|
| `google-search` | `gl-uk-google-search` | GreenLeaf UK 搜索 | `gl_uk_search` → `gl-uk-google-search` |
| `linkedin` | `gl-uk-linkedin` | GreenLeaf UK LinkedIn | 无 |
| `reddit-paid` | `gl-uk-reddit-paid` | GreenLeaf UK Reddit 付费 | 无 |

受众 `skeptical`：为寻求证据、比较采购来源/剂量证据的买家构建的分组；灵感来自 Oliver 未经验证的人物设定。受众 `exploring`：为探索品类并考虑价值的买家构建的分组。它们既不是真实定向规范，也不是随机化处理分配；不推断任何身份、职业或健康状况。

创意 `traceability`：示例性 “Know what is in every serving”（了解每份产品含有哪些成分） 信息。创意 `value`：示例性 “Compare the value of a clearly dosed serving”（比较成分剂量标示清楚的每份产品的价值） 信息。对于 Google 搜索，这些是文字广告信息假设；对于 LinkedIn，是赞助信息流文案假设；对于 Reddit 付费，是推广帖文案假设。创意 ID 是各渠道内共享的信息类别，并非完全相同的成品广告资产或获批声明。未提供任何功效证明或实际产品认证。

仅删除逐字节/字段完全相等的重复行，并记录其源行 ID。仅规范化已声明的别名并记录数量。未知 ID、意外市场、缺失字段、格式错误的日期、非整数美分/计数、负值、冲突重复行或不可能成立的漏斗都必须验证失败，而不是被静默修复。保留一个有记录的零分母行，以验证不可获得比率的处理。对账原始/规范计数和所有维度总计。合成示例数据生成记录必须标明完全重复行、别名行和零分母行；本词典不假装这些行已经存在。

## 指标与比较规则

在所选队列/维度内求和，然后相除；永远不要对行级比率取平均。保留完整的中间精度。仅在呈现时通过除以 100 将美分显示为 USD。零分母产生**不可获得**，绝不是零/无穷；对零先验值的百分比变化为不可获得。

| 指标 | 定义 | 解释 |
|---|---|---|
| 测验完成率 | `sum(quiz_completions) / sum(quiz_starts)` | 主要漏斗 KPI；付费移动端第 1/2 周必须校准到 45%/28%。 |
| 点击到开始率 | `sum(quiz_starts) / sum(clicks)` | 诊断指标；区别于测验完成率。 |
| 点击到落地率 | `sum(landing_sessions) / sum(clicks)` | 诊断指标，并非经验证的跳出率。 |
| 完成到购买率 | `sum(attributed_new_customers) / sum(quiz_completions)` | 构建的测验主导漏斗诊断指标。 |
| CTR | `sum(clicks) / sum(impressions)` | 优化指标；不是认知度。 |
| CPC（USD） | `sum(spend_cents) / sum(clicks) / 100` | 每次点击媒体成本。 |
| CPM（USD） | `sum(spend_cents) / sum(impressions) * 1000 / 100` | 每 1,000 次展示的媒体成本。 |
| 媒体 CPA（USD） | `sum(spend_cents) / sum(attributed_new_customers) / 100` | 仅媒体代理指标；不是完整 CAC。 |
| 归属首单 ROAS | `sum(attributed_first_purchase_revenue_cents) / sum(spend_cents)` | 收入/支出比率；不是利润、增量或 LTV。 |
| 首次购买收入（USD） | `sum(attributed_first_purchase_revenue_cents) / 100` | 仅付费队列归因；不是对 $60K 整月目标的判定。 |

比率的百分点变化为 `(Week 2 rate - Week 1 rate) * 100`。当第 1 周为正时，相对变化为 `(Week 2 rate / Week 1 rate - 1) * 100`。所撰写的 45% → 28% 等于 −17 个百分点，相对降幅约为 −37.8%；本来源契约未预先确定任何其他结果。

在诊断移动端聚合变动之前，按渠道 × 受众 × 创意对移动端分层。对于分层 `s`，设定固定权重 `w_s = Week 1 starts_s / Week 1 total starts`。比较 `sum(w_s * Week 1 completion_rate_s)` 与 `sum(w_s * Week 2 completion_rate_s)`，并将二者均与观察到的比率比较。发布权重和计数。权重为正的分层若没有定义的第 2 周比率，则完整的固定组合比较不可获得；任何明确受限的公共分层比较都必须披露被排除的计数/权重，且不能静默替代整体。权重为零的分层贡献为零，不需要比率。构成变化与层内变动可能同时存在。二者都不证明原因；这些队列并非随机化。

不完整的快照或临时主行会使两个完整期间不稳定/不可比较。不得将未观察到的结果视为零。具有相同成熟覆盖的单独选择对比必须说明所选日期、排除项和已改变的问题。

## 不可获得的证据与来源冲突

不可获得：完整 CAC、利润、留存、已实现的 12 个月 LTV、认知度、增量、真实全渠道/月度收入、频次、展示份额、跳出率、事件/发布日志、客户访谈和因果解释。来源资产中单独的 4.2% “quiz CVR” 在此处没有足够的共享分母定义；不要导入它。任何截图的损失估计、细分倍数、预算指示或自然到付费的因果叙述都不是得出的合成示例数据结果。关于课程事实与新撰写的假设，请参阅来源映射。