埋点业务流程规范

半亩书田

已于 2024-09-30 13:55:02 修改

阅读量529

点赞数 5

文章标签：数据库架构大数据

于 2024-09-30 11:14:23 首次发布

本文链接：https://blog.csdn.net/zj1577941227/article/details/142652787

版权

前端或客户端通过调用后端提供的接口，将埋点信息上报（只管上报，不用判断失败）。后端通过队列的方式接收数据，并将数据打印到服务器日志里面。然后大数据再去取日志数据进行解析进行数据统计形成报表。

二、目前现状

2.1 埋点分类


页面路径	记录每一次页面跳转的前后页面路径。并且默认所有页面都必须埋点。数据样例1： "actions":[{"cp":"/pages/home/Home","lp":"/pages/home/Home","ts":"2024-04-13 11:06:19"}] 数据样例2（原生APP专用）： [{"cp":"105","lp":"182","ts":"2024-07-02 22:47:42"}]
自定义事件	根据运营需求，定制化的埋点。目前包含选择、取消、弹窗、其他等。数据样例1： "chooseEvent":[{"c_ts":"2024-04-13 11:06:19","code":"158C01"}] 数据样例2： "chooseEvent":[{"c_ts":"2024-04-13 11:10:32","code":"productId\|322\|671"}] 数据样例3（B端APP专用，搜索词）： "chooseEvent":[{"c_ts":"2024-07-02 09:11:07","code":"1177C0000","keyword":"结束充电"}]

页面路径

记录每一次页面跳转的前后页面路径。并且默认所有页面都必须埋点。

数据样例1：

"actions":[{"cp":"/pages/home/Home","lp":"/pages/home/Home","ts":"2024-04-13 11:06:19"}]

数据样例2（原生APP专用）：

[{"cp":"105","lp":"182","ts":"2024-07-02 22:47:42"}]

自定义事件

根据运营需求，定制化的埋点。目前包含选择、取消、弹窗、其他等。

数据样例1：

"chooseEvent":[{"c_ts":"2024-04-13 11:06:19","code":"158C01"}]

数据样例2：

"chooseEvent":[{"c_ts":"2024-04-13 11:10:32","code":"productId|322|671"}]

数据样例3（B端APP专用，搜索词）：

"chooseEvent":[{"c_ts":"2024-07-02 09:11:07","code":"1177C0000","keyword":"结束充电"}]

前端调用接口接口上报埋点数据

调用接口的报文如下：

{ "uuid":"48b694f3-f1ce-48a6-85ff-e2ec13fd3f69" // uuid前端生成
"uid": "3432545", // 用户user_id，用户登录后必传
"suid": "485", // 归属用户sys_user_id
"oid": "0", // 公众号owner_id
"pd": "lvcc-WA-2.1.0", // 产品product 目前C端传空，B端管理中心传的'lvcc-webapp' "chargeTypeTag":"0" // 用户标签tag，0 二轮车 1 汽车
"common": { // 普通信息
"ch": "1", // 渠道来源channel 1：微信公众号 2：微信小程序 3：支付宝小程序 4：支付宝生活号 5：ios 6：安卓 7：pc端
"md": "iPhone 14ProMax", // 手机品牌型号model
"pid": "YXfhjAYH6As2z9Iq", // 手机设备唯一码phone id： IMEI或udid
"os": "IOS", // 手机操作系统 Android、IOS、HarmonyOS等
"osv": "13.2.9", // 手机操作系统版本 os_version
"ip": "192.168.10.15", // 访问的(公网)ip地址
"sr": "1024*768" // 屏幕分辨率screen resolution
},
"actions": [{ // 页面事件信息支持list多个
"ts": "2023-07-01 09:00:00",// 事件点击时间times 日期格式
"cp": "/page/index", // 当前页面 current page
"lp": "/page/userList", // 上个页面last page 无则为空
"dt": 7648, // 页面停留时间(单位毫秒) during_time 目前这个值没传 }],
"clickEvent": [{// 点击事件，当前页面所有点击事件点击记录后一次性上传，支持list多个目前这个还没做好
"px_x": "210", // 点击的X轴像素（单位px）
"px_y": "822", // 点击的Y轴像素（单位px）
"e_ts": "2023-07-01 09:01:00" // 点击事件时间 Event times },
{ "px_x": "223",
"px_y": "834",
"e_ts": "2023-07-01 09:01:23" }],
"chooseEvent": [{ // 同一个页面的点击事件，支持list多个
"code": "100C01", // 事件编码code
"c_ts": "2023-07-01 09:01:00",
"keyword": "搜索内容" // 针对特殊业务加的关键词记录，比如B端APP搜索框 },
{"code": "100C0101",
"c_ts": "2023-07-01 09:01:00" }]
}

字段说明：


节点名称	中文释义	说明
uuid	每条消息唯一id	每次上报时该值不能重复；可以取uuid
uid	用户id	C端充电云平台的用户id；C端产品传这个值
suid	系统用户id	B端用户登录的系统用户id；B端产品传这个值
oid	公众号id	所属公众号id
pd	产品版本类型	APP原生端传APP的版本id（例：LVCC-I-PH_2.4.1） C端非原生传空 B端非原生传‘lvcc-webapp’
chargeTypeTag	用户标签	0 二轮车 1 汽车
common		对象
ch	渠道来源	1：微信公众号 2：微信小程序 3：支付宝小程序 4：支付宝生活号 5：ios 6：安卓 7：pc端
md	手机品牌型号
pid	手机设备唯一码	app原生端：每次安装时生成唯一码，卸载重装时重新生成；非原生端：取的uni-app给的唯一id 原则上取IMEI，但是牵扯额外权限就未获取
os	手机操作系统
osv	手机操作系统版本
ip	访问的(公网)ip地址	该字段后端会自动根据请求生成。可传空
sr	屏幕分辨率	目前该字段未使用起来
actions		list集合；自定义点击事件
ts	事件点击时间	字符串格式：yyyy-mm-dd hh24:mi:ss
cp	当前页面路径	APP原生端：传的是页面id。非原生端：传的是路由信息；例如：/pages/home/Home
lp	上个页面路径	同上
dt	页面停留时间	因不好界定计算，目前此值未传。
clickEvent		list集合
px_x	点击的X轴像素	单位px；目前未使用
px_y	点击的Y轴像素	单位px；目前未使用
e_ts	点击时间	字符串格式：yyyy-mm-dd hh24:mi:ss；目前未使用
chooseEvent		list集合
code	自定义事件编码	字典详见数字运营系统-运营管理-埋点数据-埋点事件
c_ts	点击时间	字符串格式：yyyy-mm-dd hh24:mi:ss
keyword	关键词	目前仅在