Skip to content

Display format

Rich Media Ads (2.6)

Rich media uses the standard OpenRTB banner opportunity and a Nexus XML envelope in adm. The HTML or JavaScript creative belongs inside CDATA. API frameworks must be advertised in banner.api only when the placement actually supports them.

  • mtype 1 · Banner
  • HTML / JavaScript
  • CDATA required
  • No full HTML document

Request · imp object

json
{
  "id": "1",
  "secure": 1,
  "bidfloor": 0.2,
  "bidfloorcur": "USD",
  "tagid": "rich-300x250",
  "banner": {
    "format": [{ "w": 300, "h": 250 }],
    "mimes": ["text/html", "application/javascript"],
    "api": [3, 5, 6, 7],
    "pos": 1,
    "topframe": 1
  }
}

Response · bid object

json
{
  "id": "bid-rich-1",
  "impid": "1",
  "price": 0.24,
  "adomain": ["advertiser.example"],
  "cid": "campaign-42",
  "crid": "creative-32",
  "mtype": 1,
  "apis": [7],
  "w": 300,
  "h": 250,
  "nurl": "https://bidder.example/win?price=${AUCTION_PRICE}",
  "burl": "https://bidder.example/bill?price=${AUCTION_PRICE}",
  "adm": "[NEXUS_RICH_MEDIA_XML]"
}

Nexus rich-media markup

xml
<?xml version="1.0" encoding="UTF-8"?>
<ad>
  <richmediaAd>
    <content><![CDATA[<div id="creative">HTML/JS creative</div>]]></content>
    <width>300</width>
    <height>250</height>
  </richmediaAd>
</ad>

Markup boundary: Do not return DOCTYPE, html, head, or body document wrappers. Every asset and tracker must be HTTPS when imp.secure is 1.

White-label Nexus API documentation