本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
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 由呼叫 CreateEventTracker API 產生。
類型:字串
長度限制:長度下限為 1。長度上限為 256。
必要:是
- userId
-
與事件相關聯的使用者。
類型:字串
長度限制:長度下限為 1。長度上限為 256。
必要:否
回應語法
HTTP/1.1 200
回應元素
如果動作成功,則服務會傳回具空 HTTP 內文的 HTTP 200 回應。
錯誤
- InvalidInputException
-
提供欄位或參數的有效值。
HTTP 狀態碼:400
另請參閱
如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊,請參閱以下內容: