이벤트 일괄 추적
작성일 2026.03.24 | 수정일 2026.04.14
POST/crm-core/v1/sdk/events/bulk
SDK를 통해 여러 이벤트를 일괄 추적합니다.
chat
TrackingKey 인증 방식을 사용합니다. **요청 제한**: 분당 100건, 최대 100개 이벤트
Body Params
| Name | Type | Required | Description |
|---|---|---|---|
| events | Array | 이벤트 목록 (최대 100건) | |
| recordId | string | 레코드 ID | |
| eventType | string | 이벤트 유형 | |
| entityId | string | 개체 ID | |
| category | string | 카테고리 | |
| label | string | 라벨 | |
| value | number | 값 | |
| properties | Object | 추가 속성 | |
| occurredAt | date | 발생 일시 |
Response
| Name | Type | Required | Description |
|---|---|---|---|
| created | number | 생성된 이벤트 수 |
Structure
Request Structure⎘{
"events": [
{
"recordId": "REC20260324090000ABCDEFGHIJKLMNO",
"eventType": "PURCHASE",
"entityId": "ENT20260324090000ABCDEFGHIJKLMNO",
"category": "general",
"label": "라벨",
"value": 100,
"properties": {
"key": "value"
},
"occurredAt": "2026-03-24T09:00:00.000Z"
}
]
}Response Structure⎘{
"created": 1
}