Procházet zdrojové kódy

docs(kb): ADR-13 扩为埋点重构——增补归因绑定字段维度 + 世界杯漏斗案例

tianyu.chu před 4 dny
rodič
revize
20cdddc6f2
1 změnil soubory, kde provedl 15 přidání a 5 odebrání
  1. 15 5
      kb/93-架构决策.md

+ 15 - 5
kb/93-架构决策.md

@@ -526,7 +526,7 @@
 
 - **附口径确认**(2026 PG 实测):302 订单结束(未中卡) 占 2026 的 35%(390万),算消费偏好(拼团类刮刮乐,参与即反映品类偏好,中不中卡不影响信号),dwd 含 302、tdm 统计含未中卡,确认无误。
 
-### ADR-13 埋点事件粒度:行为大类 + 参数化(收敛 event explosion)
+### ADR-13 埋点重构:收敛事件粒度(行为大类+参数化)+ 补齐归因绑定字段
 
 - **状态**:草案(数仓侧主张,待与产品对齐推动;存量事件不动、增量优先)
 
@@ -537,14 +537,24 @@
 
   神策"事件-属性模型"、Amplitude "事件=动词 / 属性=上下文" 均主张少而结构化的事件 + 丰富属性;当前设计是典型 event explosion 反模式。
 
-- **决策**:埋点按**行为大类 + 参数化**重构(数仓主张,推动产品):
+  **2026-06-10 世界杯活动漏斗需求暴露第二类缺陷(信息缺失,非粒度)**:想做世界杯活动转化漏斗,发现 (a) 订单/事件无活动(campaign)绑定字段 → 无法把转化归因到具体活动;(b) 关键交互缺统一参数(page/module/element)→ 无法跨事件拼路径;(c) 业务路径含线下微信群对接(app 浏览 → 微信群与商家对接 → app 下单),中间跳到平台外不可观测。强归因/路径漏斗天然做不了,最终退到拼团通用聚合 UV 漏斗(见 `workspace/20260610` 漏斗 MVP)。结论:埋点除事件爆炸(粒度)外,还缺"业务绑定/归因信息"——故本 ADR 从"事件粒度"扩为"埋点重构"两条腿。微信群那跳是平台外断点,埋点重构也救不了,属业务流程边界。
+
+- **决策**:埋点重构两条腿并行(数仓主张,推动产品/后端):
+
+  **① 收敛事件粒度(行为大类 + 参数化)**
   - 导航/UI 长尾交互(各种 `XxxClick` / `XxxView` / `XxxShow` / `XxxShare`)→ 收敛为通用 `Click` / `View` / `Exposure` / `Share`,页面/区块/元素/位置作**标准化属性**(`page` / `module` / `element` / `position` / `content_id` 等)
   - **核心业务转化事件**(`PayOrder` / `GroupPayOrder` / `SignUp` / 兑换 / 退款)**保留独立事件**——属性丰富、漏斗关键、语义重
-  - **不推倒重来**:存量事件 + 已上线 + 历史数据不动;增量优先(新交互按大类设计),长尾逐步归并,无硬切换
+
+  **② 补齐业务绑定/归因字段**
+  - 关键事件/订单补 `campaign_id`(活动绑定)、`order_source`(订单来源)、统一交互参数(`page`/`module`/`element`/`content_id`)——让转化能归因到活动、平台内路径能拼
+  - **范围边界**:仅解决"平台内可观测"部分;跨端/线下断点(如 app→微信群→app 下单的微信群那跳)是业务流程问题,埋点重构救不了,不在 scope
+
+  **共同前提**
+  - **不推倒重来**:存量事件 + 已上线 + 历史数据不动;增量优先(新交互按大类设计 + 带绑定字段),长尾逐步归并,无硬切换
 
 - **后果**:
-  - 正面:埋点事件集有界;新页面=属性新值、仓库零改动(schema 稳定);ods/dwd 可建统一埋点事实表(标准维度 + typed `params`);跨事件漏斗/热力天然可做;埋点开发 + 数仓改表 + 测试成本同步下降
-  - 负面:需建立并维护参数命名规范(page/module/element/position taxonomy);产品/分析师从"具名事件"转向"属性筛选"有学习成本;过渡期新老并存;部分 BI 漏斗对离散事件更友好
+  - 正面:埋点事件集有界;新页面=属性新值、仓库零改动(schema 稳定);ods/dwd 可建统一埋点事实表(标准维度 + typed `params`);跨事件漏斗/热力天然可做;**补绑定字段后活动转化归因 + 平台内路径漏斗可做(世界杯漏斗需求即受益)**;埋点开发 + 数仓改表 + 测试成本同步下降
+  - 负面:需建立并维护参数命名规范(page/module/element/position taxonomy);**需后端在下单/关键事件落 `campaign_id` / `order_source` 等绑定字段,有改造成本**;产品/分析师从"具名事件"转向"属性筛选"有学习成本;过渡期新老并存;部分 BI 漏斗对离散事件更友好
 
 - **候选方案**:
   - 维持一页一事件:event explosion,仓库随页面无限改——否决(本 ADR 起因)