POSTS
PORTFOLIO
SEARCH
SHOP
  • Your Cart Is Empty!
Your address will show here +12 34 56 78
We support you

데이블 광고성과 API

일별 광고성과 API

Parameter

FieldTypeDescription
service_nameString[필수] 서비스명 (ex: dable.io)
channelString[필수] 채널명 (ex: bottom). 전체 채널 데이터를 요청하는 경우 ALL로 지정.
access_keyString[필수] 서비스의 비밀키 (ex: Aeh528rGERH53241). 대시보드 설정 메뉴에서 확인 가능.
offsetoptionalNumbertimezone offset. 한국 시간(KST)의 경우 -540으로 지정.
skipoptionalNumber며칠전 데이터까지 요청할 것인가 지정. 0: 어제, 1: 그제, 2: 3일전, ...
agooptionalNumber며칠치 데이터까지 요청할 것인가 지정. 최대 62일까지 지정 가능.

Success 200

FieldTypeDescription
resultObject응답 결과
  dataObject일별 광고성과 데이터
  data[date]Object.ctr 클릭률
  sumObject광고성과 합계 데이터
    ctrObject클릭률
    impressionsObject노출수
    exposesObject유효노출수
    clicksObject클릭수
    cost_spentObject총 광고매출
    sharing_costObject정산매출
    void_cost_spentObject무효매출
  last_updatedString최종 업데이트 일시(ISO 8601 포맷)
  channelsString[]전체 채널 목록

Success-Response

400

FieldDescription
badRequestservice_name(서비스명), access_key(비밀키)가 잘못된 경우, ago가 62를 초과하는 경우

500

FieldDescription
serverErrorDB 접속 실패 등 서버 오류

Error-Response on 400:

 
 

일별 광고성과 (매체사 관리자 단위)

 

Parameter

FieldTypeDescription
login_idString[필수] 관리자ID (ex: dable)
access_keyString[필수] 관리자의 비밀키 (ex: Aeh528rGERH53241). 대시보드의 개인정보 확인/수정 메뉴에서 확인 가능.
offsetoptionalNumbertimezone offset. 한국 시간(KST)의 경우 -540으로 지정.
from_dateoptionalString데이터를 요청할 시작날짜 (예: 2016-01-01)
to_dateoptionalString데이터를 요청할 끝날짜 (예: 2016-02-01)
by_channeloptionalNumber1로 지정 시 채널별 데이터 요청..

Success 200

FieldTypeDescription
resultObject[]응답 결과
  service_idNumber서비스ID(ex: 1)
  service_nameString서비스명(ex: dable.io)
  dataObject일별 광고성과 데이터
  data[date]Number.ctr 클릭률
  sumObject광고성과 합계 데이터
    ctrNumber클릭률
    impressionsNumber노출수
    exposesNumber유효노출수
    clicksNumber클릭수
    cost_spentNumber총 광고매출
    sharing_costNumber정산매출
    void_cost_spentNumber무효매출
  last_updatedString최종 업데이트 일시(ISO 8601 포맷)
  channelsString[]전체 채널 목록
  channel_widget_mapObject채널명 - 위젯ID map
  channel_widget_map[channel]Stringchannel에 해당하는 위젯ID. 해당하는 위젯ID가 없을 경우 'UNKNOWN'으로 노출.

Success-Response

400

FieldDescription
badRequestlogin_id(관리자ID), access_key(비밀키)가 잘못된 경우, from_date와 to_date가 62일을 초과하는 경우

500

FieldDescription
serverErrorDB 접속 실패 등 서버 오류

Error-Response on 400:

Keep In Touch With Us

Let’s Share Great Ideas