实时日志
RES根据实时发送到DIS上的日志，进行数据计算和处理，更新用户的相关数据。用户发送到DIS上的数据具体如下：
实时行为日志
实时行为日志的作用包括：
- 更新用户的兴趣标签。
- 记录所选行为类型的历史记录。
- 更新用户的上下文信息。
- 召回候选集。
|
字段名 |
类型 |
描述 |
是否必选 |
|---|---|---|---|
|
userId |
String |
用户ID。 |
是 |
|
objectType |
String |
发生行为对象的类型， item是用户和商品本身发生的行为。 |
是 |
|
actionObject |
String |
对应行为发生的对象的值，如果是和商品发生关系：则是商品的id(itemId)的值。 |
是 |
|
actionType |
String |
行为类型：
|
是 |
|
actionMeasure |
String |
发生行为的度量，金额，评分，次数（整数）等。 默认值：
|
是 |
|
actionContent |
String |
发生行为为评论时，需要记录评论内容。 行为为搜索时，需要记录搜索的关键字。 |
否 |
|
actionDateTime |
String |
行为发生的时间，采用UTC标准时间，单位以秒计。 |
否 |
|
actionLocation |
String |
行为发生的位置，精度维度格式：[latitude, longitude]。 |
否 |
|
context |
Json |
动作发生的上下文信息，内容为json对象，也可作为行为表的扩展字段。例如，用户当前的设备id，ip地址等信息。 |
否 |
|
subSite |
String |
行为发生的位置ID，比如，在首页推荐里面点击，在详情页里面浏览。 |
否 |
|
traceId |
String |
用于追踪每个被推荐物品的唯一ID。用于推荐效果的计算。 |
否 |
|
flowId |
String |
用于计算每一个在线服务的效果。flowId由推荐系统的API返回给用户，用户需把flowId写到用户行为日志中。 |
否 |
实时行为日志示例
{
"userId": "user1",
"objectType": "item",
"actionObject": "item1",
"actionType": "collect",
"actionMeasure": "1.0",
"actionDateTime": "1512689700"
}
实时用户日志
实时用户日志用于在实时流中对用户画像表进行写入。
|
字段名 |
类型 |
描述 |
是否必选 |
|---|---|---|---|
|
userId |
String |
全局唯一用户ID。 |
是 |
|
BASICINFO |
Json |
用户基本属性值。其中字段的值只能是数值型，字符串或字符串数组。 |
否 |
|
TAGS |
Json |
用户的兴趣标签。其中字段的值只能是Map类型。 可传入不同类型的标签信息（如人工标签，关键词标签等）。 此标签体系需与物品标签体系相同。如果无历史兴趣标签，则无需传入此字段。推荐系统将会根据特定行为匹配的标签进行计算并完成更新。
说明：
传入TAGS字段会直接覆盖原程序中已计算出的兴趣标签权重。 |
否 |
|
CONTEXT |
Json |
用户上下文信息。其中字段的值只能是数值型，字符串或字符串数组。 |
否 |
实时用户日志示例
{
"userId":"user123",
"BASICINFO":{
"age":15,
"gender":"male",
"salary":31693.84172,
"hobbies":[
"体育",
"美术",
"音乐",
"格斗",
"书法"
]
},
"TAGS":{
"artificialLabel":{
"tag1":0.84,
"tag2":0.22,
"tag3":0.88
},
"keywordLabel":{
"tag4":0.22,
"tag5":0.99
}
},
"CONTEXT":{
"provinceId":"3853",
"cityId":"3868",
"districtId":"3873"
}
}
实时物品日志
实时物品日志用于在实时流中对物品画像表进行写入。
|
字段名 |
类型 |
描述 |
是否必选 |
|---|---|---|---|
|
itemId |
String |
全局唯一物品ID。 |
是 |
|
BASICINFO |
Json |
物品基本属性值。其中字段的值只能是数值型，字符串或字符串数组。 |
否 |
|
TAGS |
Json |
物品标签。其中字段的值只能是Map类型。 可传入不同类型的标签信息（如人工标签，关键词标签等）。
说明：
如果此字段为空，则RES无法根据行为计算用户的兴趣标签。 |
否 |
|
itemId |
BASICINFO |
TAGS |
|||
|---|---|---|---|---|---|
|
item123 |
weight |
brand |
price |
artificialLabel |
keywordLabel |
|
12 |
"male" |
333 |
{"tag1":0.84,"tag2":0.22,"tag3":0.88} |
{"tag4":0.22,"tag5":0.99} |
|
实时物品日志示例
{
"itemId":"item123",
"BASICINFO":{
"weight":12,
"brand":"male",
"price":333
},
"TAGS":{
"artificialLabel":{
"tag1":0.84,
"tag2":0.22,
"tag3":0.88
},
"keywordLabel":{
"tag4":0.22,
"tag5":0.99
}
}
}
