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

# Event
<a name="API_UBS_Event"></a>

表示使用 `PutEvents` API 发送的物品交互事件信息。

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

 ** eventType **   <a name="personalize-Type-UBS_Event-eventType"></a>
事件的类型，例如单击或下载。此属性对应于物品交互数据集架构的 `EVENT_TYPE` 字段，并取决于您要跟踪的事件类型。  
类型：字符串  
长度限制：最小长度为 1。最大长度为 256。  
必需：是

 ** sentAt **   <a name="personalize-Type-UBS_Event-sentAt"></a>
事件发生时客户端的时间戳（采用 Unix 时间）。  
类型：时间戳  
必需：是

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

 ** eventValue **   <a name="personalize-Type-UBS_Event-eventValue"></a>
与物品交互架构的 `EVENT_VALUE` 字段对应的事件值。  
类型：浮点值  
必需：否

 ** impression **   <a name="personalize-Type-UBS_Event-impression"></a>
物品 ID 列表，代表您向用户展示的物品顺序。例如 `["itemId1", "itemId2", "itemId3"]`。提供物品列表以手动记录事件的展示数据。有关记录展示数据的更多信息，请参阅[记录展示数据](https://docs.aws.amazon.com/personalize/latest/dg/recording-events.html#putevents-including-impressions-data)。  
类型：字符串数组  
数组成员：最少 1 个物品。最多 25 项。  
长度限制：最小长度为 1。最大长度为 256。  
必需：否

 ** itemId **   <a name="personalize-Type-UBS_Event-itemId"></a>
与物品交互数据集的架构中的 `ITEM_ID` 字段对应的物品 ID 键。  
类型：字符串  
长度限制：最小长度为 1。最大长度为 256。  
必需：否

 ** metricAttribution **   <a name="personalize-Type-UBS_Event-metricAttribution"></a>
包含与事件关联的指标归因的相关信息。有关指标归因的更多信息，请参阅[衡量建议的影响](https://docs.aws.amazon.com/personalize/latest/dg/measuring-recommendation-impact.html)。  
类型：[MetricAttribution](API_UBS_MetricAttribution.md) 对象  
必需：否

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

 ** recommendationId **   <a name="personalize-Type-UBS_Event-recommendationId"></a>
包含用户与之交互的物品的建议列表的 ID。提供 `recommendationId`，让 Amazon Personalize 隐式记录您向用户展示的建议作为展示数据。或者，在您使用指标归因来衡量建议的影响时，提供 `recommendationId`。  
 有关记录展示数据的更多信息，请参阅[记录展示数据](https://docs.aws.amazon.com/personalize/latest/dg/recording-events.html#putevents-including-impressions-data)。有关创建指标归因的更多信息，请参阅[衡量建议的影响](https://docs.aws.amazon.com/personalize/latest/dg/measuring-recommendation-impact.html)。  
类型：字符串  
长度限制：长度下限为 1。最大长度为 40。  
必需：否

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

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