RTB integration

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 Display	320x480	Display: 320x480 Video: 360x640
	Headline Video (feed UX)	Video	300x250	640x360
	Interstitial	Video	320x480 480x320	Display: 320x480 / 480x320 Video: 360x640 / 640x360
	Infeed       (feed UX)	Video Display	300x250 320x250	Display: 300x250 Video: 640x360
	Medium Rectangle	Display	300x250	300x250
	Banner	Display	320x50	320x50

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"
}