Danal Pulse API 명세

먼저 알아야 할 모델

Pulse의 모든 데이터는 프로젝트 → 앱 → 환경 세 층으로 갈립니다. 이걸 먼저 이해하지 않으면 인증은 통과하는데 데이터가 안 보이는 상황을 만납니다.

그리고 사람을 가리키는 값이 두 개입니다. 이 구분이 연동 실수의 절반을 차지합니다.

로그인 전 사용자는 externalCustomerId 없이 anonymousId만 보내고, 로그인 시점에 externalCustomerId를 붙여 보내면 Pulse가 두 흐름을 같은 personId로 잇습니다.

인증과 공통 헤더

표면이 두 개입니다. 섞어 쓰면 401이 납니다.

수집 표면 — /collect/**

앱과 서버가 데이터를 보내는 경로입니다. 앱별로 발급한 수집 키를 씁니다.

관리 표면 — /api/v1/**

콘솔이 쓰는 경로입니다. 운영에서는 다날 SSO 세션으로만 접근하며, 개발 환경에서만 Basic 인증이 허용됩니다.

공통 규약

SDK 내려받기

플랫폼별 SDK를 ZIP으로 내려받을 수 있습니다. 각 아카이브에는 소스와 빌드 파일, 그리고 버전·요구 사항을 적은 README-DOWNLOAD.txt가 들어 있습니다. 빌드 산출물과 의존성 디렉터리(build/, node_modules/, .gradle/, dist/)는 제외되어 있으니 각 플랫폼의 방식대로 빌드하세요.

전체 체크섬 목록은 SHA256SUMS.txt에 있습니다.

내려받은 파일 검증

# macOS / Linux
shasum -a 256 danal-pulse-android-sdk.zip

# Windows PowerShell
Get-FileHash danal-pulse-android-sdk.zip -Algorithm SHA256

# 위 표 또는 SHA256SUMS.txt 의 값과 일치해야 합니다.

플랫폼별 SDK 연동

아래 API를 직접 호출해도 되지만, 대부분은 SDK를 쓰는 편이 낫습니다. SDK가 대신 처리하는 일이 적지 않습니다.

어느 SDK를 쓰나

모든 SDK가 공통으로 지키는 것

Android

설치

// settings.gradle.kts — 사내 저장소 또는 소스 포함
dependencyResolutionManagement {
  repositories { maven { url = uri("https://maven.danal.internal/releases") } }
}

// app/build.gradle.kts
android {
  defaultConfig { minSdk = 26 }
  compileOptions { targetCompatibility = JavaVersion.VERSION_17 }
}
dependencies {
  implementation("com.danal.pulse:pulse-sdk:0.1.0")
  // Play 설치 리퍼러를 쓸 때만. 호스트가 명시적으로 옵트인할 때만 로드됩니다.
  implementation("com.android.installreferrer:installreferrer:2.2")
}

초기화

import com.danal.pulse.sdk.*

private val prefs = context.getSharedPreferences("pulse", Context.MODE_PRIVATE)

val pulse = PulseClient(
    PulseAndroidConfig(
        endpoint = "https://collect.danal.internal",
        projectId = "prj_danal",
        appId = BuildConfig.PULSE_APP_ID,
        apiKey = BuildConfig.PULSE_API_KEY,   // 키를 앱에 심는다면 반드시 제한된 전용 키로
        // 저장 방법은 호스트가 정합니다. 암호화가 필요하면 EncryptedSharedPreferences를 넘기세요.
        storage = PulseStorage { value -> prefs.edit().putString("queue", value).apply() },
        storageReader = PulseStorageReader { prefs.getString("queue", null) },
        environment = PulseEnvironment.PRODUCTION,
        flushIntervalSeconds = 10,
        onError = { throwable -> Log.w("Pulse", throwable) },
    )
)

사용

// 로그인 시점
pulse.identify("damoum-member-1")

// 이벤트 — 반환값이 false면 이름 검증에 걸렸거나 큐가 가득 찬 것입니다
val queued = pulse.track(
    eventName = "purchase",
    properties = mapOf("revenue" to 39000, "currency" to "KRW"),
    consent = mapOf("analytics" to true, "marketing" to true),
)

// 인앱 메시지 — 응답 JSON 문자열을 그대로 돌려줍니다
pulse.pullInAppMessagesAsync(placement = "home", limit = 3).thenAccept { json -> render(json) }
pulse.trackInAppEngagementAsync(deliveryId, type = "IMPRESSION")

// 설치 리퍼러 — 첫 실행에서 한 번. Play 라이브러리를 여기서만 반사적으로 로드합니다.
// Activity 가 아니라 applicationContext 를 넘기세요.
pulse.collectGooglePlayInstallReferrerOnFirstOpen(context.applicationContext)
    .thenAccept { result -> Log.d("Pulse", "referrer=$result") }

// 지연 딥링크
pulse.resolveDeferredDeepLink(clickId).thenAccept { result ->
    if (result.resolved) navigate(result.deferredDeepLink) else navigateHome()
}

// 앱 종료 시 — AutoCloseable 입니다
pulse.close()

iOS

설치

// Swift Package Manager — Package.swift
dependencies: [
  .package(url: "https://git.danal.internal/pulse/ios-sdk.git", from: "0.1.0")
]

// 또는 CocoaPods — 저장소를 동봉한 경우
pod 'DanalPulse', :path => '../sdks/ios'

최소 요구: iOS 15 · Swift 6.

초기화

import DanalPulse

let configuration = PulseConfiguration(
    endpoint: URL(string: "https://collect.danal.internal")!,
    projectId: "prj_danal",
    appId: appId,
    apiKey: apiKey,
    storage: KeychainPulseStorage(),   // PulseStorage 를 구현해 넘깁니다
    batchSize: 100,
    maxQueueSize: 10_000,
    environment: .production
)

// 초기화는 던지지 않습니다. 설정이 잘못돼도 앱이 죽지 않도록 검증 결과를 값으로 돌려줍니다.
guard configuration.isValid else {
    assertionFailure("Pulse 설정 오류: \(String(describing: configuration.validationError))")
    return
}
let pulse = PulseClient(configuration: configuration)

사용

// PulseClient 는 actor 입니다 — 모든 호출에 await 가 필요합니다
await pulse.identify("damoum-member-1")

let queued = await pulse.track(
    "purchase",
    properties: ["revenue": .number(39000), "currency": .string("KRW")],
    consent: ["analytics": .bool(true), "marketing": .bool(true)]
)

// ATT 상태를 함께 보낼 때
await pulse.track("app_open", privacy: PulsePrivacyContext(
    trackingAuthorizationStatus: .authorized,
    advertisingIdType: .idfa,
    advertisingId: idfa,
    advertisingIdConsent: true,
    limitAdTracking: false,
    collectedAt: Date()
))

let messages = await pulse.pullInAppMessages(placement: "home", limit: 3)
await pulse.trackInAppEngagement(deliveryId: messages[0].deliveryId, type: .impression)

let deferred = await pulse.resolveDeferredDeepLink(clickId: clickId)
if deferred.resolved { navigate(deferred.deferredDeepLink) }

await pulse.flush()   // 백그라운드 진입 직전

Flutter

설치

# pubspec.yaml
dependencies:
  danal_pulse:
    path: ../sdks/flutter      # 또는 사내 pub 저장소
environment:
  sdk: ">=3.4.0 <4.0.0"
  flutter: ">=3.22.0"

초기화

import 'package:danal_pulse/danal_pulse.dart';

final pulse = DanalPulse(PulseConfig(
  endpoint: Uri.parse('https://collect.danal.internal'),
  projectId: 'prj_danal',
  appId: appId,
  apiKey: apiKey,
  source: Platform.isIOS ? 'ios' : 'android',   // web·server 는 허용되지 않습니다
  environment: PulseEnvironment.production,
  batchSize: 100,
  maxQueueSize: 10000,
));

사용

pulse.identify('damoum-member-1');

final queued = await pulse.track(
  'purchase',
  properties: {'revenue': 39000, 'currency': 'KRW'},
  consent: {'analytics': true, 'marketing': true},
);

await pulse.trackInAppEngagement(deliveryId, 'IMPRESSION');

final deferred = await pulse.resolveDeferredDeepLink(clickId);
if (deferred.resolved) context.go(deferred.deferredDeepLink!);

await pulse.flush();
final pending = await pulse.refreshPendingEvents();   // 남은 큐 길이

Web

설치

pnpm add @danal/pulse-sdk    # 사내 레지스트리 또는 workspace 참조

초기화

import { PulseClient } from "@danal/pulse-sdk";

const pulse = new PulseClient({
  endpoint: "/api/pulse-proxy",        // 자사 서버 경유를 권장
  projectId: "prj_danal",
  appId: "app_927ab22526a44548985da4404bc197bb",
  apiKey: "",                          // 프록시가 붙이므로 브라우저에는 비워둡니다
  source: "web",
  environment: "PRODUCTION",
  storage: window.localStorage,        // getItem/setItem 을 만족하면 무엇이든 됩니다
  batchSize: 20,
  flushIntervalMs: 10_000,
  onError: (error) => console.warn("[pulse]", error),
});

사용

pulse.identify("damoum-member-1");

const queued = await pulse.track("purchase", {
  properties: { revenue: 39000, currency: "KRW" },
  consent: { analytics: true, marketing: true },
});

// 인앱 메시지는 웹에서도 동작합니다
const messages = await pulse.pullInAppMessages("home", 3);
await pulse.trackInAppEngagement(messages[0].deliveryId, "IMPRESSION");

// 페이지를 떠나기 전에 큐를 비웁니다
window.addEventListener("pagehide", () => { void pulse.flush(); });

Server

결제 승인·환불·정산처럼 앱이 모르는 사건을 보냅니다. 서버는 키를 안전하게 보관할 수 있는 유일한 곳이므로, 웹·앱의 중계도 여기서 맡는 것이 좋습니다.

초기화

import { PulseClient } from "@danal/pulse-sdk";

const pulse = new PulseClient({
  endpoint: process.env.PULSE_ENDPOINT!,
  projectId: "prj_danal",
  appId: process.env.PULSE_APP_ID!,
  apiKey: process.env.PULSE_API_KEY!,   // 환경변수 이름으로만 참조. 소스에 리터럴 금지
  source: "server",
  environment: "PRODUCTION",
  batchSize: 200,
  flushIntervalMs: 5_000,
  maxQueueBytes: 2_000_000,
  onError: (error) => logger.warn({ error }, "pulse delivery failed"),
});

사용

// 결제 승인 — eventTime 은 반드시 "승인된 시각"이어야 합니다
await pulse.track("purchase", {
  eventId: paymentId,                  // 결제 ID를 그대로 쓰면 재시도가 자연히 멱등해집니다
  eventTime: approvedAt,
  properties: { revenue: amount, currency: "KRW", channel: "danal-pay" },
  consent: { analytics: true, marketing: marketingAgreed },
});

// 브라우저 중계 — 자사 엔드포인트에서 키를 붙여 그대로 넘깁니다
app.post("/api/pulse-proxy/collect/v1/batch", async (req, res) => {
  const upstream = await fetch(`${process.env.PULSE_ENDPOINT}/collect/v1/batch`, {
    method: "POST",
    headers: {
      "Content-Type": "application/json; charset=utf-8",
      "X-Pulse-Api-Key": process.env.PULSE_API_KEY!,
      "X-Pulse-App-Id": process.env.PULSE_APP_ID!,
      "X-Pulse-Environment": "PRODUCTION",
    },
    body: JSON.stringify(req.body),
  });
  res.status(upstream.status).send(await upstream.text());
});

// 프로세스 종료 전 — 남은 큐를 비우고 타이머를 정리합니다
process.on("SIGTERM", async () => { await pulse.shutdown(); });

React Native

TypeScript SDK를 그대로 쓰되, 저장소로 AsyncStorage를 넘깁니다. 네이티브 모듈을 함께 붙이면 설치 리퍼러처럼 JS에서 얻을 수 없는 신호도 수집됩니다.

import AsyncStorage from "@react-native-async-storage/async-storage";
import { PulseClient } from "@danal/pulse-sdk";

const pulse = new PulseClient({
  endpoint, projectId, appId, apiKey,
  source: Platform.OS === "ios" ? "ios" : "android",
  environment: "PRODUCTION",
  storage: AsyncStorage,              // getItem/setItem 시그니처가 그대로 맞습니다
  flushIntervalMs: 10_000,
  onError: () => setStatus("오프라인 큐에 보관"),
});

// 앱이 백그라운드로 갈 때
AppState.addEventListener("change", (next) => {
  if (next !== "active") void pulse.flush();
});

지원 범위는 React Native 0.76 이상 0.84 미만입니다.

① 수집 키 발급

앱이 수집 API를 호출할 때 쓸 키를 만듭니다. 관리 표면 — SSO 세션 또는 개발용 Basic 인증이 필요합니다.

요청 파라미터

요청 예시

POST /api/v1/api-keys?projectId=prj_danal&appId=app_927ab22526a44548985da4404bc197bb
Content-Type: application/json; charset=utf-8
X-Pulse-Project-Id: prj_danal
X-Pulse-Environment: PRODUCTION
Origin: https://pulse.danal.internal
X-Change-Reason: PULSE-1234 issue collector key for damoum android

{
  "name": "damoum-android-collector",
  "expiresInDays": 365
}

응답 파라미터

응답 예시

200 OK

{
  "key": "pk_live_9f2c8a1d4b7e0c53a6f19d28e4b70c11",
  "metadata": {
    "id": "key_5c1f0a9e2d834b6f9a77c0e1b2d34f56",
    "projectId": "prj_danal",
    "appId": "app_927ab22526a44548985da4404bc197bb",
    "name": "damoum-android-collector",
    "keyPrefix": "pk_live_9f2c",
    "status": "ACTIVE",
    "createdBy": "pulse-admin",
    "createdAt": "2026-08-03T00:10:00Z",
    "expiresAt": "2027-08-03T00:10:00Z",
    "revokedAt": null
  }
}

② 이벤트 수집

구매·조회·로그인 등 사용자 행동을 보냅니다. Pulse의 거의 모든 기능이 이 데이터 위에 올라갑니다.

요청 파라미터

본문은 { "events": [ … ] }이며 이벤트 1~500건입니다. 각 이벤트의 필드는 다음과 같습니다.

요청 예시

POST /collect/v1/batch
X-Pulse-Api-Key: pk_live_9f2c8a1d4b7e0c53a6f19d28e4b70c11
X-Pulse-App-Id: app_927ab22526a44548985da4404bc197bb
X-Pulse-Environment: PRODUCTION
Content-Type: application/json; charset=utf-8

{
  "events": [
    {
      "eventId": "0f3b9a12-7c44-4a8e-9a11-2b6d4e5f7c80",
      "eventName": "purchase",
      "eventTime": "2026-08-03T00:12:34Z",
      "source": "android",
      "projectId": "prj_danal",
      "appId": "app_927ab22526a44548985da4404bc197bb",
      "externalCustomerId": "damoum-member-1",
      "sessionId": "sess-8821",
      "properties": { "revenue": 39000, "currency": "KRW", "item_count": 2 },
      "consent": { "analytics": true, "marketing": true }
    },
    {
      "eventId": "1a7c2e55-90b3-4f61-8d2a-77c1e0b9a344",
      "eventName": "add_to_cart",
      "eventTime": "2026-08-03T00:11:02Z",
      "source": "android",
      "projectId": "prj_danal",
      "appId": "app_927ab22526a44548985da4404bc197bb",
      "anonymousId": "anon-4f81c2",
      "properties": { "item_id": "SKU-9931" },
      "consent": { "analytics": true, "marketing": false }
    }
  ]
}

응답 파라미터

응답 예시

202 Accepted

{
  "requestId": "req_a1f98297aa854c609bcc4c532630d48c",
  "accepted": 1,
  "duplicates": 0,
  "rejected": 1,
  "results": [
    {
      "eventId": "0f3b9a12-7c44-4a8e-9a11-2b6d4e5f7c80",
      "status": "ACCEPTED",
      "code": null,
      "detail": null,
      "normalizedShape": { "revenue": "NUMBER", "currency": "STRING", "item_count": "NUMBER" },
      "normalizationDiff": []
    },
    {
      "eventId": "1a7c2e55-90b3-4f61-8d2a-77c1e0b9a344",
      "status": "REJECTED",
      "code": "RAW_EMAIL_FORBIDDEN",
      "detail": "$.properties.contact",
      "normalizedShape": null,
      "normalizationDiff": []
    }
  ]
}

③ 푸시 기기 등록

이 호출을 하지 않으면 그 사용자는 푸시 대상이 되지 않습니다. FCM 토큰이 갱신될 때마다 다시 호출하세요.

요청 파라미터

요청 예시

POST /collect/v1/devices
X-Pulse-Api-Key: pk_live_9f2c8a1d4b7e0c53a6f19d28e4b70c11
X-Pulse-App-Id: app_927ab22526a44548985da4404bc197bb
X-Pulse-Environment: PRODUCTION
Content-Type: application/json; charset=utf-8

{
  "projectId": "prj_danal",
  "appId": "app_927ab22526a44548985da4404bc197bb",
  "externalCustomerId": "damoum-member-1",
  "platform": "ANDROID",
  "token": "fL9xQ2mBS0y…",
  "identifierKind": "REGISTRATION_TOKEN",
  "pushConsent": true
}

응답 파라미터

응답 예시

200 OK

{
  "deviceId": "dev_3b7f21c0a95c4f0e8d6a2b1c4e5f7a80",
  "personId": "per_7c56f4326a6e4535b23725f31a8639e0",
  "status": "ACTIVE",
  "pushConsent": true
}

④ 앱 삭제 신호

더 이상 도달하지 않는 기기를 발송 대상에서 빼기 위한 신호입니다. 앱이 직접 보고할 수도 있고, FCM/APNS가 알려준 무효 토큰을 서버가 중계할 수도 있습니다.

요청 파라미터

요청 예시

POST /collect/v1/devices/uninstall
X-Pulse-Api-Key: pk_live_9f2c8a1d4b7e0c53a6f19d28e4b70c11
X-Pulse-App-Id: app_927ab22526a44548985da4404bc197bb
X-Pulse-Environment: PRODUCTION
Content-Type: application/json; charset=utf-8

{
  "projectId": "prj_danal",
  "appId": "app_927ab22526a44548985da4404bc197bb",
  "clientSignalId": "uninstall-2026-08-03-0001",
  "token": "fL9xQ2mBS0y…",
  "source": "FCM",
  "occurredAt": "2026-08-03T00:20:00Z"
}

응답 파라미터

응답 예시

200 OK

{
  "signalId": "uns_2f7b91c04a6d4e1f8b35c2a70d9e1f43",
  "duplicate": false,
  "matchedDevice": true,
  "deviceStatus": "UNINSTALLED"
}

⑤ 인앱 메시지 조회

앱이 화면을 띄울 때 앱이 먼저 물어보는 방식(pull)입니다. Pulse가 밀어 넣지 않습니다. 동의·억제·일일 노출 제한은 이 시점에 서버가 이미 적용하므로, 앱은 받은 것을 그대로 그리면 됩니다.

요청 파라미터

요청 예시

POST /collect/v1/in-app/messages
X-Pulse-Api-Key: pk_live_9f2c8a1d4b7e0c53a6f19d28e4b70c11
X-Pulse-App-Id: app_927ab22526a44548985da4404bc197bb
X-Pulse-Environment: PRODUCTION
Content-Type: application/json; charset=utf-8

{
  "projectId": "prj_danal",
  "appId": "app_927ab22526a44548985da4404bc197bb",
  "externalCustomerId": "damoum-member-1",
  "placement": "home",
  "limit": 3
}

응답 파라미터

응답 예시

200 OK

{
  "evaluatedAt": "2026-08-03T00:30:00Z",
  "messages": [
    {
      "deliveryId": "ind_6a2c94f10b7d4e83a5619c0f2b3d47e8",
      "campaignId": "iac_18b0d7c25e9f4a3c81f6b02d4e7a9c31",
      "placement": "home",
      "title": "새 리워드가 도착했어요",
      "body": "지금 확인하고 받아가세요",
      "imageUrl": "https://cdn.danal.co.kr/reward.png",
      "buttonLabel": "받으러 가기",
      "deepLink": "danalpulse://rewards",
      "expiresAt": "2026-08-10T14:59:59Z",
      "orchestrationCampaignId": null,
      "variationKey": null,
      "data": { "screen": "rewards" }
    }
  ]
}

노출할 메시지가 없으면 messages가 빈 배열로 옵니다. 오류가 아닙니다.

⑥ 인앱 반응 보고

메시지를 띄웠는지, 눌렸는지, 닫혔는지를 보고합니다. 이 값이 콘솔의 노출·클릭·CTR이 됩니다.

요청 파라미터

요청 예시

POST /collect/v1/in-app/engagements
X-Pulse-Api-Key: pk_live_9f2c8a1d4b7e0c53a6f19d28e4b70c11
X-Pulse-App-Id: app_927ab22526a44548985da4404bc197bb
X-Pulse-Environment: PRODUCTION
Content-Type: application/json; charset=utf-8

{
  "appId": "app_927ab22526a44548985da4404bc197bb",
  "deliveryId": "ind_6a2c94f10b7d4e83a5619c0f2b3d47e8",
  "clientEventId": "imp-ind_6a2c94f1-0001",
  "type": "IMPRESSION",
  "occurredAt": "2026-08-03T00:30:02Z"
}

응답 파라미터

응답 예시

200 OK

{
  "deliveryId": "ind_6a2c94f10b7d4e83a5619c0f2b3d47e8",
  "type": "IMPRESSION",
  "duplicate": false
}

⑦ 설치 리퍼러 수집

Android 전용입니다. Play Install Referrer API로 받은 값을 가공하지 말고 그대로 넘깁니다. 광고 클릭과 설치를 잇는 근거가 됩니다.

요청 파라미터

요청 예시

POST /collect/v1/install-referrers
X-Pulse-Api-Key: pk_live_9f2c8a1d4b7e0c53a6f19d28e4b70c11
X-Pulse-App-Id: app_927ab22526a44548985da4404bc197bb
X-Pulse-Environment: PRODUCTION
Content-Type: application/json; charset=utf-8

{
  "projectId": "prj_danal",
  "appId": "app_927ab22526a44548985da4404bc197bb",
  "clientEventId": "referrer-9f31c0a2",
  "installKey": "install-8c21e0b7a4",
  "rawReferrer": "utm_source=naver&utm_medium=paid_search&utm_campaign=summer_growth&pulse_click_id=clk_5f1a…",
  "referrerClickAt": "2026-08-02T23:41:10Z",
  "installBeginAt": "2026-08-02T23:43:52Z",
  "store": "GOOGLE_PLAY",
  "collectionSource": "PLAY_INSTALL_REFERRER_API",
  "installVersion": "5.2.0"
}

응답 파라미터

응답 예시

200 OK

{
  "id": "ifr_74c2a08e15b94d3f8e0a6c1b2d3e4f50",
  "appId": "app_927ab22526a44548985da4404bc197bb",
  "clientEventId": "referrer-9f31c0a2",
  "store": "GOOGLE_PLAY",
  "collectionSource": "PLAY_INSTALL_REFERRER_API",
  "status": "COLLECTED",
  "duplicate": false,
  "mediaSource": "naver",
  "channel": "paid_search",
  "campaign": "summer_growth",
  "hasPulseClickId": true,
  "clickId": "clk_5f1ac93b7e2d48a6bf01c8e5d7a29304",
  "deferredDeepLink": "danalpulse://cart",
  "referrerClickAt": "2026-08-02T23:41:10Z",
  "installBeginAt": "2026-08-02T23:43:52Z",
  "collectedAt": "2026-08-03T00:05:11Z"
}

⑧ 지연 딥링크 해석

앱이 없던 사용자가 링크를 눌러 설치한 뒤, 첫 실행에서 원래 가려던 화면을 알아내는 호출입니다.

요청 파라미터

요청 예시

POST /collect/v1/deferred-deep-links/resolve
X-Pulse-Api-Key: pk_live_9f2c8a1d4b7e0c53a6f19d28e4b70c11
X-Pulse-App-Id: app_927ab22526a44548985da4404bc197bb
X-Pulse-Environment: PRODUCTION
Content-Type: application/json; charset=utf-8

{
  "projectId": "prj_danal",
  "appId": "app_927ab22526a44548985da4404bc197bb",
  "clickId": "clk_5f1ac93b7e2d48a6bf01c8e5d7a29304",
  "clientEventId": "ddl-first-open-0001",
  "installInstanceId": "install-8c21e0b7a4"
}

응답 파라미터

응답 예시

200 OK  — 해석 성공

{
  "resolved": true,
  "duplicate": false,
  "clientEventId": "ddl-first-open-0001",
  "clickId": "clk_5f1ac93b7e2d48a6bf01c8e5d7a29304",
  "deferredDeepLink": "danalpulse://cart?pulse_click_id=clk_5f1ac93b…",
  "mediaSource": "naver",
  "channel": "paid_search",
  "campaign": "summer_growth"
}

200 OK  — 해석 대상 없음(유기 설치)

{
  "resolved": false,
  "duplicate": false,
  "clientEventId": "ddl-first-open-0001",
  "clickId": null,
  "deferredDeepLink": null,
  "mediaSource": null,
  "channel": null,
  "campaign": null
}

⑨ 트래킹 링크 리디렉션

마케터가 콘솔에서 만든 링크입니다. 인증이 없는 공개 경로이고, User-Agent로 기기를 판별해 목적지를 고릅니다. 클릭이 기록되고 clk_…가 발급됩니다.

요청 파라미터

요청 예시

GET /r/summer-2026?code=1234 HTTP/1.1
Host: link.danal.co.kr
User-Agent: Mozilla/5.0 (Linux; Android 15; SM-S928N) AppleWebKit/537.36 …

응답 파라미터

본문이 없는 리디렉션입니다. 판단은 상태 코드와 Location 헤더로 합니다.

응답 예시

HTTP/1.1 302 Found
Location: danalpulse://cart?pulse_click_id=clk_5f1ac93b7e2d48a6bf01c8e5d7a29304

--- 만료된 링크 ---
HTTP/1.1 410 Gone

응답 코드 전체

HTTP 상태

건별 판정 코드

보내면 안 되는 데이터

자주 막히는 지점

401이 계속 납니다

수집 키는 앱 단위입니다. X-Pulse-App-Id가 그 키를 발급받은 앱과 다르면 무조건 401입니다. 헤더 두 개가 짝인지 먼저 확인하세요.

인증은 되는데 콘솔에 데이터가 없습니다

순서대로 보세요. ① X-Pulse-Environment가 콘솔에서 보고 있는 환경과 같은가. ② 앱이 ACTIVE인가. ③ 응답의 rejected가 0인가.

재전송했더니 중복으로 쌓였습니다

eventId를 재시도마다 새로 만들고 있을 가능성이 큽니다. 이벤트를 처음 만들 때 한 번 생성해서 재시도에도 같은 값을 쓰세요.

푸시가 성공했다는데 안 옵니다

Pulse가 보고하는 성공은 FCM이 접수했다는 뜻입니다. ① 기기가 등록되어 있는가. ② pushConsent가 true인가. ③ 마케팅 동의가 있는가. ④ 콘솔에서 억제·홀드아웃이 올라가지 않았는가.

대량 발송을 요청했는데 응답이 즉시 왔습니다

정상입니다. 발송은 계획만 커밋하고 반환하며 실제 전송은 워커가 청크 단위로 처리합니다.

시각이 이상하게 찍힙니다

eventTime에 타임존이 없는 문자열을 보내면 거절됩니다. 항상 Z 또는 오프셋을 붙이세요. 콘솔 표시는 Asia/Seoul 24시간제로 통일되어 있습니다.