本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
Event
表示使用PutEvents
API 发送的用户互动事件信息。
目录
- eventId
-
与事件关联的 ID。如果未提供活动 ID,则 Amazon Personalize 会为该活动生成一个唯一的 ID。事件 ID 不用作模型的输入。Amazon Personalize ize 使用事件 ID 来区分独特事件。模型训练中不使用第一个事件之后的任何具有相同事件 ID 的事件。
类型:字符串
长度限制:最小长度为 1。长度上限为 256。
必需:否
- eventType
-
事件的类型,例如单击或下载。此属性对应于 In
EVENT_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。提供,让 A
recommendationId
mazon Personalize 隐式记录您向用户展示的推荐作为曝光量数据。或者,recommendationId
如果您使用指标归因来衡量推荐的影响,请提供。有关记录曝光数据的更多信息,请参阅记录展示次数数据。有关创建指标归因的更多信息,请参阅衡量推荐的影响。
类型:字符串
长度限制:最小长度为 1。最限度为
必需:否
- sentAt
-
事件发生时客户端的时间戳(以 Unix 时间表示)。
类型:时间戳
必需:是
另请参阅
有关在特定语言的 Amazon 软件开发工具包中使用此 API 的更多信息,请参阅以下内容: