PutEvents - Amazon Personalize

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

PutEvents

記錄項目互動事件資料。如需詳細資訊,請參閱記錄項目互動事件

注意

如果您使用 AWS Lambda 函數呼叫 PutEvents 作業,則函數的執行角色必須具有使用萬用字元在Resource元素*中執行personalize:PutEvents動作的權限。

請求語法

POST /events HTTP/1.1 Content-type: application/json { "eventList": [ { "eventId": "string", "eventType": "string", "eventValue": number, "impression": [ "string" ], "itemId": "string", "metricAttribution": { "eventAttributionSource": "string" }, "properties": "string", "recommendationId": "string", "sentAt": number } ], "sessionId": "string", "trackingId": "string", "userId": "string" }

URI 請求參數

請求不會使用任何 URI 參數。

請求主體

請求接受採用 JSON 格式的下列資料。

eventList

工作階段中的事件資料清單。

類型:Event 物件陣列

陣列成員:項目數下限為 1。項目數上限為 10。

必要:是

sessionId

與使用者造訪相關聯的工作階段 ID。當使用者第一次造訪您的網站或使用您的應用程式時,您的應用程式會產生 sessionId。Amazon Personalize 使用 sessionId 將事件與使用者登入之前建立關聯。如需詳細資訊,請參閱記錄項目互動事件

類型:字串

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

必要:是

trackingId

事件的追蹤 ID。ID 是透過呼叫CreateEvent追蹤器 API 所產生。

類型:字串

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

必要:是

userId

與事件相關聯的使用者。

類型:字串

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

必要:否

回應語法

HTTP/1.1 200

回應元素

如果動作成功,則服務會傳回具空 HTTP 內文的 HTTP 200 回應。

錯誤

InvalidInputException

提供欄位或參數的有效值。

HTTP 狀態碼:400

另請參閱

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