RTB integration

Overview

This document specifies SSP OpenRTB 2.5 implementation for Demand-Side Platforms (DSPs).

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:  “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
mceclip29.png    Interscroller
(feed UX)

Video
Display

320×480

Display: 320×480
Video: 360×640

mceclip33.png
Headline
Video
(feed UX)
Video 300×250 640×360
mceclip34.png    Interstitial Video 320×480
480×320

Display:
320×480 / 480×320
Video:
360×640 / 640×360

mceclip31.png    Infeed
   (feed UX)
Video
Display
300×250
320×250

Display: 300×250
Video: 640×360

mceclip32.png Medium
Rectangle
Display 300×250  300×250
mceclip30.png    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.

 

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":320,
        "h":480,
        "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"
}

Still have Questions?

Contact Us