本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 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 時間為單位）。  
類型：Timestamp  
必要：是

 ** 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>
項目 IDs 清單，代表您已向使用者顯示的項目序列。例如 `["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
+ 印模
類型：字串  
長度限制：長度下限為 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 SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/Event) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/Event) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/Event)