离线数据源

调用RES之前，您需要准备3种基础数据包并上传至OBS，离线数据源目前支持CSV和 JSON。具体数据包请参见表1 基础数据表。

表8-49 基础数据表

数据类型 表名

用户类数据 用户属性表

物品类数据 物品属性表

行为类数据 用户操作行为表

说明 userId Strin

g 被推荐用户的唯一标识符。例如，用户的登录帐号、

imei号等。 是

userProp

erties Strin

g 用户属性kv串。不同属性之间用\002（ASCII值）分 隔，属性的key和value之间用\003（ASCII值）分隔，多

{ "userId":"user1",

"userProperties":"provinceId\u00035147\u0002cityId\u00035148\u0002districtId

\u00035154\u0002streetId\u0003130533\u0002payment_type\u00031\u0002payment_method

\u0003CMBLIFE_CMBLIFE\u0002payment_channel\u000312"

}

物品属性表

物品属性表记录物品的属性信息，例如类别、长度等，属性名和属性值成对出现。

表8-51 字段描述

字段名 类型 描述 是否必

选 itemId String 物品ID，唯一标识。 是 itemPrope

rties String 描述物品的key-value信息，key标识描述名称，

value标识值。基本格式同用户属性表中 userProperties。

否

物品属性示例

{ "itemId":"item1",

"itemProperties":"product_name\u0003wyf-name\u0002order_price\u0003500.00\u0002weight

\u0003130.00\0002volume\u0003v1"

}

用户操作行为表

用户-物品行为表，每行记录用户的单次行为信息，包含用户标识符、行为对象标识 符、行为类型和行为时间等信息。

表8-52 字段描述

字段名 类型 描述 是否必

选 userId Strin

g 用户ID。 是

objectType Strin

g 发生行为对象的名称。

item：是用户和物品本身发生的行为。

是

actionObje ct Strin

g 对应行为发生对象的值，如果是和物品发生关系，则 是物品的id(itemId)的值。 是

字段名 类型 描述 是否必 选 actionType Strin

g 行为类型：

● view：物品曝光

● click：用户点击物品

● collect：用户收藏了某个物品

● uncollect：用户取消收藏某个物品

● search_click：用户点击搜索结果中的物品

● comment：用户对物品的评论

● share：分享

● like：点赞

● dislike：点衰

● grade：评分

● consume：消费

● use：观看视频/听音乐/阅读。

是

actionMea

sure Strin

g 发生行为的度量，金额，评分，次数（整数）等。 ent Strin

g 发生行为为评论时，需要记录评论内容。

当是search_click时，需要记录搜索的关键字。

否

actionDat

eTime Strin

g 行为发生的时间，采用UTC标准时间，单位以秒计。 否 actionLoca

tion Strin

g 行为发生的位置和精度维度。

格式：[latitude, longitude]

否

context Strin

g 动作发生的上下文信息，内容为json格式字符串，也 可做为行为表的扩展字段。

例如，用户当前的设备id，ip地址等信息。

否

subSite Strin

g 行为发生的位置ID。例如，在首页推荐里面点击，在 详情页里面浏览。

否

traceId Strin

g 用于追踪每个被推荐物品的唯一ID。用于效果的计 算。

否

flowId Strin

g 用于计算每一个在线服务的效果。flowId由推荐系统 的API返回给用户，用户需把flowId写到用户行为日 志中。

否

用户操作行为示例

{ "userId":"user1", "objectType":"item", "actionObject":"item1", "actionType":"collect", "actionMeasure":"1.0",

"actionDateTime":"1512689700"

}

userId String 用户ID。 是

objectType String 发生行为对象的类型， item是用户和商品本身发 生的行为。

是

actionObjec

t String 对应行为发生的对象的值，如果是和商品发生关 系：则是商品的id(itemId)的值。 是 actionType String 行为类型：

● 物品曝光