이벤트 추적
작성일 2026.03.24 | 수정일 2026.04.14
POST/crm-core/v1/sdk/events
SDK를 통해 이벤트를 추적합니다.
chat
TrackingKey 인증 방식을 사용합니다. 요청 제한은 분당 600건입니다.
Body Params
| Name | Type | Required | Description |
|---|---|---|---|
| recordId | string | 레코드 ID | |
| eventType | string | 이벤트 유형 (최대 128자) | |
| entityId | string | 개체 ID (미지정 시 TrackingKey 기본값 사용) | |
| category | string | 카테고리 (최대 128자) | |
| label | string | 라벨 (최대 512자) | |
| value | number | 값 | |
| properties | Object | 추가 속성 | |
| occurredAt | date | 발생 일시 (미지정 시 현재 시각) |
Response
| Name | Type | Required | Description |
|---|---|---|---|
| eventId | string | 이벤트 고유 ID | |
| recordId | string | 레코드 ID | |
| eventType | string | 이벤트 유형 | |
| dateCreated | date | 생성 날짜 |
Structure
Request Structure⎘{
"recordId": "REC20260324090000ABCDEFGHIJKLMNO",
"eventType": "PURCHASE",
"entityId": "ENT20260324090000ABCDEFGHIJKLMNO",
"category": "general",
"label": "라벨",
"value": 100,
"properties": {
"key": "value"
},
"occurredAt": "2026-03-24T09:00:00.000Z"
}Response Structure⎘{
"eventId": "EVT20260324090000ABCDEFGHIJKLMNO",
"recordId": "REC20260324090000ABCDEFGHIJKLMNO",
"eventType": "PURCHASE",
"dateCreated": "2026-03-24T09:00:00.000Z"
}