기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
PutEvents
항목 상호 작용 이벤트 데이터를 기록합니다. 자세한 내용은 항목 상호 작용 이벤트 기록을 참조하세요.
참고
AWS Lambda 함수를 사용하여 PutEvents 작업을 호출하는 경우 함수의 실행 역할에 Resource
요소에 와일드카드가 *
포함된 personalize:PutEvents
작업을 수행할 수 있는 권한이 있어야 합니다.
Request Syntax
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. 사용자가 웹 사이트를 처음 방문하거나 애플리케이션을 처음 사용할 때 애플리케이션에서 세션 ID를 생성합니다. Personalize는 사용자가 로그인하기 전에 세션 ID를 사용하여 이벤트를 해당 사용자와 연결합니다. 자세한 내용은 항목 상호 작용 이벤트 기록을 참조하세요.
유형: 문자열
길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256.
필수 여부: 예
- trackingId
-
이벤트의 트랜잭션 ID. ID는 CreateEvent트래커 API를 호출하여 생성됩니다.
유형: 문자열
길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256.
필수 여부: 예
- userId
-
이벤트와 연결된 사용자.
유형: 문자열
길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256.
필수 여부: 아니요
응답 구문
HTTP/1.1 200
Response Elements
작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.
Errors
- InvalidInputException
-
필드 또는 파라미터에 유효한 값을 제공합니다.
HTTP 상태 코드: 400
참고
언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.