메인 콘텐츠로 건너뛰기
POST
/
v1
/
projects
/
{projectId}
/
statistics
get-campaign-statistics
curl --request POST \
  --url https://api.notifly.tech/v1/projects/{projectId}/statistics \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "start": "2025-06-01",
  "end": "2025-06-07",
  "tags": [
    "exampleTag"
  ]
}'
[
  {
    "date": "2025-06-01",
    "resource_type": "campaign",
    "message": {
      "title": "여름 할인 이벤트",
      "body": "최대 50% 할인 혜택을 놓치지 마세요!"
    },
    "campaign_id": "xyz123",
    "campaign_name": "2025 여름 할인 캠페인",
    "variant_id": "xyz123",
    "variant_name": "할인율 50%",
    "tags": [
      "summer",
      "discount",
      "mobile"
    ],
    "user_journey_id": null,
    "user_journey_name": null,
    "user_journey_node_id": null,
    "user_journey_node_name": null,
    "channel": "push-notification",
    "message_sent": 1500,
    "message_failed": 23,
    "delivered": 1477,
    "click": 234,
    "conversion": [
      {
        "name": "구매완료",
        "type": "total_count_conversion",
        "count": 45
      },
      {
        "name": "구매완료",
        "type": "direct_count_conversion",
        "count": 45
      }
    ]
  },
  {
    "date": "2025-06-01",
    "resource_type": "user-journey",
    "message": {
      "subject": "온보딩 완료 축하",
      "content": "회원가입을 축하드립니다!"
    },
    "campaign_id": null,
    "campaign_name": null,
    "variant_id": null,
    "variant_name": null,
    "tags": [],
    "user_journey_id": "xyz123",
    "user_journey_name": "신규 회원 온보딩",
    "user_journey_node_id": "xyz123",
    "user_journey_node_name": "환영 메시지",
    "channel": "email",
    "message_sent": 892,
    "message_failed": 5,
    "delivered": 887,
    "click": 156,
    "conversion": [
      {
        "name": "프로필완성",
        "type": "total_count_conversion",
        "count": 78
      }
    ]
  }
]
조회 조건전일 데이터는 매일 오전 7시(KST)에 집계가 완료됩니다. 정확한 전일 데이터 조회를 위해서는 오전 7시 이후에 API를 호출하시기를 권장합니다.
집계 표기 일자일자별 데이터는 발생 일자 기준으로 집계 및 표기됩니다. 예를 들어 7월 23일 발송한 캠페인의 클릭이 24일에 발생했다면, 23일에 발송, 24일에 클릭 이벤트가 집계됩니다.
메시지 통계 상세 조회와 차이점메시지 통계 상세 조회는 캠페인을 특정해야 하지만 메시지 통계 조회는 요청한 기간 동안 집계된 모든 캠페인/유저여정에 대해 일자별 집계 수를 제공합니다.

Authorizations

Authorization
string
header
required

POST /authenticate로 발급받은 인증 토큰

Path Parameters

projectId
string
required

프로젝트 ID

Body

application/json
start
string<date>
required

조회 시작일자 (yyyy-MM-dd, KST 기준)

end
string<date>
required

조회 종료일자 (yyyy-MM-dd, KST 기준, 조회 당일 제외)

tags
string[]

필터링 하고자 하는 캠페인 태그 (복수 개의 태그인 경우, 배열 내의 모든 태그를 포함하는 캠페인만 반환, OR 연산)

Response

성공적인 통계 조회입니다

date
string

통계 데이터 날짜 (YYYY-MM-DD 형식)

resource_type
enum<string>

리소스 타입

사용 가능한 옵션:
campaign,
user-journey
message
object

메시지 내용 (채널별로 상이한 구조)

campaign_id
string | null

캠페인 ID (캠페인 리소스인 경우에만 존재)

campaign_name
string | null

캠페인 이름 (캠페인 리소스인 경우에만 존재)

variant_id
string | null

Variant ID (캠페인 리소스이고, A/B 테스트인 경우에만 존재)

variant_name
string | null

Variant 이름 (캠페인 리소스이고, A/B 테스트인 경우에만 존재)

tags
string[]

캠페인 태그 목록

user_journey_id
string | null

유저 여정 ID (유저 여정 리소스인 경우에만 존재)

user_journey_name
string | null

유저 여정 이름 (유저 여정 리소스인 경우에만 존재)

user_journey_node_id
string | null

유저 여정 노드 ID (유저 여정 리소스인 경우에만 존재)

user_journey_node_name
string | null

유저 여정 노드 이름 (유저 여정 리소스인 경우에만 존재)

channel
string

발송 채널 정보

message_sent
integer

발송 시도된 메시지 수

message_failed
integer

발송 실패한 메시지 수

delivered
integer | null

전달 완료된 메시지 수 (채널에서 지원하지 않는 경우 null)

click
integer | null

클릭된 메시지 수 (채널에서 지원하지 않는 경우 null)

conversion
object[]

전환 데이터 배열