更新时间:2024-04-17 GMT+08:00
分享

实时日志

RES根据实时发送到DIS上的日志,进行数据计算和处理,更新用户的相关数据。用户发送到DIS上的数据具体如下:

实时行为日志

实时行为日志的作用包括:

  • 更新用户的兴趣标签。
  • 记录所选行为类型的历史记录。
  • 更新用户的上下文信息。
  • 召回候选集。
表1 实时行为日志字段描述

字段名

类型

描述

是否必选

userId

String

用户ID。

objectType

String

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

actionObject

String

对应行为发生的对象的值,如果是和商品发生关系:则是商品的id(itemId)的值。

actionType

String

行为类型:

  • 物品曝光
  • 用户点击物品
  • 用户收藏了某个物品
  • 用户取消收藏某个物品
  • 用户点击搜索结果中的物品
  • 用户对物品的评论
  • 分享
  • 点赞
  • 点衰
  • 评分
  • 消费
  • 观看视频/听音乐/阅读

actionMeasure

String

发生行为的度量,金额,评分,次数(整数)等。

默认值:

  • 评分和观看视频/听音乐/阅读可由用户根据实际情况自行定义,如观看两分钟,值为 “1.5”,观看5分钟,值为“1.8”。
  • 其余行为的默认值为1.0。

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"
}

实时用户日志

实时用户日志用于在实时流中对用户画像表进行写入。

表2 用户实时日志字段描述

字段名

类型

描述

是否必选

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"
    }
}

实时物品日志

实时物品日志用于在实时流中对物品画像表进行写入。

表3 物品实时日志字段描述

字段名

类型

描述

是否必选

itemId

String

全局唯一物品ID。

BASICINFO

Json

物品基本属性值。其中字段的值只能是数值型,字符串或字符串数组。

TAGS

Json

物品标签。其中字段的值只能是Map类型。

可传入不同类型的标签信息(如人工标签,关键词标签等)。

说明:

如果此字段为空,则RES无法根据行为计算用户的兴趣标签。

表4 物品实时日志示例表

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
        }
    }
}

相关文档