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

데이블 뉴스 설치 가이드

일별 광고성과 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
serverErrorEDB 접속 실패 등 서버 오류

Error-Response on 400: