如何进行数据埋点

背景

一、埋点类型

1. 网页浏览
   1. 需求（产品&业务&数据）：某个页面的页面地址
   2. 结果（研发）：无需单独开发，给出页面的url地址即可
   3. 使用（数据）：gopage事件
2. 网页浏览带参
   1. 需求（产品&业务&数据）：某个页面的页面地址，并且给定不同入口的参数
   2. 结果（研发）：需要开发，根据需求中的描述，从不同入口跳转过来的带上对应参数，并且给出页面的url地址即可
   3. 使用（数据）：gopage事件
3. 单独数据埋点
   1. 需求（产品&业务&数据）：埋点触发场景说明，并且给出需要带上的主要参数
   2. 结果（研发）：需要开发，并需要区分前后端（需要统一数据对接协议及接口）
   3. 使用（数据）：根据研发反馈的埋点结果进行数据接入，然后处理使用
4. 业务库同步
   1. 需求（产品&业务&数据）：产品功能及数据需求描述（这类通常是研发评估后确认）
   2. 结果（研发）：无需开发，给定业务数据库类型、地址及表名
   3. 使用（数据）：根据业务数据库类型、地址及表名进行数据接入，然后处理使用

二、埋点事件核心要素

        核心模型(4W1H1R)：哪个用户(Who)在什么时间(When)什么地点(Where)对什么目标(What)做了什么动作(How)产生了什么结果(Result)

• 用户——触发动作的用户，可以是注册用户/访客用户/管理员用户，在某些特定情况下，系统主动产生的动作，也可以将系统看作是一个用户，用户属于不可变维度，如：老师通过企业微信回复消息，对象应该是微信号，而不是老师，从管理视角来说，同一个微信在不同时期可能被不同老师使用，属于不可变维度
• 时间——现实世界的时间，或者目标载体的时间，在观看视频中就同时包含了两条时间线（现实时间和视频时间），游戏也有类似情况
• 地点——现实世界的地点（包括通过ip识别出的地点），或者网页地址等具体页面的地址，以及目标载体在页面中的相对或绝对位置（包括坐标、栏目名称、相对位置等）
• 目标——通常包括两种，一种是控件类，即产品端的可见控件；另一种是资源类，比如课节
• 动作——点击、选择、输入、拖动等使用互联网产品时所需要的常规动作，通常动作和目标会混为一谈，将动作默认为点击，其目标为确认或者取消按钮
• 结果——产生的弹窗内容、页面地址、时间切换结果等等

三、埋点原则

• 如非必要，不要多埋，否则数据管理容易混乱，如：点击按钮一定会发生跳转，则使用跳转后页面的浏览事件，无需单独埋点击事件
• 简单易懂，不要逆人性，降低维护成本，复杂的事情由专业人员来处理，如：页面停留时长，无需业务单独埋点，给出进入页面、离开页面的事件即可，由数据人员加工出停留时长

四、埋点类型选择说明

1. 前端页面的访问浏览PV/UV，直接采用gopage通用事件
   1. 如果前端页面有多个来源入口，且需要区分来源页，需要新增活动入口来源参数entrance，在URL中解析使用，短期内可以自定义命名，长期需要通过渠道管理工具生成渠道参数
2. 前端页面点击事件如果会触发页面跳转（即url会发生变化），则无需埋点，直接采用gopage通用事件即可
   1. 前端点击事件，不触发页面跳转（url无变化），需要根据业务场景确认埋点类型
      1. 如果是关注点击事件产生的后端连带结果（需要在用户上记录对应数据，且退出后重新登录也可能会用到这个数据），则需要对点击后产生的结果进行后端埋点或取对应的业务数据（对应第3点），如：点击“签到”，关注的是签到后获取积分；点击“领取优惠券”，关注的是学生家长领取到对应的优惠券等等
      2. 如果是单纯想看点击事件在前端产生的显示结果（退出后重新登录不会再用到这个显示结果），或者观测点击成功率，则需要单独埋点点击事件，如：复制推荐语、点击视频播放等
   2. 页面滑动事件，需要区分页面内不同模块的曝光情况，因为url无变化，如有数据需求，也需要单独埋点滚动事件，如：双十一主会场页面下，邀请/兑换/积分三个分会场的曝光统计
3. 业务功能已有对应数据，且业务功能依赖对应的数据记录(产品功能上能看到对应的数据变化及结果)，直接使用业务库数据同步结果，如：班主任管理页面中，班主任归属人更改日志记录（班主任管理页面可以看到更改记录），operate_log；签到或邀请获取积分，积分兑换会减少积分，积分的变化记录表，point_log
   1. 已有业务功能数据，但业务功能不依赖对应数据源（有无对产品功能无影响），需要提系统事件埋点需求，业务库停止写入，如：作业练习时长日志记录，session_log
4. 业务库无对应数据，但数据需要记录该操作，且该类操作会影响业务库数据状态，需要提系统事件埋点需求，如：用户公众号取关事件，会影响用户关注公众号状态，wechat_official_account_unsubscribed

注：埋点需要考虑可复用，如：浮窗埋点，需要记录浮窗名称或者浮窗指向链接，便于后续直接区分使用