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

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

ActionInteraction

表示使用 PutActionInteractions API 发送的操作交互事件。

内容

actionId

用户与其交互的操作的 ID。这与操作交互架构的 ACTION_ID 字段相对应。

类型:字符串

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

必需:是

eventType

操作交互事件的类型。您可以指定 ViewedTakenNot 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

  • timestamp

  • recommendationId

  • impression

类型:字符串

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

必需:否

recommendationId

包含用户与之交互的操作的建议列表的 ID。

类型:字符串

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

必需:否

userId

与操作交互的用户的 ID。这与操作交互架构的 USER_ID 字段相对应。

类型:字符串

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

必需:否

另请参阅

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