ActionInteraction - Amazon Personalize

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

ActionInteraction

代表使用 PutActionInteractions API 傳送的動作互動事件。

目錄

actionId

與使用者互動的動作識別碼。這對應於 [動作] 互動結構描述的ACTION_ID欄位。

類型:字串

長度限制:長度下限為 1。長度上限為 256。

必要:是

eventType

動作互動事件的類型。您可以指定ViewedTaken、和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 的詳細資訊,請參閱下列內容: