캠페인 이벤트 데이터 내보내기 결과 조회

get-campaign-event-export-result

curl --request GET \
  --url https://api.notifly.tech/projects/{projectId}/campaign-event-data/exports/{exportId}/result \
  --header 'Authorization: <api-key>'

{
  "status": "success",
  "data": [
    {
      "id": "E252EB67-48E3-49DC-866D-F8C26161230D",
      "user_id": "user_12345",
      "notifly_user_id": "notifly_user_abcde",
      "device_id": "ios_device_98765",
      "notifly_device_id": "notifly_device_xyz",
      "channel": "push_notification",
      "event_name": "send_success",
      "failure_reason": null,
      "resource_title": "6월 신규 혜택 안내",
      "resource_type": "campaign",
      "campaign_id": "camp_202406_promo",
      "experiment_group_name": "A",
      "user_journey_id": null,
      "user_journey_node_id": null,
      "time": "1749373994000000",
      "message_data": {
        "title": "지금 확인하고 혜택 받기!",
        "body": "6월 신규 회원님만을 위한 특별 이벤트 🎁",
        "link": "link://link/feed?id=1243"
      },
      "channel_metadata": {
        "channel_subtype": "image",
        "brand_message_target": null
      }
    }
  ],
  "total_page_count": 1
}

GET

projects

{projectId}

campaign-event-data

exports

{exportId}

result

get-campaign-event-export-result

curl --request GET \
  --url https://api.notifly.tech/projects/{projectId}/campaign-event-data/exports/{exportId}/result \
  --header 'Authorization: <api-key>'

{
  "status": "success",
  "data": [
    {
      "id": "E252EB67-48E3-49DC-866D-F8C26161230D",
      "user_id": "user_12345",
      "notifly_user_id": "notifly_user_abcde",
      "device_id": "ios_device_98765",
      "notifly_device_id": "notifly_device_xyz",
      "channel": "push_notification",
      "event_name": "send_success",
      "failure_reason": null,
      "resource_title": "6월 신규 혜택 안내",
      "resource_type": "campaign",
      "campaign_id": "camp_202406_promo",
      "experiment_group_name": "A",
      "user_journey_id": null,
      "user_journey_node_id": null,
      "time": "1749373994000000",
      "message_data": {
        "title": "지금 확인하고 혜택 받기!",
        "body": "6월 신규 회원님만을 위한 특별 이벤트 🎁",
        "link": "link://link/feed?id=1243"
      },
      "channel_metadata": {
        "channel_subtype": "image",
        "brand_message_target": null
      }
    }
  ],
  "total_page_count": 1
}

페이지네이션 방식이 API는 페이지 기반 페이지네이션을 사용합니다:

페이지 번호: 0부터 시작하는 정수 값
페이지 크기: 각 페이지당 최대 1,000개의 이벤트 데이터
전체 페이지 수: total_page_count 필드로 제공
유효한 페이지 범위: 0 ~ (total_page_count - 1)

Message Data 채널 별 지원 조건push-notification을 제외한 다른 채널의 message_data 컬럼은 2025-07-18 이후의 데이터만 지원합니다.또한, in-app-message와 in-web-message 채널은 아래의 SDK 버전 이후부터 지원됩니다:

iOS SDK: 1.17.2
Android SDK: 1.18.1
React Native SDK: 3.10.1
JavaScript SDK: 2.17.4

메시지 데이터 예시

{
  "requestId": "요청 ID",
  "requestDate": "YYYY-MM-DD HH:mm:ss",
  "templateId": "템플릿 ID",
  "title": "메시지 제목",
  "body": "본문 내용",
  "sendNo": "07000000000",
  "recipientNo": "01012345678",
  "messageType": "MMS",
  "countryCode": "82",
  "adYn": "N",
  "attachFileList": [
    {
      "fileId": 123456789,
      "fileName": "image.jpg",
      "filePath": "/path/to/image/",
      "saveFileName": "saved.jpg",
      "uploadType": "TEMPORARY"
    }
  ]
}

{
  "title": "메일 제목",
  "body": {
    "html": "<html><body><p>메일 본문</p></body></html>",
    "text": "내용"
  }
}

{
  "plusFriendId": "@채널명",
  "senderKey": "발신 키",
  "recipientNo": "01012345678",
  "content": "메시지 내용",
  "buttons": [
    {
      "ordering": 1,
      "type": "WL",
      "name": "버튼명",
      "linkMo": "https://m.example.com",
      "linkPc": "https://example.com",
      "schemeIos": "",
      "schemeAndroid": ""
    }
  ],
  "isAd": true
}

{
  "plusFriendId": "@채널명",
  "senderKey": "발신 키",
  "recipientNo": "01012345678",
  "templateCode": "템플릿 코드",
  "content": "[브랜드] 메시지 본문",
  "templateExtra": "추가 안내",
  "buttons": [
    {
      "ordering": 1,
      "type": "WL",
      "name": "버튼명",
      "linkMo": "https://m.example.com",
      "linkPc": "https://example.com"
    }
  ]
}

{
  "templateName": "템플릿 이름"
}

{
  "templateName": "템플릿 이름"
}

{
  "notifly": {
    "ti": "제목",
    "bd": "본문",
    "cid": "캠페인 ID",
    "mid": "메시지 ID",
    "u": "https://your-link.com",
    "ic": "https://your-icon.png",
    "bg": "#ffffff",
    "im": "https://your-image.jpg",
    "sd": "/push-sound.mp3",
    "tg": "notifly-push-notification",
    "vb": [200, 100, 200],
    "ri": false,
    "data": {},
    "ac": [
      { "action": "click", "title": "Go to Link" },
      { "action": "close", "title": "Close" }
    ]
  }
}

{
  "url": "https://your.webhook.endpoint",
  "method": "POST",
  "headers": {
    "Content-Type": "application/json"
  },
  "data": "{ \"key\": \"value\" }"
}

인증

Authorization

string

header

필수

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

경로 매개변수

projectId

string

필수

프로젝트 ID

exportId

string

필수

Export 요청 시 발급된 ID

쿼리 매개변수

page

integer

필수

0부터 시작하는 페이지 번호 (범위 0 ~ total_page_count - 1)

필수 범위: x >= 0

응답

해당 페이지 데이터 조회 성공입니다

status

string

data

object[]

Show child attributes

total_page_count

integer

캠페인 이벤트 데이터 내보내기 요청 메시지 통계 조회

시작하기

인증

이벤트 & 유저

캠페인

메시징

메시징 관리

내보내기 & 분석

캠페인 이벤트 데이터 내보내기 결과 조회

메시지 데이터 예시

인증

경로 매개변수

쿼리 매개변수

응답

시작하기

인증

이벤트 & 유저

캠페인

메시징

메시징 관리

내보내기 & 분석

Documentation Index

​메시지 데이터 예시

인증

경로 매개변수

쿼리 매개변수

응답

메시지 데이터 예시