閱讀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 規格報價__公眾趨勢分析-阿裏雲