阅读360 返回首页    go 阿里云

日志埋点规范__数据规范_开发者指南_推荐引擎-阿里云

埋点规范

推荐引擎的日志格式为标准的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”

最后更新：2016-11-23 17:55:16

  上一篇：go 数据格式规范__数据规范_开发者指南_推荐引擎-阿里云
  下一篇：go 规格报价__公众趋势分析-阿里云