全部产品

日志埋点规范 V3.0

更新时间:2017-07-14 16:04:46   分享:   

日志埋点规范 V3.0

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

埋点规范

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

JAVA示例:

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

登录类

用户登录

记录用户相关的tag信息

参数 字段类型 描述 Nullable
action string 取值”user”
user_id string 用户唯一ID
tags object 用户标签,格式为:{“tag_key”:”tag_value”},不允许嵌套
plates string 板块分组信息,逗号分隔字符串

JSON示例:

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

物品注册

注册物品相关的信息

参数 字段类型 描述 Nullable
action string 取值”item”
item_id string 物品唯一ID
category string 物品类目
keywords object/array 物品关键词,格式为:{“word”:”word_weight”} 或者 [“word1”,”word2”],不允许嵌套
description string 物品描述
properties object 物品属性,格式为:{“key”:”value”},不允许嵌套
item_info object 物品业务属性,格式为:{“key”:”value”},不允许嵌套
deleted boolean 从离线数据中删除该item
update_datetime string 物品更新时间,字符串e格式 ‘yyyy-MM-dd HH:mm:ss’
plates string 板块分组信息,逗号分隔字符串

JSON示例:

  1. {
  2. "action":"item",
  3. "item_id":"i1",
  4. "category":"",
  5. "keywords":["a","b","c"],
  6. "description":"",
  7. "properties":{"key","value"},
  8. "item_info":{"key","value"},
  9. "deleted":false,
  10. "update_datetime":"2016-05-06 11:11:11",
  11. "plates":"1,2"
  12. }

行为类

通用埋点

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

参数 字段类型 描述 Nullable
action string 取值‘behavior’
bhv_type string 行为类型
user_id string 用户唯一ID
act_obj string 行为对象ID
obj_type string 行为对象类型,默认为item
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
plates string 板块分组信息,逗号分隔字符串

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

物品曝光(*)

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

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

JSON示例:

  1. {
  2. "action":"behavior",
  3. "bhv_type":"view",
  4. "user_id":"u1",
  5. "act_obj":"i1",
  6. "obj_type":"item",
  7. "trace_id":"xxx",
  8. "bhv_datetime":"2016-05-06 11:11:11"
  9. }

物品点击(*)

用户点击物品进入详情页

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

JSON示例:

  1. {
  2. "action":"behavior",
  3. "bhv_type":"click",
  4. "bhv_amt": 1.0,
  5. "user_id":"u1",
  6. "act_obj":"i1",
  7. "obj_type":"item",
  8. "trace_id":"xxx",
  9. "bhv_datetime":"2016-05-06 11:11:11"
  10. }

物品消费

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

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

JSON示例:

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

物品使用

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

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

JSON示例:

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

物品评分

用户对物品的显式评分

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

JSON示例:

  1. {
  2. "action":"behavior",
  3. "bhv_type":"grade",
  4. "bhv_amt": 3,
  5. "user_id":"u1",
  6. "act_obj":"i1",
  7. "obj_type":"item",
  8. "trace_id":"xxx",
  9. "bhv_datetime":"2016-05-06 11:11:11"
  10. }

主动点赞/点衰/取消点赞

用户评价的一种

参数 字段类型 描述 Nullable
bhv_type string 取值“like” / “dislike” / “cancel_like”
content string 点衰原因

JSON示例:

  1. {
  2. "action":"behavior",
  3. "bhv_type":"like",
  4. "user_id":"u1",
  5. "act_obj":"i1",
  6. "obj_type":"item",
  7. "trace_id":"xxx",
  8. "bhv_datetime":"2016-05-06 11:11:11"
  9. }
  1. {
  2. "action":"behavior",
  3. "bhv_type":"dislike",
  4. "content":"广告",
  5. "user_id":"u1",
  6. "act_obj":"i1",
  7. "obj_type":"item",
  8. "trace_id":"xxx",
  9. "bhv_datetime":"2016-05-06 11:11:11"
  10. }

主动收藏/取消收藏

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

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

JSON示例:

  1. {
  2. "action":"behavior",
  3. "bhv_type":"collect",
  4. "user_id":"u1",
  5. "act_obj":"i1",
  6. "obj_type":"item",
  7. "trace_id":"xxx",
  8. "bhv_datetime":"2016-05-06 11:11:11"
  9. }

评论/分享

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

参数 字段类型 描述 Nullable
bhv_type string 取值 “comment” / “share”
content string 评论内容/分享目标

JSON示例:

  1. {
  2. "action":"behavior",
  3. "bhv_type":"comment",
  4. "content":"good",
  5. "user_id":"u1",
  6. "act_obj":"i1",
  7. "obj_type":"item",
  8. "trace_id":"xxx",
  9. "bhv_datetime":"2016-05-06 11:11:11"
  10. }
  1. {
  2. "action":"behavior",
  3. "bhv_type":"share",
  4. "content":"weibo",
  5. "user_id":"u1",
  6. "act_obj":"i1",
  7. "obj_type":"item",
  8. "trace_id":"xxx",
  9. "bhv_datetime":"2016-05-06 11:11:11"
  10. }

物品相关浏览

用户点击物品进入详情页之后,展示的相关物品列表

参数 字段类型 描述 Nullable
bhv_type string 取值 “detail_view”
content string 相关 act_object

JSON示例:

  1. {
  2. "action":"behavior",
  3. "bhv_type":"detail_view",
  4. "content":"i100",
  5. "user_id":"u1",
  6. "act_obj":"i1",
  7. "obj_type":"item",
  8. "trace_id":"xxx",
  9. "bhv_datetime":"2016-05-06 11:11:11"
  10. }

物品相关点击

用户点击物品进入详情页之后,继而点击的相关物品

参数 字段类型 描述 Nullable
bhv_type string 取值 “detail_click”
content string 相关 act_object
bhv_amt float 如果是推荐引导,取值推荐列表的展现次序

JSON示例:

  1. {
  2. "action":"behavior",
  3. "bhv_type":"detail_click",
  4. "content":"i100",
  5. "user_id":"u1",
  6. "act_obj":"i1",
  7. "obj_type":"item",
  8. "trace_id":"xxx",
  9. "bhv_datetime":"2016-05-06 11:11:11"
  10. }

搜索结果点击

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

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

JSON示例:

  1. {
  2. "action":"behavior",
  3. "bhv_type":"search_click",
  4. "content":"book",
  5. "user_id":"u1",
  6. "act_obj":"i1",
  7. "obj_type":"item",
  8. "trace_id":"xxx",
  9. "bhv_datetime":"2016-05-06 11:11:11"
  10. }

日志API

日志API的相关说明请参见“API说明 V3.0”中的“7、日志API”

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