Event - Amazon Personalize
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

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

Event

表示使用PutEvents API 发送的用户互动事件信息。

目录

eventId

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

类型:字符串

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

必需:否

eventType

事件的类型,例如单击或下载。此属性对应于 InEVENT_TYPE teractions 架构的字段,取决于您正在跟踪的事件类型。

类型:字符串

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

必需:是

eventValue

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

类型:浮点值

必需:否

impression

代表您向用户显示的项目顺序的项目 ID 列表。例如,["itemId1", "itemId2", "itemId3"]。提供项目列表以手动记录活动的曝光量数据。有关记录曝光数据的更多信息,请参阅记录展示次数数据

类型:字符串数组

数组成员:最少 1 项。最限度上限为

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

必需:否

itemId

与交互架构ITEM_ID字段对应的项目 ID 密钥。

类型:字符串

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

必需:否

metricAttribution

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

类型:MetricAttribution 对象

必需:否

properties

您可以选择记录的特定事件数据的字符串地图。例如,如果用户对您网站上的一部电影进行评分,而非电影 ID (itemId) 和评级 (eventValue),则您可能还会发送该用户的电影评分数量。

一个标签由一个键值对组成。例如,

{"numberOfRatings": "12"}

密钥使用与 Interactions 架构中的字段相匹配的驼峰大小写名称。在上面的示例中,numberOfRatings将与交互架构中定义的 “NUMBER_OF_RATINGS” 字段相匹配。

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

  • userId

  • sessionId

  • eventType

  • timestamp

  • 推荐 ID

  • 印象

类型:字符串

长度限制:最小长度为 1。长度上限为 1024。

必需:否

recommendationId

包含用户与之互动的项目的推荐列表的 ID。提供,让 ArecommendationId mazon Personalize 隐式记录您向用户展示的推荐作为曝光量数据。或者,recommendationId如果您使用指标归因来衡量推荐的影响,请提供。

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

类型:字符串

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

必需:否

sentAt

事件发生时客户端的时间戳(以 Unix 时间表示)。

类型:时间戳

必需:是

另请参阅

有关在特定语言的 Amazon 软件开发工具包中使用此 API 的更多信息,请参阅以下内容: