乐于分享
好东西不私藏

产品经理数据埋点系列④:埋点文档怎么写?

产品经理数据埋点系列④:埋点文档怎么写?
前言

上篇我们聊了如何在 PRD 中写埋点需求——简单场景写在 PRD 里就够了。

但当你面对多端产品、跨团队协作、需要长期维护的数据资产时,一份独立的数据需求文档(DRD)就必不可少。

这篇文章把 DRD 拆开讲清楚:它是什么、包含哪几部分、每一部分怎么写、以及最常见的坑在哪里。

一、先搞清楚 DRD 是什么
什么时候需要独立的 DRD · 四个判断维度

DRD 全称 Data Requirement Document,是一个独立的、可追加的全局维表。

它不是 PRD 里一个叫"数据埋点"的章节,而是一份独立的文档。不同公司有不同叫法——外企和大厂常叫 DRD,有的团队叫"埋点文档"或"事件追踪方案",但本质都一样:定义数据怎么被记录

什么时候需要写独立的 DRD?四个判断维度:

1涉及多端iOS/Android/Web/小程序同时改动
2涉及多团队前端、后端、数据、BI 都要对齐
3指标依赖强数据要长期用于核心指标计算
4需要版本管理数据口径可能随业务多次变更
二、一份 DRD 包含三大部分
DRD 三大结构:版本变更记录 → 全局公共属性 → 业务事件明细
1 版本变更记录

记录每一次改动:版本号、变更日期、修订人、涉及模块、变更类型、详细说明。

为什么重要?数据团队排查历史异常时,能追溯到每一次变更的版本、时间和原因。建议每次发版前更新,不要事后补录

变更类型分三种:

新增       配合新功能新上线的点

修改       原有埋点因业务变化,需追加参数

下线       页面下线或坑位移除,清理冗余,停止上报

2 全局公共属性

如果每个事件都单独写一遍 user_id、设备信息、app_version,不仅重复劳动,还容易写错。在公共属性里统一定义一次,所有事件自动继承。

常用公共属性包括:

属性英文键
属性中文名
数据类型
说明
user_id
用户ID
String
登录用户唯一标识
device_id
设备ID
String
未登录用户区分
platform
平台
String
iOS / Android / Web
app_version
App 版本号
String
如 3.2.1
event_time
事件发生时间
Timestamp
客户端时间戳
3 业务事件明细

这是 DRD 绝对的核心。研发和测试不可能每次发版都核对几百个埋点,只看这张表,就能秒懂这次迭代要写什么代码、测什么流。

完整的事件表包含 7 列:

列名
说明
模块/页面
事件发生在哪个页面
事件中文名
一句话描述用户做了什么
事件ID(英文)
全小写下划线,用于代码和数据平台
触发时机(核心/必填
精确到具体条件:什么时候、什么状态下触发
参数/属性英文键(Key)
上报的参数字段名
参数/属性中文名(Value)
参数的中文含义
参数类型
String / Int / Float 等

以电商购买全链路为例:

detailpage_buy_click
商品详情页·点击立即购买
触发时机:用户点击"立即购买"且前端校验通过的瞬间
参数:product_idsku_id
order_submit_success
订单确认页·点击提交订单
触发时机:成功向后端发起下单请求的瞬间
参数:order_idbuy_type
payment_callback_success服务端上报
支付结果页·服务端支付成功
触发时机:支付渠道异步回调成功
参数:order_idactual_amount
三、一个事件怎么写
一个事件怎么写:明确动作 → 起事件名 → 列属性

以商品详情页「点击立即购买」为例,拆成三步:

1明确用户做了什么

用户点击了"立即购买"按钮。

2起一个唯一的事件名

detailpage_buy_click。全小写,下划线分隔,团队统一风格即可。

3列出要记录的关键信息

选属性的原则:每个属性都应回答一个业务问题

product_id 用户对哪个商品感兴趣  支撑商品热度分析

sku_id 用户选了哪个规格  支撑规格偏好和库存策略

四、DRD 最容易踩的坑
✕ 常见错误
触发时机写「点击按钮」,太模糊
同类内容建多个事件(banner_1banner_2…)
属性不写说明,只有字段名
✓ 正确做法
精确到具体页面、元素、触发条件
一个事件 + 属性区分位置(如 banner_position 枚举)
写清含义、类型、是否必填
写的不是文档,是团队实践。
数据埋点系列往期回顾

EP01|数据埋点到底是什么

EP02|如何设计数据埋点

EP03|PRD 埋点需求怎么写

关注公众号回复 资料,即可获取整理好的埋点文档模板,还有常用的文档合集。

下篇预告:埋点上线后,产品经理怎么验收?

你在写 DRD 时踩过什么坑?评论区聊聊

如果觉得有用,点赞 / 在看 / 转发,一起持续进化