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

# ActionInteraction
<a name="API_UBS_ActionInteraction"></a>

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

## 目录
<a name="API_UBS_ActionInteraction_Contents"></a>

 ** actionId **   <a name="personalize-Type-UBS_ActionInteraction-actionId"></a>
用户与其交互的操作的 ID。这与操作交互架构的 `ACTION_ID` 字段相对应。  
类型：字符串  
长度限制：最小长度为 1。最大长度为 256。  
必需：是

 ** eventType **   <a name="personalize-Type-UBS_ActionInteraction-eventType"></a>
操作交互事件的类型。您可以指定 `Viewed`、`Taken` 和 `Not Taken` 事件类型。有关操作交互事件类型数据的更多信息，请参阅[事件类型数据](https://docs.aws.amazon.com/personalize/latest/dg/action-interaction-event-type-data.html)。  
类型：字符串  
长度限制：最小长度为 1。最大长度为 256。  
必需：是

 ** sessionId **   <a name="personalize-Type-UBS_ActionInteraction-sessionId"></a>
与用户的访问关联的 ID。当用户首次访问您的网站或使用您的应用程序时，您的应用程序会生成唯一 `sessionId`。  
类型：字符串  
长度限制：最小长度为 1。最大长度为 256。  
必需：是

 ** timestamp **   <a name="personalize-Type-UBS_ActionInteraction-timestamp"></a>
操作交互事件发生时的时间戳。时间戳必须采用 Unix 纪元时间格式，以秒为单位。  
类型：时间戳  
必需：是

 ** eventId **   <a name="personalize-Type-UBS_ActionInteraction-eventId"></a>
与事件关联的 ID。如果未提供事件 ID，则 Amazon Personalize 会为事件生成一个唯一的 ID。事件 ID 不用作模型的输入。Amazon Personalize 使用事件 ID 来区分唯一事件。模型训练中不使用第一个事件之后具有相同事件 ID 的任何后续事件。  
类型：字符串  
长度限制：最小长度为 1。最大长度为 256。  
必需：否

 ** impression **   <a name="personalize-Type-UBS_ActionInteraction-impression"></a>
操作 ID 列表，表示您已向用户展示的操作的顺序。例如 `["actionId1", "actionId2", "actionId3"]`。Amazon Personalize 不使用来自操作交互事件的展示数据。而是为每个操作记录多个事件并使用 `Viewed` 事件类型。  
类型：字符串数组  
数组成员：最少 1 个物品。最多 25 项。  
长度限制：最小长度为 1。最大长度为 256。  
必需：否

 ** properties **   <a name="personalize-Type-UBS_ActionInteraction-properties"></a>
您可以选择记录的事件特定数据的字符串映射。例如，如果用户采取了除操作 ID 以外的操作，您可能还会发送该用户采取的操作数量。  
映射中的每个物品都由一个键值对组成。例如，  
 `{"numberOfActions": "12"}`   
键使用与操作交互架构中的字段匹配的采用驼峰式大小写的名称。在上面的示例中，`numberOfActions` 将匹配在操作交互架构中定义的“NUMBER\$1OF\$1ACTIONS”字段。  
 以下内容不能作为属性的关键字包括在内（不区分大小写）。  
+  userId 
+  sessionId 
+ eventType
+ timestamp
+ recommendationId
+ impression
类型：字符串  
长度限制：长度下限为 1。最大长度为 1024。  
必需：否

 ** recommendationId **   <a name="personalize-Type-UBS_ActionInteraction-recommendationId"></a>
包含用户与之交互的操作的建议列表的 ID。  
类型：字符串  
长度限制：长度下限为 1。最大长度为 40。  
必需：否

 ** userId **   <a name="personalize-Type-UBS_ActionInteraction-userId"></a>
与操作交互的用户的 ID。这与操作交互架构的 `USER_ID` 字段相对应。  
类型：字符串  
长度限制：最小长度为 1。最大长度为 256。  
必需：否

## 另请参阅
<a name="API_UBS_ActionInteraction_SeeAlso"></a>

有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容：
+  [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/ActionInteraction) 
+  [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/ActionInteraction) 
+  [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/ActionInteraction)