API

이벤트 일괄 추적

작성일 2026.03.24 | 수정일 2026.03.25

POST/crm-core/v1/sdk/events/bulk

SDK를 통해 여러 이벤트를 일괄 추적합니다.

chat

TrackingKey 인증 방식을 사용합니다.

요청 제한: 분당 100건, 최대 100개 이벤트

Body Params

Name	Type	Required	Description
events	Array<Object>	*	이벤트 목록 (최대 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
}