第4章 埋点方案：事件类型、属性字段、触发时机、上报方式

适用场景

当业务流程已完成节点梳理，需要将业务节点映射为可采集、可存储、可分析的数据埋点时，需进行埋点方案设计。本章适用于以下场景：

• 数据产品经理与业务方初次定义新业务流程的上报需求
• 现有埋点出现漏报、重复、日志丢失，需回查上报方案合理性
• 跨端（Web / App / 小程序）统一埋点规范落地前评审
• 第三方数据分析工具接入前的埋点配置确认

前置条件

• 已完成业务流程节点梳理（参见第3章《业务流程节点识别》）
• 已确定各节点所需指标及统计口径
• 已明确后端数据仓库或分析平台的基本字段约束
• 产品、开发、数据三方负责人已就位

操作步骤

1. 定义事件类型 —— 根据节点行为性质，分配事件（Event）类型。常见类型：click（点击）、view（曝光）、page_view（页面浏览）、submit（表单提交）、custom（自定义）。每个节点对应一个唯一事件 ID。
2. 设计属性字段 —— 为每个事件附加描述性字段。必须包含：event_id、user_id、timestamp、page_url。业务字段按需扩展，如 order_amount、product_id、channel。
3. 确定触发时机 —— 明确事件在何时、何种条件下发出。例如：按钮点击瞬间、页面 DOM 加载完成后、接口返回成功回调中。
4. 选定上报方式 —— 选择同步（同步接口请求）或异步（批量、异步队列）。通常采用异步批量上报，避免阻塞用户操作。
5. 输出埋点方案文档 —— 填入标准模板（见输入输出物），并组织评审。

输入输出物

责任边界

• 数据产品经理：主导埋点方案设计，确保字段覆盖所有指标，组织评审。
• 业务方：提供节点行为描述，验证触发时机是否符合业务逻辑。
• 前端 / 客户端工程师：按方案执行埋点代码，保证事件上报正确。
• 后端工程师：提供接口属性透传，确保用户标识、订单等参数可获取。
• 数据分析师：验收上报数据完整性，输出校验报告。

记录材料

{
  "event_id": "button_click_order",
  "event_type": "click",
  "properties": {
    "user_id": "string",
    "order_id": "string",
    "amount": "number",
    "timestamp": "long"
  },
  "trigger": "onClick",
  "report": "async_batch"
}

异常处理

验收标准

1. 方案完整性：所有已识别的业务节点都对应且只对应一个事件类型，无遗漏、无重复。
2. 字段合法性：每个事件的属性字段均已在埋点字典中定义，无冗余字段或空字段。
3. 触发准确性：通过冒烟测试（如按钮点击、页面曝光）可复现事件，且事件时间戳误差 ≤ 1 秒。
4. 上报稳定性：在 1000 次连续操作压力下，上报成功率 ≥ 99.5%，无阻塞崩溃。
5. 文档可读性：埋点方案文档需通过同行评审，并附测试日志截图作为佐证。