本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
ActionInteraction
表示使用 PutActionInteractions
API 发送的操作交互事件。
内容
- actionId
-
用户与其交互的操作的 ID。这与操作交互架构的
ACTION_ID
字段相对应。类型:字符串
长度限制:最小长度为 1。最大长度为 256。
必需:是
- eventType
-
操作交互事件的类型。您可以指定
Viewed
、Taken
和Not Taken
事件类型。有关操作交互事件类型数据的更多信息,请参阅事件类型数据。类型:字符串
长度限制:最小长度为 1。最大长度为 256。
必需:是
- sessionId
-
与用户的访问关联的 ID。当用户首次访问您的网站或使用您的应用程序时,您的应用程序会生成唯一
sessionId
。类型:字符串
长度限制:最小长度为 1。最大长度为 256。
必需:是
- timestamp
-
操作交互事件发生时的时间戳。时间戳必须采用 Unix 纪元时间格式,以秒为单位。
类型:时间戳
必需:是
- eventId
-
与事件关联的 ID。如果未提供事件 ID,则 Amazon Personalize 会为事件生成一个唯一的 ID。事件 ID 不用作模型的输入。Amazon Personalize 使用事件 ID 来区分唯一事件。模型训练中不使用第一个事件之后具有相同事件 ID 的任何后续事件。
类型:字符串
长度限制:最小长度为 1。最大长度为 256。
必需:否
- impression
-
操作 ID 列表,表示您已向用户展示的操作的顺序。例如,
["actionId1", "actionId2", "actionId3"]
。Amazon Personalize 不使用来自操作交互事件的展示数据。而是为每个操作记录多个事件并使用Viewed
事件类型。类型:字符串数组
数组成员:最少 1 个物品。最多 25 项。
长度限制:最小长度为 1。最大长度为 256。
必需:否
- properties
-
您可以选择记录的事件特定数据的字符串映射。例如,如果用户采取了除操作 ID 以外的操作,您可能还会发送该用户采取的操作数量。
映射中的每个物品都由一个键值对组成。例如,
{"numberOfActions": "12"}
键使用与操作交互架构中的字段匹配的采用驼峰式大小写的名称。在上面的示例中,
numberOfActions
将匹配在操作交互架构中定义的“NUMBER_OF_ACTIONS”字段。以下内容不能作为属性的关键字包括在内(不区分大小写)。
-
userId
-
sessionId
-
eventType
-
时间戳
-
recommendationId
-
impression
类型:字符串
长度限制:长度下限为 1。最大长度为 1024。
必需:否
-
- recommendationId
-
包含用户与之交互的操作的建议列表的 ID。
类型:字符串
长度限制:长度下限为 1。最大长度为 40。
必需:否
- userId
-
与操作交互的用户的 ID。这与操作交互架构的
USER_ID
字段相对应。类型:字符串
长度限制:最小长度为 1。最大长度为 256。
必需:否
另请参阅
有关在特定语言的 AWS SDK 中使用此 API 的更多信息,请参阅以下内容: