Overview
This document specifies SSP OpenRTB 2.5 implementation for Demand-Side Platforms (DSPs) interested in buying from our marketplaces
Data Center Location
Currently display.io has 1 data center located in US-EAST.
Ad Formats
Each bid request contains only 1 ad format object: or “Video”, or “Banner”.
Banner (Display) Ads
Display ad bids should contain HTML markup. display.io SDKs support MRAID 2.0 and 3.0 standards.
Video Ads
Video ad bids should contain VAST 2.0 or 3.0 InLine tag.
Also Video ad bids support Wrapper tag (up to 4 nesting levels) (https://www.iab.com/wp-content/uploads/2015/06/VASTv3_0.pdf 2.2.2.2, 2.2.3, 2.2.4).
The adm must include the “<?xml” header. VPAID is not supported.
Supported Ad Units/Formats/Sizes
| Ad unit | Ad Format | Ad unit size | Requested Ad Size |
|
|---|---|---|---|---|
 |
Interscroller (feed UX) |
Video |
320×480 |
Display: 320×480 |
 |
Headline Video (feed UX) |
Video | 300×250 | 640×360 |
 |
Interstitial | Video | 320×480 480×320 |
Display: |
 |
Infeed (feed UX) |
Video Display |
300×250 320×250 |
Display: 300×250 |
 |
Medium Rectangle |
Display | 300×250 | 300×250 |
 |
Banner | Display | 320×50 | 320×50 |
Custom parameters
Bid Request
- imp.video.ext.videotype – (string) rewarded, interstitial, infeed, interscroller, adhesion (=headline video)
- imp.banner.ext.bannertype – (string) interstitial, infeed, interscroller, banner, mrect
Bid Response
- bidresponse.seatbid.bid.ext.aname – (string) Advertiser name
- bidresponse.seatbid.bid.ext.clickurl – (string) Click URL (equals to ClickThrough url)
Viewability
For all ad units and formats, viewability measurement is supported through IAB OM SDK.
Verification for VAST ads is supported through the “AdVerifications” extension as described in the OMSDK onboarding documentation.
Verification for display ads is supported inline in the ad markup.
dispay.io SDKs are compliant with the IAB Open Measurement standards for viewability.
GDPR
In accordance with the IAB OpenRTB GDPR advisory our RTB API passes consent string and GDPR state in User.ext.consent and Regs.ext.GDPR.
CCPA
Display.io supports IAB CCPA Compliance Framework and has LSPA (Limited Service Provider Agreement) signed up. In accordance with the IAB CCPA Compliance Framework for Publishers & Technology Companies our RTB API passes US privacy consent string via Regs.ext.us_privacy.
Please, pay attention: if a user is opt-out of sale or a user is from California, but there is no data about his consent, and demand partner hasn’t LSPA signed up – bid request won’t be sent to a such demand partner.
Caching
Display ads are cached prior to being displayed to users, when cached they get loaded into a webview in the mobile SDK.
Once cached it may take a short or considerable time before the ad will be displayed to the user, or it may not be displayed to the user at all. Average time to live (TTL) for ad is 2 hours, but it may be limited according to advertiser’s requirements.
The display.io mobile SDKs support the MRAID 3.0 standard. We strongly recommend buyers who rely on beacons in ad markup to serve MRAID ads to support correct ad rendering and tracking of ad lifecycle events or use burl events for impression tracking.
The display.io ad platform will call the provided burl in the bid only on impression.
Ad Markup
The ad markup must be provided within adm property.
For billing we support nurl, burl, billing url inside VAST markup.
Notes
The display.io ad platform serves ads to mobile applications, therefore the ad serving flow and ad lifecycle differ from ones of ads served to websites.
Examples
Interscroller Display Bid Request Example
{
"id":"5f33f1069c436",
"at":1,
"imp":[
{
"id":"1",
"tagid":"placement7070",
"displaymanager":"display.io SDK",
"displaymanagerver":"4.4.4",
"instl":1,
"secure":1,
"banner":
{
"w":320,
"h":480,
"pos":7,
"btype":[3],
"battr":[8,17,10,9],
"ext":{"bannertype":"interscroller"},
"api":[5,6,7]
},
"bidfloor":6.42
}
],
"app":
{
"id":"8347",
"name":"Tumblr_Android",
"storeurl":"https://play.google.com/store/apps/details?id=com.tumblr",
"bundle":"com.tumblr",
"publisher":{"id":"2101","name":"Tumblr, Inc."}
},
"device":
{
"js":1,
"geo":
{
"country":"USA",
"region":"New Mexico",
"type":2,"ipservice":3,
"lat":35.0845,"lon":-106.6511
},
"ip":"174.237.5.16",
"devicetype":4,
"ifa":"00e16d14-01c3-4400-9151-a3e5ca671af1",
"carrier":"Verizon ",
"model":"moto z4",
"make":"motorola",
"h":2168,
"w":1080,
"ua":"Mozilla/5.0 (Linux; Android 10; moto z4 Build/QDFS30.130-42-5-2; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/84.0.4147.111 Mobile Safari/537.36",
"os":"android",
"osv":"10.0.0",
"lmt":0
},
"source":
{
"fd":0,
"tid":"5f33f10695ec3",
"pchain":"display.io:2101",
"ext":
{
"schain":{"ver":"1.0","complete":1,"nodes":[{"asi":"display.io","sid":"2101","rid":"5f33f1069c436","hp":1}]},
"omidpn":"Displayio",
"omidpv":"4.4.4"
}
},
"bcat":["IAB25","IAB26","IAB7-39"],
"regs":
{
"coppa":0,"ext":{"us_privacy":"1---"}
}
}
Interscroller Display Bid Response Example
{
"id":"5f33f1069c436",
"cur":"USD"
"seatbid":[
{
"seat":"1323-1",
"bid":[
{
"id":"1323-1-1",
"impid":"1",
"price":6.42,
"crid":"cr-liv6ymcwulrgv2",
"cid":"c-9ax04m0sv9",
"adm":"<script src='https://test/example/js?excid=test&pickup=523b1bc4a13de843c30dfb308d00dcc5&zrk=8296388b401038f3939fd40ec52ae01b&zds=b6e344396c72343a27ab740162b3fa01&imp=1b82f272620d003e680a52fa5dc3584b&rtbserve=1&pv=1&prc=ZX0.000751074579120603&extra=1'></script>",
"w":320,
"h":480,
"adid":"46_10011483",
"adomain":["shop.mashable.com"]
}
]
}
]
}
Infeed Video Bid Request Example
{
"id":"5f3407dd5cfaa",
"at":1,
"imp":[
{
"id":"1",
"tagid":"placement5732",
"displaymanager":"display.io",
"displaymanagerver":"1.0.0",
"instl":0,
"video":
{
"w":640,
"h":360,
"pos":3,
"protocols":[2,3,5,6],
"mimes":["video/mp4"],
"minduration":4,
"maxduration":60,
"battr":[8,17,10,9],
"linearity":1,
"ext":{"videotype":"infeed"},
"minbitrate":250,
"maxbitrate":10000
},
"bidfloor":1.55
}],
"app":
{
"id":"8109",
"name":"com.naver.linewebtoon",
"storeurl":"https://play.google.com/store/apps/details?id=com.naver.linewebtoon",
"bundle":"com.naver.linewebtoon",
"publisher":{"id":"2059","name":"NAVER WEBTOON CORP"}},
"device":
{
"js":1,
"geo":
{
"country":"USA",
"region":"Utah",
"type":2,
"city":"Ogden",
"zip":"84401",
"ipservice":3,
"lat":41.2215,
"lon":-111.9621
},
"ip":"24.2.103.230",
"ifa":"7f872bfe-c155-47a8-b5ed-b8e42edb0cd0",
"model":"Samsung SM-G935T",
"carrier":"Comcast Cable",
"connectiontype":2,
"ua":"Mozilla/5.0 (Linux; Android 8.0.0; SM-G935T Build/R16NW; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/84.0.4147.111 Mobile Safari/537.36",
"os":"Android",
"osv":"8.0.0",
"lmt":0
},
"source":
{
"fd":0,
"tid":"5f3407dd58c49",
"pchain":"display.io:2059",
"ext":{"schain":{"ver":"1.0","complete":1,"nodes":[{"asi":"display.io","sid":"2059","rid":"5f3407dd5cfaa","hp":1}]}}},
"user":{"keywords":"gmext"},
"bcat":["IAB25","IAB26","IAB7-39"],
"regs":
{
"coppa":0,"ext":{"us_privacy":"1---"}
}
}
Infeed Video Bid Response Example
{
"id":"5f341cc57b5cb",
"seatbid":[
{
"bid":[
{
"id":"1",
"impid":"1",
"price":1.78,
"adm":"<VAST version=\"3.0\"><Ad><Wrapper><AdSystem><![CDATA[EXAMPLE Go Ad Server]]></AdSystem><VASTAdTagURI><![CDATA[http://example.com/vastd.xml?vid=1597250756_9ea55362d07f3e969dfca26ae61d06d0&aic=${AUCTION_PRICE}&pid=4980f2fde3]]></VASTAdTagURI><Impression><![CDATA[http://example.com/xcp.gif?iid=1597250756_9ea55362d07f3e969dfca26ae61d06d0&v=true&vp=1&aid=1597250756_9ea55362d07f3e969dfca26ae61d06d0]]></Impression><Error></Error><Creatives></Creatives><Extensions></Extensions></Wrapper></Ad></VAST>",
"adomain":["musely.com"],
"iurl":"https://cdn.w55c.net/v/s_XRXELsR2Ld_749145084.xml",
"cid":"Xm24rhHMiP",
"crid":"79_XRXELsR2Ld"
}],
"seat":"7fb78c4d5e"
}],
"bidid":"1597250756_9ea55362d07f3e969dfca26ae61d06d0",
"cur":"USD"
}
