메인 콘텐츠로 건너뛰기
GET
/
v1
/
projects
/
{projectId}
/
statistics.csv
get-campaign-statistics-csv
curl --request GET \
  --url https://api.notifly.tech/v1/projects/{projectId}/statistics.csv \
  --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",
    "resource_id": "xyz123",
    "resource_name": "2025 여름 할인 캠페인",
    "node_id": null,
    "node_mane": null,
    "variant_id": "xyz123",
    "variant_name": "할인율 50%",
    "channel": "push-notification",
    "channel_sub": "image",
    "brand_message_target": "M",
    "tags": [
      "summer",
      "discount",
      "mobile"
    ],
    "message_sent": 1500,
    "message_failed": 23,
    "delivered": 1477,
    "click": 234,
    "conversion": [
      {
        "name": "구매완료",
        "type": "전체 전환",
        "count": 45
      },
      {
        "name": "구매완료",
        "type": "전환 매출",
        "count": 138849
      }
    ]
  },
  {
    "date": "2025-06-01",
    "resource_type": "user-journey",
    "resource_id": "xyz123",
    "resource_name": "신규 회원 온보딩",
    "node_id": "abc123",
    "node_mane": "회원가입 d+1 메시지",
    "variant_id": "xyz123",
    "variant_name": "환영 메시지",
    "channel": "kakao-alimtalk",
    "channel_sub": null,
    "brand_message_target": null,
    "tags": [],
    "message_sent": 892,
    "message_failed": 5,
    "delivered": 887,
    "click": 156,
    "conversion": [
      {
        "name": "프로필완성",
        "type": "전체 전환",
        "count": 5
      }
    ]
  }
]
조회 조건전일 데이터는 매일 오전 7시(KST)에 집계가 완료됩니다. 정확한 전일 데이터 조회를 위해서는 오전 7시 이후에 API를 호출하시기를 권장합니다.
집계 표기 일자일자별 데이터는 발생 일자 기준으로 집계 및 표기됩니다. 예를 들어 7월 23일 발송한 캠페인의 클릭이 24일에 발생했다면, 23일에 발송, 24일에 클릭 이벤트가 집계됩니다.

인증

Authorization
string
header
필수

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

경로 매개변수

projectId
string
필수

프로젝트 ID

본문

application/json
start
string<date>
필수

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

end
string<date>
필수

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

tags
string[]

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

응답

성공적인 통계 조회입니다

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[]

전환 데이터 배열