数据埋点:埋点事件的参数字段

用户行为日志埋点参数示例

1. 常见的公共参数

1.1. 环境信息

  • 用户信息;
  • 用户UID;
  • 设备PID;
  • 跳入时间;
  • 跳出时间;
  • 地理位置;
  • 设备,品牌、型号、系统;
  • 应用,应用版本;
  • 渠道,应用下载渠道。

1.2. 页面浏览记录

  • 页面信息;
  • 页面ID;
  • 页面对象;

1.3. 曝光对象

  • 广告;
  • 推荐;
  • 对象类型;
  • 对象ID。

1.4. 启动记录

  • 启动时间
  • 启动类型,图标或推送;
  • 开屏广告,广告ID等。

1.5. 事件日志

  • 点击事件

    事件日志,在大数据中多采用 批处理 方式,而不采用 实时处理,以减轻对于日志服务器的压力。多数企业都是做批处理,实时处理典型的用户是 今日头条

1.6. 错误信息

  • 异常记录
  • 程序崩溃
  • 错误加载

1.7. 公共字段示例

  • 基本的设备(手机 / PC / PAD等)都有的字段。

    "cm": {  //公共字段
          "mid": "",  // (String) 设备唯一标识
          "uid": "",  // (String) 用户标识
          "vc": "1",  // (String) versionCode,程序版本号
          "vn": "1.0",  // (String) versionName,程序版本名
          "l": "zh",  // (String) 系统语言
          "sr": "",  // (String) 渠道号,应用从哪个渠道来的。
          "os": "7.1.1",  // (String) Android系统版本
          "ar": "CN",  // (String) 区域
          "md": "BBB100-1",  // (String) 手机型号
          "ba": "blackberry",  // (String) 手机品牌
          "sv": "V2.2.1",  // (String) sdkVersion
          "g": "",  // (String) gmail
          "hw": "1620x1080",  // (String) heightXwidth,屏幕宽高
          "t": "1506047606608",  // (String) 客户端日志产生时的时间
          "nw": "WIFI",  // (String) 网络模式
          "ln": 0,  // (double) lng经度
          "la": 0  // (double) lat 纬度
      },
    

2. 全埋点事件

  • 全埋点事件示例:

3. 业务自定义事件

3.1. 自定义参数

  • 业务自定义参数,是为不同目的而采集的参数,这些参数在不同页面位置、上报指定类型数据,用于指定

3.2. 自定义事件示例

3.3. 列表页 loading

action 动作:开始加载=1,加载成功=2,加载失败=3 
loading_time 加载时长:计算下拉开始到接口返回数据的时间,(开始加载报 0,加载成 功或加载失败才上报时间) 
loading_way 加载类型:1-读取缓存,2-从接口拉新数据 (加载成功才上报加载类型) 
extend1:  扩展字段 Extend1 
extend2:  扩展字段 Extend2 
type 加载类型:自动加载=1,用户下拽加载=2,底部加载=3(底部条触发点击)

3.4. 商品点击 display

action 动作:曝光商品=1,点击商品=2, 
goodsid 商品 ID(服务端下发的 ID) 
place 顺序(第几条商品,第一条为 0,第二条为 1,如此类推) 
extend1 曝光类型:1 - 首次曝光 2-重复曝光 
category 分类 ID(服务端定义的分类 ID)

3.5. 商品详情页

entry 页面入口来源:应用首页=1、push=2、详情页相关推荐=3 
action 动作:开始加载=1,加载成功=2(pv),加载失败=3, 退出页面=4 
goodsid 商品 ID(服务端下发的 ID) 
show_style 商品样式:0、无图、1、一张大图、2、两张图、3、三张小图、4、一张小图、 5、一张大图两张小图 
news_staytime 页面停留时长:从商品开始加载时开始计算,到用户关闭页面所用的时间。 若中途用跳转到其它页面了,则暂停计时,待回到详情页时恢复计时。或中 途划出的时间超过 10 分钟,则本次计时作废,不上报本次数据。如未加载成 功退出,则报空。 
loading_time 加载时长:计算页面开始加载到接口返回数据的时间 (开始加载报 0,加载 成功或加载失败才上报时间) 
type1 加载失败码:把加载失败状态码报回来(报空为加载成功,没有失败) 
category 分类 ID(服务端定义的分类 ID)

