Event - Amazon Personalize

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

Event

表示使用 PutEvents API 发送的物品交互事件信息。

内容

eventType

事件的类型,例如单击或下载。此属性对应于物品交互数据集架构的 EVENT_TYPE 字段,并取决于您要跟踪的事件类型。

类型:字符串

长度限制:最小长度为 1。最大长度为 256。

必需:是

sentAt

事件发生时客户端的时间戳(采用 Unix 时间)。

类型:时间戳

必需:是

eventId

与事件关联的 ID。如果未提供事件 ID,则 Amazon Personalize 会为事件生成一个唯一的 ID。事件 ID 不用作模型的输入。Amazon Personalize 使用事件 ID 来区分唯一事件。模型训练中不使用第一个事件之后具有相同事件 ID 的任何后续事件。

类型:字符串

长度限制:最小长度为 1。最大长度为 256。

必需:否

eventValue

与物品交互架构的 EVENT_VALUE 字段对应的事件值。

类型:浮点值

必需:否

impression

物品 ID 列表,代表您向用户展示的物品顺序。例如,["itemId1", "itemId2", "itemId3"]。提供物品列表以手动记录事件的展示数据。有关记录展示数据的更多信息,请参阅记录展示数据

类型:字符串数组

数组成员:最少 1 个物品。最多 25 项。

长度限制:最小长度为 1。最大长度为 256。

必需:否

itemId

与物品交互数据集的架构中的 ITEM_ID 字段对应的物品 ID 键。

类型:字符串

长度限制:最小长度为 1。最大长度为 256。

必需:否

metricAttribution

包含与事件关联的指标归因的相关信息。有关指标归因的更多信息,请参阅衡量建议的影响

类型:MetricAttribution 对象

必需:否

properties

您可以选择记录的事件特定数据的字符串映射。例如,如果用户在您的网站上对电影进行评分,则除了电影 ID (itemId) 和评分 (eventValue) 外,您还可以发送该用户对电影做出的评分数量。

映射中的每个物品都由一个键值对组成。例如,

{"numberOfRatings": "12"}

键使用与物品交互数据集架构中的字段匹配的采用驼峰式大小写的名称。在上面的示例中,numberOfRatings 将匹配在物品交互数据集的架构中定义的“NUMBER_OF_RATINGS”字段。

以下内容不能作为属性的关键字包括在内(不区分大小写)。

  • userId

  • sessionId

  • eventType

  • 时间戳

  • recommendationId

  • impression

类型:字符串

长度限制:长度下限为 1。最大长度为 1024。

必需:否

recommendationId

包含用户与之交互的物品的建议列表的 ID。提供 recommendationId,让 Amazon Personalize 隐式记录您向用户展示的建议作为展示数据。或者,在您使用指标归因来衡量建议的影响时,提供 recommendationId

有关记录展示数据的更多信息,请参阅记录展示数据。有关创建指标归因的更多信息,请参阅衡量建议的影响

类型:字符串

长度限制:长度下限为 1。最大长度为 40。

必需:否

另请参阅

有关在特定语言的 AWS SDK 中使用此 API 的更多信息,请参阅以下内容: