怎么制定埋点方案？

简短回答

打开 全端分析 › 数据管理 › 埋点方案，为每个打算采集的事件点「新建事件」：事件名、显示名、分类、平台、触发时机、属性（含类型、是否必填和示例）、负责人、开发和状态。随着开发和验收推进，把状态从「待评审」改到「开发中」「验收中」「已上线」。打开「实时验证（近 24 h）」，看每个事件是否在上报、必填属性是否齐全。

埋点方案是写埋点代码之前就商定好的事件和属性清单。它让网站、App 和服务端的命名保持一致，也让开发和分析有同一份可以核对的依据。

开始之前

1. 从问题出发，而不是从事件出发。 先列出团队要回答的 5–10 个问题（比如「试用用户在付费前卡在哪里？」），再列出回答它们需要的事件。
2. 统一命名。 用一种风格，比如蛇形的「对象_动作」：signup_completed、report_exported。不要把取值写进名字（clicked_blue_button），改用属性。
3. 看看已经有什么。 自动采集和预置事件（页面浏览、屏幕、点击、App 启动）可能已经覆盖了一部分。

新建方案条目

也可以「导入」CSV 或之前导出的 JSON。按事件名匹配，可选已存在的条目覆盖或跳过。CSV 里属性用 | 分隔，必填属性前加 *。

如果事件已经在上报，点「从事件定义生成」，用已有的事件定义补全方案。同名条目不会被覆盖。

跟踪交付状态

「同步到事件定义」把方案条目和已有的事件定义关联起来；状态为「已上线」的条目会把对应定义标为生效。事件定义本身在 数据管理 › 事件收件箱 的「事件定义」页签，待认领的事件也在那里。

用实时验证核对事件

打开「实时验证（近 24 h）」，会多出两列：近 24 小时命中次数和必填属性完整度。把条目改成「已上线」之前先看一眼：

• 没有命中： 事件没触发，或者名字和方案不一致。
• 完整度低： 部分事件上报时缺了必填属性。这只是提示，不会拦截事件。

这个页面没有扫码验证，只看近 24 小时的计数。要拦截或隔离错误数据，见属性定义和 数据管理 › 数据质量。

共享方案

「导出 XLSX」交给开发，或附到工单里。项目里任何人都能查看方案；新建、编辑、导入、同步和删除需要分析师及以上角色。删除方案条目不会删除事件定义或任何数据。

相关

• 事件收件箱
• 追踪自定义事件
• 数据分类体系