本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
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 (
itemId
eventValue
) 和評分 (),您也可能會傳送使用者的影片分級數量。在地圖中的每個項目由一個鍵值對。例如
{"numberOfRatings": "12"}
這些索引鍵會使用與 Item 互動資料集結構描述中的欄位相符的駝峰大小寫名稱。在上面的例子中,
numberOfRatings
將匹配項目交互數據集的模式定義的「NUMBER_OF_評級」字段。以下內容不能作為屬性的關鍵字包含(不區分大小寫)。
-
userId
-
sessionId
-
eventType
-
timestamp
-
建議編號
-
印象
類型:字串
長度限制:長度下限為 1。長度上限為 1024。
必要:否
-
- recommendationId
-
包含使用者互動之項目之建議清單的識別碼。提供一個,
recommendationId
讓 Amazon Personalize 隱含地將您向使用者顯示的建議記錄為展示資料。或者,recommendationId
如果您使用量度歸因來衡量建議的影響,請提供。如需記錄曝光次數資料的詳細資訊,請參閱記錄曝光數據。如需有關建立量度歸因的詳細資訊,請參閱評估建議的影響。
類型:字串
長度限制:長度下限為 1。最大長度為 40。
必要:否
另請參閱
如需在其中一個特定語言 AWS SDK 中使用此 API 的詳細資訊,請參閱下列內容: