DA Ads API는 Intellecta SSP가 자체 운영하는 캠페인 전용 광고 요청 API입니다. 매체사는 HTTP GET 방식으로 광고를 요청하고, JSON 형태의 광고 응답(adm)을 렌더링합니다.

HTTP GET 방식으로 광고 요청 URL을 호출합니다. 아래 정의된 파라미터의 필수 정보를 포함하여, 최대한 많은 파라미터를 포함하여 요청하여야 원활한 광고 응답이 이루어질 수 있습니다.

2.1 도메인 정보

2.2 파라미터

요청에 대한 응답은 JSON 문자열 형태로 응답합니다.

3.1 기본 오브젝트

3.2 data 오브젝트

3.3 adm 응답 예시

{
  "success": true,
  "data": {
    "ads": {
      "ads_id": 0,
      "imp_track_url": "",
      "click_track_url": "",
      "landing_url": "",
      "adm": "<div style=...>...</div>"
    }
  }
}

• 로그 수집

  배너 광고 노출 및 클릭 집계는 응답 본문(adm) 내에 포함된 트래킹 스크립트를 통해 이루어집니다. Native 광고의 경우 제공된 트래킹 링크를 해당 이벤트 시점에 맞게 호출해야 합니다.

• Timeout 설정

  원활한 사용자 경험을 위해 광고 요청 시 타임아웃은 500ms 이내로 설정할 것을 권장합니다.

• 429 Too Many Requests

  해당 응답을 받을 경우, 즉시 재요청(Retry)을 하지 말고 일정 시간 대기 후 요청량을 조절해야 합니다.

Select Ads API는 여러 DSP 소스 중 최적의 광고를 선택(Select)하여 응답하는 전용 API입니다. 매체사는 HTTP GET 방식으로 광고를 요청하고, JSON 형태의 광고 응답(adm)과 컴패니언 광고 정보를 렌더링합니다.

HTTP GET 방식으로 광고 요청 URL을 호출합니다. 아래 정의된 파라미터의 필수 정보를 포함하여, 최대한 많은 파라미터를 포함하여 요청하여야 원활한 광고 응답이 이루어질 수 있습니다.

2.1 도메인 정보

2.2 파라미터

요청에 대한 응답은 JSON 문자열 형태로 응답합니다.

3.1 기본 오브젝트

3.2 data 오브젝트

3.3 adm 응답 예시

{
  "success": true,
  "data": {
    "inventory": {
      "media_key": "12345",
      "adunit_id": 9876543,
      "adformat": "Banner",
      "width": 320,
      "height": 480,
      "fullscreen": 0
    },
    "ads": {
      "dsp_id": 0,
      "adm": "<div style=...>...</div>"
    },
    "companionads": [
      {
        "id": "banner_12345",
        "width": 300,
        "height": 250,
        "creative_url": "https://cdn.example.com/creatives/banner_12345.png",
        "click_url": "https://track.example.com/click?adid=banner_12345",
        "impression_urls": [
          "https://track.example.com/impression?adid=banner_12345"
        ],
        "click_tracking_urls": [
          "https://track.example.com/clicktrack?adid=banner_12345"
        ],
        "viewability_tracking_urls": [
          "https://measure.example.com/viewable?adid=banner_12345"
        ],
        "duration": 0,
        "mime_type": "image/png"
      }
    ]
  }
}

서버가 광고 요청에 대한 적당한 응답 항목을 선택하지 못한 경우, 광고 인벤토리의 Fill Rate을 높이기 위해 Fallback Ads가 응답될 수 있습니다. Fallback Ads는 기존 광고 응답과 동일하며, 별도 구분을 위해 ads 오브젝트 하위에 ad_type 항목이 추가됩니다.

{
  "success": true,
  "data": {
    "inventory": {
      "media_key": "12345",
      "adunit_id": 9876543,
      "adformat": "Banner",
      "width": 320,
      "height": 480,
      "fullscreen": 0
    },
    "ads": {
      "dsp_id": 0,
      "ad_type": "FallbackAds",
      "adm": "<div style=...>...</div>"
    }
  }
}

• 로그 수집

  배너 광고 노출 및 클릭 집계는 응답 본문(adm) 내에 포함된 트래킹 스크립트를 통해 이루어집니다. Video, Native 광고의 경우 제공된 트래킹 링크를 해당 이벤트 시점에 맞게 호출해야 합니다.

• Timeout 설정

  원활한 사용자 경험을 위해 광고 요청 시 타임아웃은 500ms 이내로 설정할 것을 권장합니다.

• 429 Too Many Requests

  해당 응답을 받을 경우, 즉시 재요청(Retry)을 하지 말고 일정 시간 대기 후 요청량을 조절해야 합니다.

DSP 매체의 직접광고 리포트 데이터를 조회하기 위한 API 연동규격입니다.

API 요청 시 apiKey, mediaApiKey, adunitApiKey 중 하나를 필수로 전달해야 합니다.

3.1 성공 응답

{
  "result": true,
  "data": {
    "total": 30,
    "report": [ ... ]
  }
}

3.2 에러 응답

{
  "result": false,
  "data": {
    "errorMessage": "API Key는 필수입니다."
  }
}

3.3 에러 코드

4.1 일자별 직접광고 리포트 GET

일자별 직접광고 성과 데이터를 조회합니다.

{
  "result": true,
  "data": {
    "total": 3,
    "report": [
      {
        "date": "2026-02-27",
        "req": 5000,
        "imp": 3200,
        "click": 150,
        "ctr": 4.69,
        "cost": 15000
      },
      {
        "date": "2026-02-26",
        "req": 4800,
        "imp": 3100,
        "click": 140,
        "ctr": 4.52,
        "cost": 14000
      }
    ]
  }
}

• 퍼블리셔 단위 연동

  퍼블리셔 API 인증 키(apiKey) 발급 → 일자별 직접광고 리포트 조회 (/dsp_media_report/daily)

• 미디어 단위 연동

  미디어 API 인증 키(mediaApiKey) 발급 → 일자별 직접광고 리포트 조회 (/dsp_media_report/daily) — 해당 미디어 데이터만 반환

• 애드유닛 단위 연동

  애드유닛 API 인증 키(adunitApiKey) 발급 → 일자별 직접광고 리포트 조회 (/dsp_media_report/daily) — 해당 애드유닛 데이터만 반환

• 날짜 형식

  모든 날짜는 YYYYMMDD 형식(8자리 숫자)으로 전달해야 합니다.

• 미래 날짜 조회 불가

  미래 날짜는 조회할 수 없습니다. 시작일은 종료일보다 이전이거나 같아야 합니다.

• 조회 기간

  일자별 리포트는 최대 180일 미만의 기간만 조회 가능합니다.

• 비용 단위

  비용(cost)은 원(KRW) 단위이며 소수점 이하는 버림 처리됩니다.

• 정렬

  데이터는 최신 날짜 순(내림차순)으로 정렬됩니다.

• 선택 파라미터

  mediaId, adunitId, platformId는 선택 파라미터이며, 복수 필터 동시 적용이 가능합니다. platformId는 콤마(,)로 구분하여 복수 전달 가능합니다. (예: platformId=1,2)

• 키 사용 시 무시 규칙

  mediaApiKey 사용 시 mediaId 파라미터는 무시됩니다. adunitApiKey 사용 시 mediaId, adunitId 파라미터는 무시됩니다.