本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
代表使用 PutEvents
API 傳送的項目互動事件資訊。
目錄
- eventType
-
事件的類型,例如點擊或下載。此屬性會對應至項目互動資料集結構描述
EVENT_TYPE
的欄位,並取決於您正在追蹤的事件類型。類型:字串
長度限制:長度下限為 1。長度上限為 256。
必要:是
- sentAt
-
事件發生時用戶端的時間戳記 (以 Unix 時間為單位)。
類型:Timestamp
必要:是
- eventId
-
與事件相關聯的 ID。如果未提供事件 ID,Amazon Personalize 會為事件產生唯一的 ID。事件 ID 不會用作模型的輸入。Amazon Personalize 使用事件 ID 來區分唯一事件。在第一個具有相同事件 ID 的第一個之後的任何後續事件,都不會用於模型訓練。
類型:字串
長度限制:長度下限為 1。長度上限為 256。
必要:否
- eventValue
-
對應至項目互動結構描述
EVENT_VALUE
欄位的事件值。類型:浮點數
必要:否
- impression
-
項目 IDs 清單,代表您已向使用者顯示的項目序列。例如:
["itemId1", "itemId2", "itemId3"]
。提供項目清單,以手動記錄事件的印模資料。如需記錄印模資料的詳細資訊,請參閱記錄印模資料。類型:字串陣列
陣列成員:項目數下限為 1。最多 25 個項目。
長度限制:長度下限為 1。長度上限為 256。
必要:否
- itemId
-
對應至項目互動資料集結構描述
ITEM_ID
欄位的項目 ID 金鑰。類型:字串
長度限制:長度下限為 1。長度上限為 256。
必要:否
- metricAttribution
-
包含與事件相關聯的指標屬性資訊。如需指標屬性的詳細資訊,請參閱測量建議的影響。
類型:MetricAttribution 物件
必要:否
- properties
-
您可以選擇記錄的事件特定資料的字串映射。例如,如果使用者對您的網站上的電影評分,除了電影 ID (
itemId
) 和評分 (eventValue
) 之外,您也可以傳送使用者所做的電影評分數量。映射中的每個項目都包含鍵值對。例如
{"numberOfRatings": "12"}
金鑰使用符合項目互動資料集結構描述中欄位的駱駝案例名稱。在上述範例中,
numberOfRatings
會符合項目互動資料集結構描述中定義的 'NUMBER_OF_RATINGS' 欄位。下列項目無法包含為屬性的關鍵字 (不區分大小寫)。
-
userId
-
sessionId
-
eventType
-
timestamp
-
recommendationId
-
印模
類型:字串
長度限制:長度下限為 1。長度上限為 1024。
必要:否
-
- recommendationId
-
包含使用者互動項目的建議清單 ID。提供
recommendationId
讓 Amazon Personalize 隱含記錄您向使用者顯示為印模資料的建議。或者,recommendationId
如果您使用指標屬性來測量建議的影響,請提供 。如需記錄印模資料的詳細資訊,請參閱記錄印模資料。如需建立指標屬性的詳細資訊,請參閱測量建議的影響。
類型:字串
長度限制:長度下限為 1。長度上限為 40。
必要:否
另請參閱
如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊,請參閱以下內容: