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

데이블 뉴스 설치 가이드

일별 광고성과 API

/api/services/:service_name/channels/:channel/stats/ctr/daily

 

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

HTTP/1.1 200 OK
{
"result": {
"data": {
"20161108": {
"ctr": 1.274,
"impressions": 293432,
"exposes": 28441,
"clicks": 360,
"cost_spent": 54743,
"sharing_cost": 25293,
"void_cost_spent": 957
},
"20161109": {
"ctr": 1.233,
"impressions": 335380,
"exposes": 30320,
"clicks": 341,
"cost_spent": 37318,
"sharing_cost": 25100,
"void_cost_spent": 120
}
},
"sum": {
"ctr": 1.253,
"impressions": 328812,
"exposes": 58961,
"clicks": 731,
"cost_spent": 102061,
"sharing_cost": 51773,
"void_cost_spent": 1677
},
"last_updated": "2016-11-09T16:13:51.000Z",
"channels": [
"bottom",
"middle"
]
}
}

 


400


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


500

 
FieldDescription
serverErrorDB 접속 실패 등 서버 오류


Error-Response on 400:

HTTP/1.1 400 Bad Request
{
"errors": [
{
"message": "invalid service or public key"
}
]

 



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

/api/service_admins/:login_id/stats/ctr/daily

 

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

HTTP/1.1 200 OK
{
"result": [{
"service_id": 1,
"service_name": "dable.io",
"data": {
"20161108": {
"ctr": 1.274,
"impressions": 293432,
"exposes": 28441,
"clicks": 360,
"cost_spent": 54743,
"sharing_cost": 25293,
"void_cost_spent": 957
},
"20161109": {
"ctr": 1.233,
"impressions": 335380,
"exposes": 30320,
"clicks": 341,
"cost_spent": 37318,
"sharing_cost": 25100,
"void_cost_spent": 120
}
},
"sum": {
"ctr": 1.253,
"impressions": 328812,
"exposes": 58961,
"clicks": 731,
"cost_spent": 102061,
"sharing_cost": 51773,
"void_cost_spent": 1677
},
"last_updated": "2016-11-09T16:13:51.000Z",
"channels": [
"bottom",
"middle"
],
"channel_widget_map": {
"bottom": "je7EFa94",
"middle": "k29Iq4v7"
}
}, {
"data": {
// (중략)
},
}]
}

 

400


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

500


 
FieldDescription
serverErrorEDB 접속 실패 등 서버 오류

Error-Response on 400:

HTTP/1.1 400 Bad Request
{
"errors": [
{
"message": "invalid service admin or access key"
}
]
}