Event - Amazon Personalize

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

Event

代表使用 PutEvents API 傳送的項目互動事件資訊。

目錄

eventType

事件類型,例如按一下或下載。此屬性會對應至項目互動資料集結構描述的EVENT_TYPE欄位,並且視您追蹤的事件類型而定。

類型:字串

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

必要:是

sentAt

事件發生時的客戶端的時間戳(以 Unix 時間為單位)。

類型:Timestamp

必要:是

eventId

與事件相關聯的 ID。如果未提供事件識別碼,Amazon Personalize 會為該事件產生唯一的 ID。事件 ID 不會用作模型的輸入。Amazon Personalize 化使用事件 ID 來區分獨特的事件。在第一個具有相同事件 ID 之後的任何後續事件都不會用於模型訓練。

類型:字串

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

必要:否

eventValue

對應至項目互動結構描述EVENT_VALUE欄位的事件值。

類型:浮點數

必要:否

impression

項目 ID 清單,代表您已向使用者顯示的項目序列。例如 ["itemId1", "itemId2", "itemId3"]。提供項目清單,以手動記錄事件的曝光次數資料。如需記錄曝光次數資料的詳細資訊,請參閱記錄曝光數據

類型:字串陣列

陣列成員:項目數下限為 1。最多 25 個項目數。

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

必要:否

itemId

對應至項目互動資料集結構描述之ITEM_ID欄位的項目 ID 金鑰。

類型:字串

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

必要:否

metricAttribution

包含與事件相關聯的量度歸因資訊。如需測量結果屬性的詳細資訊,請參閱測量建議的影響

類型:MetricAttribution 物件

必要:否

properties

您可能會選擇要記錄的事件特定資料的字串對映。舉例來說,如果使用者對您網站上的某部電影進行評分,而不是影片 ID (itemIdeventValue) 和評分 (),您也可能會傳送使用者的影片分級數量。

在地圖中的每個項目由一個鍵值對。例如

{"numberOfRatings": "12"}

這些索引鍵會使用與 Item 互動資料集結構描述中的欄位相符的駝峰大小寫名稱。在上面的例子中,numberOfRatings將匹配項目交互數據集的模式定義的「NUMBER_OF_評級」字段。

以下內容不能作為屬性的關鍵字包含(不區分大小寫)。

  • userId

  • sessionId

  • eventType

  • timestamp

  • 建議編號

  • 印象

類型:字串

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

必要:否

recommendationId

包含使用者互動之項目之建議清單的識別碼。提供一個,recommendationId讓 Amazon Personalize 隱含地將您向使用者顯示的建議記錄為展示資料。或者,recommendationId如果您使用量度歸因來衡量建議的影響,請提供。

如需記錄曝光次數資料的詳細資訊,請參閱記錄曝光數據。如需有關建立量度歸因的詳細資訊,請參閱評估建議的影響

類型:字串

長度限制:長度下限為 1。最大長度為 40。

必要:否

另請參閱

如需在其中一個特定語言 AWS SDK 中使用此 API 的詳細資訊,請參閱下列內容: