本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
ActionInteraction
代表使用 PutActionInteractions
API 傳送的動作互動事件。
目錄
- actionId
-
與使用者互動的動作識別碼。這對應於 [動作] 互動結構描述的
ACTION_ID
欄位。類型:字串
長度限制:長度下限為 1。長度上限為 256。
必要:是
- eventType
-
動作互動事件的類型。您可以指定
Viewed
Taken
、和Not Taken
事件類型。如需有關動作互動事件類型資料的詳細資訊,請參閱事件類型資料。類型:字串
長度限制:長度下限為 1。長度上限為 256。
必要:是
- sessionId
-
與使用者造訪相關聯的 ID。當用戶首次訪問您的網站或使用您的應用程序
sessionId
時,您的應用程序會生成唯一的。類型:字串
長度限制:長度下限為 1。長度上限為 256。
必要:是
- timestamp
-
動作互動事件發生時的時間戳記。時間戳記必須採用 Unix 紀元時間格式,以秒為單位。
類型:Timestamp
必要:是
- eventId
-
與事件相關聯的 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"}
這些鍵使用與 Action 交互模式中的字段匹配的駝峰大小寫名稱。在上面的例子中,
numberOfActions
將匹配在動作交互架構中定義的「NUMBER_OF_ACTIONS」字段。以下內容不能作為屬性的關鍵字包含(不區分大小寫)。
-
userId
-
sessionId
-
eventType
-
timestamp
-
建議編號
-
印象
類型:字串
長度限制:長度下限為 1。長度上限為 1024。
必要:否
-
- recommendationId
-
包含使用者互動之動作之建議清單的識別碼。
類型:字串
長度限制:長度下限為 1。最大長度為 40。
必要:否
- userId
-
與動作互動的使用者 ID。這對應於 [動作] 互動結構描述的
USER_ID
欄位。類型:字串
長度限制:長度下限為 1。長度上限為 256。
必要:否
另請參閱
如需在其中一個特定語言 AWS SDK 中使用此 API 的詳細資訊,請參閱下列內容: