DSP Video AD. Report API (for SSP)

2 분 소요

InJun Kim

기본정보

SSP DSP

본 문서는 TARGETPICK DSP(Demand Side Platform)와 연동한 SSP(Supply Side Platform) 파트너에게 리포트를 제공하기 위한 API 가이드 입니다. TARGETPICK 으로 DSP 리포트를 제공받기 위해서는 메조미디어 담당자에게 Token을 발급 받아야 사용이 가능합니다. API 사용을 위한 Token 발행은 지정 담당자에게 문의해주시기 바랍니다.

리포트 데이터 요청

기본 정보 설명
서비스 API명 SSP 제공 리포트 데이터
API 호출 결과 타입 XML or JSON
인증 방법 Token
호출 방법 HTTPS
API 설명 SSP에 광고를 집행한 결과 리포트를 전달합니다.
URL
구분 URL Method
테스트 http://211.62.152.212:9000/api/report Get
상용 https://dsp-report.meba.kr:9000/api/report Get
Parameters
Field 타입 필수 코드 예시 설명
sDate String Y 20160101 리포트 조회 시작일
eDate String Y 20160131 리포트 조회 종료일
PartnerID String Y userpartnerid 메조미디어에서 발급한 파트너 고유 ID
Token String Y F379C8K9P0 API 사용을 위한 파트너 고유 Token 값
ADType Integer Y 4 0 - ALL : 전체
4 - video : 동영상
ReportType Integer Y 1 1 - 일자별 리포트
2 - 미디어별(PubID) 리포트
3 - 광고 타입별 리포트
format String Y json json , xml
Sample
Sample URL
http://211.62.152.212:9000/api/report?PartnerID=abcde12345&token=C150KPTR39F0277A743B6&format=xml&ReportType=1&ADType=0&sDate=20190101&eDate=20190131

리포트 데이터 응답

기본 정보 - 리포트 API로 Request 시 아래의 양식으로 리포트 데이터가 반환됩니다.

이름 타입 전달 값 예시 설명
ListCount Integer 100 반환되는 리스트 행 수
ReportType Integer 1 1 - 일자별 리포트
2 - 미디어별(PubID) 리포트
3 - 광고 타입별 리포트
Date String 20160101 리포팅 일자
Imp Integer 1000 노출 횟수
Click Integer 100 클릭 횟수
CTR Double 10.00 노출 대비 클릭율
PubID String publisher123 미디어를 식별할 수 있는 ID로 AppID 또는 SiteID
(난수 또는 암호화된 ID 가능)
Revenue Double 100000 메조미디어에서 지급해야 할 인벤토리 구매 비용
Sample
일자별 리포트 (ReportType=1)
<?xml version="1.0" encoding="utf-8" ?>
<data>
	<error>
		<code>000</error>
		<message>SUCCESS</message>
	</error>
	<result>
		<ListCount>10</ListCount> 
		<ReportType>1</ReportType> 
		<sDate>20190101</sDate> 
		<eDate>20190131</eDate> 
		<ADType>ALL</ADType> 
		<Reports>
			<Report>
				<Date>20190101</Date>
				<Imp>1000</Imp>
				<Click>100</Click>
				<CTR>10.00</CTR>
				<Revenue>5000</Revenue>
			</Report>
			<Report>
				……
			</Report>
		</Reports>
	</result>
</data>
미디어별 리포트 (ReportType=2)
<?xml version="1.0" encoding="utf-8" ?>
<data>
	<error>
		<code>000</error>
		<message>SUCCESS</message>
	</error>
	<result>
		<ListCount>10</ListCount> 
		<ReportType>2</ReportType> 
		<sDate>20160101</sDate> 
		<eDate>20160131</eDate> 
		<ADType>banner</ADType> 
		<Reports>
			<Report>
				<Date>20160101</Date>
				<PubID>publisher123</PubID>
				<Imp>1000</Imp>
				<Click>100</Click>
				<CTR>10.00</CTR>
				<Revenue>5000</Revenue>
			</Report>
			<Report>
				<Date>20160101</Date>
				<PubID>publisher456</PubID>
				<Imp>1000</Imp>
				<Click>100</Click>
				<CTR>10.00</CTR>
				<Revenue>3000</Revenue>
			</Report>
			<Report>
				……
			</Report>
		</Reports>
	</result>
</data> xml version="1.0" encoding="utf-8" ?>
<data>
	<error>
		<code>000</error>
		<message>SUCCESS</message>
	</error>
	<result>
		<ListCount>10</ListCount> 
		<ReportType>1</ReportType> 
		<sDate>20160101</sDate> 
		<eDate>20160131</eDate> 
		<ADType>ALL</ADType> 
		<Reports>
			<Report>
				<Date>20160101</Date>
				<Imp>1000</Imp>
				<Click>100</Click>
				<CTR>10.00</CTR>
				<Revenue>5000</Revenue>
			</Report>
			<Report>
				……
			</Report>
		</Reports>
	</result>
</data>
광고 타입별 리포트 (ReportType=3)
<?xml version="1.0" encoding="utf-8" ?>
<data>
	<error>
		<code>000</error>
		<message>SUCCESS</message>
	</error>
	<result>
		<ListCount>10</ListCount> 
		<ReportType>3</ReportType> 
		<sDate>20160101</sDate> 
		<eDate>20160131</eDate> 
		<ADType>ALL</ADType> 
		<Reports>
			<Report>
				<Date>20160101</Date>
				<ADType>banner</ADType>
				<Imp>1000</Imp>
				<Click>100</Click>
				<CTR> 10.00</CTR>
				<Revenue>5000</Revenue>
			</Report>
			<Report>
				<Date>20160101</Date>
				<ADType>interstitial</ADType> 
				<Imp>1000</Imp>
				<Click>100</Click>
				<CTR> 10.00</CTR>
				<Revenue>3000</Revenue>
			</Report>
			<Report>
				……
			</Report>
		</Reports>
	</result>
</data>

Error Code

Code Descirption
000 성공
001 시스템에 에러가 발생했습니다.
002 알 수 없는 오류가 발생했습니다.
003 조회 권한이 없습니다.
004 존재하지 않는 API 입니다.
005 Parameter 정보가 잘못되었습니다.
006 날짜는 반드시 입력해야 하며, 세 달을 초과 할 수 없습니다.

Error Response Sample

<?xml version="1.0" encoding="utf-8" ?>
<data>
	<error>
		<code>000</code> 
		<message>SUCCESS</message> 
	</error>
</data>

업데이트: