For Buyers
Introduction
ADPIE-Exchange is platform to simplify integration of Demand Side Platform(DSP) with Sell Side Platform(SSP). This document defines the protocol for interaction between DSP and ADPIE-exchange.
Integration Spec
Basically support OpenRTB 2.3 and OpenRTB Native-Ads-Specification 1.1, including scalability use extension field. Addition/deletion of field is available according to application.
• HTTP 1.1 based POST method
• Data Format: JSON
• Not support Multiple impression per one request
• Support some parts of OpenRTB 2.5 and OpenRTB Native-Ads-specification 1.2.
• Supported Ad Formats: Banner, Native, Rewarded video
• Supported Size: 320x50, 320x100, 320x480, 300x250, 1200x627, 1280x720, 720x1280
Bid Request
Bid Request Object
Field
Type
Required
Description
Example
id
string
O
unique ID of the bid request
“bb046a99 f84dad1fa 7ac3b0ce4 bc4dd3”
imp
array of objects
O
impression object
The current version supports only 1 Imp object.
app
object
O
app object(i.e., non-browser applications). Only applicable and recommended for apps.
Either site or app object should be present.
site
object
O
site object.
Only applicable and recommended for websites.
Either site or app object should be present.
device
object
O
Device Object which describes the device the impression will be delivered to.
user
object
O
User Object which describes the user.
tmax
integer
Maximum time in milliseconds to submit a bid to avoid timeout.(milliseconds)
400
cur
array of strings
Array of allowed currencies for bids on this bid request.
[“USD”]
bcat
array of strings
Blocked Advertiser Categories. (Refer to 5.4 Content Categories)
["IAB7","IAB26","IAB25-3","IAB7-17 "]
badv
array of strings
[“block1.com”,“block2.com”]
at
integer
Auction type, where 1=First Price, 2=Second Price Plus.
2
ext
object
Impression ext object for exchange-specific extensions to OpenRTB.
Impression Object
Field
Type
Required
Description
Example
id
string
O
impression ID within the bid request.
“1”
banner
object
Banner object. Required for banner impressions.
native
object
bidfloor
float
Bid floor as set by the SSP. The currency is the same as specified in cur field.
0.01080
bidfloorcur
string
Bid floor currency specified using ISO-4217 alpha codes.
“USD”
secure
integer
0 for non-secure pages (default); 1 for secure pages. Creatives for secure pages should be SSL-compliant.
0
instl
integer
1 if the ad is interstitial or full screen; else 0 (i.e., no).
1
pmp
object
Private Marketplace object
tagid
string
Identifier for specific ad placement or ad tag that was used to initiate the auction. This can be useful for debugging of any issues, or for optimization by the buyer.
displayman ager
string
Name of ad mediation partner, SDK technology, or player responsible for rendering ad (typically video or mobile).
“adpiessdk”
displayman agerver
string
Version of ad mediation partner, SDK technology, or player responsible for rendering ad (typically video or mobile).
"011402"
Banner Object
id
string
Unique identifier for this banner object. Used for tracking multiple banner objects.
"1"
Last updated