Skip to content

Display format

Image Display Ads (2.6)

Use banner.format to advertise every accepted size. The response must select one offered size and return matching w and h. Nexus accepts the image creative through its XML markup inside bid.adm.

  • mtype 1 · Banner
  • Exact w × h
  • Nexus image XML
  • HTTPS when secure = 1

Request · imp object

json
{
  "id": "1",
  "secure": 1,
  "bidfloor": 0.15,
  "bidfloorcur": "USD",
  "tagid": "display-320x50",
  "banner": {
    "format": [
      { "w": 320, "h": 50 },
      { "w": 300, "h": 250 }
    ],
    "mimes": ["image/jpeg", "image/png", "image/gif"],
    "pos": 1,
    "topframe": 1
  }
}

Response · bid object

json
{
  "id": "bid-banner-1",
  "impid": "1",
  "price": 0.175,
  "adomain": ["advertiser.example"],
  "cid": "campaign-41",
  "crid": "creative-31",
  "mtype": 1,
  "w": 320,
  "h": 50,
  "nurl": "https://bidder.example/win?price=${AUCTION_PRICE}",
  "burl": "https://bidder.example/bill?price=${AUCTION_PRICE}",
  "lurl": "https://bidder.example/loss?code=${AUCTION_LOSS}",
  "adm": "[NEXUS_IMAGE_XML]"
}

Nexus image markup

xml
<?xml version="1.0" encoding="UTF-8"?>
<ad>
  <imageAd>
    <clickUrl><![CDATA[https://advertiser.example/landing]]></clickUrl>
    <imgUrl><![CDATA[https://cdn.advertiser.example/creative-320x50.jpg]]></imgUrl>
    <width>320</width>
    <height>50</height>
  </imageAd>
</ad>

Size validation: Nexus rejects or ignores creatives whose XML dimensions, bid w/h, and selected request format do not agree.

White-label Nexus API documentation