DSP Video AD. Report API (for SSP)

2 분 소요

InJun Kim

Basic info

SSP DSP

This is an API guide for providing reports to SSP (Supply Side Platform) partners in integration with TARGETPICK Demand Side Platform (DSP). To receive DSP reports through TARGETPICK, you must obtain Token from the manager. Please contact the manager to issue Token for API use.

Report data request

Basic info	Description
API name	report for SSP
response format	XML or JSON
authentication method	Token
call method	HTTPS
API description	Passes the report as a result of executing the ad to SSP

URL

Division	URL	Method
test	http://211.62.152.212:9000/api/report	Get
real	https://dsp-report.meba.kr:9000/api/report	Get

Parameters

Field	Type	Required	Example	Description
sDate	String	Y	20160101	report query start date
eDate	String	Y	20160131	report query end date
PartnerID	String	Y	userpartnerid	partner unique id issued by MezzoMedia
Token	String	Y	F379C8K9P0	unique token value for API use
ADType	Integer	Y	4	4 - video
ReportType	Integer	Y	1	1 - daily 2 - media (PubID) report 3 - ad type
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

Report data response

Basic info - When requested by the report API, the report data is returned in the form below.

Field	Type	Example	Description
ListCount	Integer	100	returned row count
ReportType	Integer	1	1 - daily report 2 - media (PubID) report 3 - ad type report
Date	String	20160101	report date
Imp	Integer	1000	impression count
Click	Integer	100	click count
CTR	Double	10.00	click through ratio
PubID	String	publisher123	AppID or SiteID as an ID to identify the media (possible encoded ID)
Revenue	Double	100000	inventory sales revenues

Sample

Daily Report (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>

Media report (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>video</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>

Ad type report (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>video</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	success
001	system error
002	unknown error
003	no permissions
004	non-exist API
005	incorrect parameter
006	Date must be entered and cannot exceed 3 months

Error Response Sample

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