全部产品

日志埋点规范 V2.0

更新时间:2017-06-07 13:26:11   分享:   

日志埋点规范 V2.0

日志埋点规范 V2.0 适用于推荐引擎旧版控制台,如果使用新版控制台,请参考日志埋点规范 V3.0

推荐引擎的日志格式为标准的JSONObject。其中对于实时行为日志,可以使用实时行为日志上传API这个API进行上传,将每条日志put到demo中的logs中`

JAVA示例:

  1. JSONObject obj = new JSONObject();
  2. obj.put("action","login");
  3. obj.put("user_id","i1");
  4. logs.add(obj);
  • 表示必须埋点项目

信息注册类

新用户注册

注册新用户相关信息

参数 字段类型 描述 Nullable
action string 取值”login”
user_id string 用户唯一ID
tags object 用户标签,格式为:{“tag_key”:”tag_value”},不允许嵌套

JSON示例:

  1. {
  2. "action":"login",
  3. "user_id":"u1",
  4. "tags":{"age":"1","gender":"1"}
  5. }

新物品注册

注册新物品相关的信息

参数 字段类型 描述 Nullable
action string 取值”item”
item_id string 物品唯一ID
category string 物品类目
keywords object/array 物品关键词,格式为:{“word”:”word_weight”} 或者 [“word1”,”word2”],不允许嵌套
description string 物品描述
properties object 物品属性,格式为:{“key”:”value”},不允许嵌套
bizinfo object 物品业务属性,格式为:{“key”:”value”},不允许嵌套
deleted boolean 从离线数据中删除该item

JSON示例:

  1. {
  2. "action":"item",
  3. "item_id":"i1",
  4. "category":"",
  5. "keywords":["a","b","c"],
  6. "description":"",
  7. "properties":{"key","value"},
  8. "bizinfo":{"key","value"},
  9. "deleted":false
  10. }

行为类

通用埋点

以下是每种行为都需要的埋点参数

参数 字段类型 描述 Nullable
user_id string 用户唯一ID
item_id string 物品唯一ID
trace_id string 如果发生行为的物品是推荐引擎引导,取值为同推荐列表一起返回的trace_id
bhv_datetime string 行为时间,字符串e格式 ‘yyyy-MM-dd HH:mm:ss’
pos_type string 行为发生的位置类型,有三种取值
ll:经纬度格式的位置信息
gh:geohash格式的位置信息
poi:poi格式的位置信息
position string 行为发生的位置,根据pos_type有不同的取值格式:
如果pos_type=ll,position格式’longitude:latitude’
如果pos_type=gh,position格式 ‘geohashcode’
如果pos_type=poi,position格式’poi_string’
env object 其他环境参数,如IP,Network

以下是每种行为特定的埋点参数

物品曝光(*)

物品信息展现在用户面前时

参数 字段类型 描述 Nullable
action string 取值 “view”

JSON示例:

  1. {
  2. "action":"view",
  3. "user_id":"u1",
  4. "item_id":"i1",
  5. "trace_id":"xxx",
  6. "bhv_datetime":"2016-05-06 11:11:11"
  7. }

物品点击(*)

用户点击物品进入详情页

参数 字段类型 描述 Nullable
action string 取值 “click”
bhv_amt float 如果是推荐引导,取值推荐列表的展现次序

JSON示例:

  1. {
  2. "action":"click",
  3. "bhv_amt": 1.0,
  4. "user_id":"u1",
  5. "item_id":"i1",
  6. "trace_id":"xxx",
  7. "bhv_datetime":"2016-05-06 11:11:11"
  8. }

物品消费

用户消费积分或者人民币购买某物品

参数 字段类型 描述 Nullable
action string 取值 “consume”
bhv_amt float 购买金额
bhv_cnt int 购买件数

JSON示例:

  1. {
  2. "action":"consume",
  3. "bhv_amt": 100.0,
  4. "bhv_cnt": 1,
  5. "user_id":"u1",
  6. "item_id":"i1",
  7. "trace_id":"xxx",
  8. "bhv_datetime":"2016-05-06 11:11:11"
  9. }

物品使用

用户使用某个物品,包括阅读,观看,收听

参数 字段类型 描述 Nullable
action string 取值 “use”
bhv_amt float 观看时长等
bhv_cnt int 观看次数等

JSON示例:

  1. {
  2. "action":"use",
  3. "bhv_amt": 100.0,
  4. "bhv_cnt": 1,
  5. "user_id":"u1",
  6. "item_id":"i1",
  7. "trace_id":"xxx",
  8. "bhv_datetime":"2016-05-06 11:11:11"
  9. }

物品评分

用户对物品的显式评分

参数 字段类型 描述 Nullable
action string 取值 “grade”
bhv_amt float 取值评分值

JSON示例:

  1. {
  2. "action":"grade",
  3. "bhv_amt": 3,
  4. "user_id":"u1",
  5. "item_id":"i1",
  6. "trace_id":"xxx",
  7. "bhv_datetime":"2016-05-06 11:11:11"
  8. }

主动点赞/点衰

用户评价的一种

参数 字段类型 描述 Nullable
action string 取值“like”或者 “dislike”

JSON示例:

  1. {
  2. "action":"like",
  3. "user_id":"u1",
  4. "item_id":"i1",
  5. "trace_id":"xxx",
  6. "bhv_datetime":"2016-05-06 11:11:11"
  7. }

主动收藏/取消收藏

用户收藏或者取消收藏某个物品

参数 字段类型 描述 Nullable
action string 取值“collect”或者 “uncollect”

JSON示例:

  1. {
  2. "action":"collect",
  3. "user_id":"u1",
  4. "item_id":"i1",
  5. "trace_id":"xxx",
  6. "bhv_datetime":"2016-05-06 11:11:11"
  7. }

主动分享

主要考虑app上的社交分享功能

参数 字段类型 描述 Nullable
action string 取值 “share”
media_type string 通过何种渠道分享(短信:sms,邮件:email,微博:sina_wb,微信好友:wechat_friend,微信朋友圈:wechat_circle,QQ空间:qq_zone,来往好友:laiwang_friend,来往动态:laiwang_circle)。如有新的分享媒体,可与平台协商后添加

JSON示例:

  1. {
  2. "action":"share",
  3. "media_type":"email",
  4. "user_id":"u1",
  5. "item_id":"i1",
  6. "trace_id":"xxx",
  7. "bhv_datetime":"2016-05-06 11:11:11"
  8. }

评论

用户对物品的显式文字评论

参数 字段类型 描述 Nullable
action string 取值 “comment”
content string 评论内容

JSON示例:

  1. {
  2. "action":"comment",
  3. "content":"good",
  4. "user_id":"u1",
  5. "item_id":"i1",
  6. "trace_id":"xxx",
  7. "bhv_datetime":"2016-05-06 11:11:11"
  8. }

搜索结果点击

用户搜索后点击的物品(无trace_id)

参数 字段类型 描述 Nullable
action string 取值 “search_click”
content string 搜索词

JSON示例:

  1. {
  2. "action":"search_click",
  3. "content":"book",
  4. "user_id":"u1",
  5. "item_id":"i1",
  6. "trace_id":"xxx",
  7. "bhv_datetime":"2016-05-06 11:11:11"
  8. }

实时行为日志上传API

实时行为日志上传API的相关说明请参见“API参考”中的“7、实时行为日志上传API”

本文导读目录
本文导读目录
以上内容是否对您有帮助?