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

# 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 epoch 時間格式，以秒為單位。  
類型：Timestamp  
必要：是

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