3.6. 广告

entry 入口:商品列表页=1 应用首页=2 商品详情页=3 
action 动作: 广告展示=1 广告点击=2 
contentType Type: 1 商品 2 营销活动 
displayMills 展示时长 毫秒数 
itemId 商品 id 
activityId 营销活动 id

3.7. 消息通知

action 动作:通知产生=1,通知弹出=2,通知点击=3,常驻通知展示(不重复上 报,一天之内只报一次)=4 
type 通知 id:预警通知=1,天气预报(早=2,晚=3),常驻=4 
ap_time 客户端弹出时间 
content 备用字段

3.8. 后台活跃

active_source 1=upgrade,2=download(下载),3=plugin_upgrade

3.9. 评论

序号 字段名称 字段描述 字段类型 长度 允许空 缺省值
1 comment_id 评论表 int 10,0 
2 userid 用户 id int 10,0 √ 0 
3 p_comment_id 父级评论 id(为 0 则是一级评论,不 为 0 则是回复) int 10,0 √ 
4 content 评论内容 string 1000 √ 
5 addtime 创建时间 string √ 
6 other_id 评论的相关 id int 10,0 √ 
7 praise_count 点赞数量 int 10,0 √ 0 
8 reply_count 回复数量 int 10,0 √ 0

3.10. 收藏

序号 字段名称 字段描述 字段类型 长度 允许空 缺省值 
1 id 主键 int 10,0 
2 course_id 商品 id int 10,0 √ 0 
3 userid 用户 ID int 10,0 √ 0 
4 add_time 创建时间 string √

3.11. 点赞

序号 字段名称 字段描述 字段类型 长度 允许空 缺省值 
1 id 主键 id int 10,0 
2 userid 用户 id int 10,0 √ 
3 target_id 点赞的对象 id int 10,0 √ 
4 type 点赞类型 1 问答点赞 2 问答评论 点赞 3 文章点赞数 4 评论点赞 int 10,0 √ 
5 add_time 添加时间 string √

3.12. 错误日志

errorBrief 错误摘要 
errorDetail 错误详情

3.13. 启动日志

entry 入 口 : push=1 , widget=2 , icon=3 , notification=4, lockscreen_widget =5 
open_ad_type 开屏广告类型: 开屏原生广告=1, 开屏插屏广告=2 
action 状态:成功=1 失败=2 
loading_time 加载时长:计算下拉开始到接口返回数据的时间,(开始加载报 0,加载成 功或加载失败才上报时间) 
detail 失败码(没有则上报空) 
extend1 失败的 
message(没有则上报空) 
en 日志类型
  • 启动日志示例:

    { 
        "action":"1", 
        "ar":"MX", 
        "ba":"HTC", 
        "detail":"", 
        "en":"start", 
        "entry":"2", 
        "extend1":"", 
        "g":"43R2SEQX@gmail.com", 
        "hw":"640*960", 
        "l":"en",
        "la":"20.4", 
        "ln":"-99.3", 
        "loading_time":"2", 
        "md":"HTC-2", 
        "mid":"995", 
        "nw":"4G", 
        "open_ad_type":"2", 
        "os":"8.1.2", 
        "sr":"B", 
        "sv":"V2.0.6", 
        "t":"1561472502444", 
        "uid":"995", 
        "vc":"10", 
        "vn":"1.3.4" 
    }
    

3.14. 事件埋点示例

  "et":  [  //事件
              {
                  "ett": "1506047605364",  //客户端事件产生时间
                  "en": "display",  //事件名称  启动和事件日志是根据事件名称的不同
                  "kv": {  //事件结果,以key-value形式自行定义
                      "goodsid": "236",
                      "action": "1",
                      "extend1": "1",
  "place": "2",
  "category": "75"
                  }
              }
          ]
  }