Skip to content

Video format

Video: Instream Pre-roll (2.6)

Pre-roll plays before publisher-requested video content. Use plcmt: 1 only when the player satisfies the current IAB Instream definition, and startdelay: 0 for pre-roll.

  • plcmt 1 · Instream
  • startdelay 0
  • VAST 2/3/4
  • mtype 2 · Video

Request · imp object

json
{
  "id": "1",
  "secure": 1,
  "bidfloor": 1.2,
  "bidfloorcur": "USD",
  "video": {
    "mimes": ["video/mp4", "application/javascript"],
    "minduration": 5,
    "maxduration": 30,
    "protocols": [2, 3, 7],
    "w": 1280,
    "h": 720,
    "startdelay": 0,
    "plcmt": 1,
    "linearity": 1,
    "delivery": [1, 2],
    "api": [2]
  }
}

Response · bid object

json
{
  "id": "bid-preroll-1",
  "impid": "1",
  "price": 1.45,
  "adomain": ["advertiser.example"],
  "cid": "campaign-video-1",
  "crid": "creative-video-1",
  "mtype": 2,
  "protocol": 7,
  "apis": [2],
  "dur": 15,
  "w": 1280,
  "h": 720,
  "nurl": "https://bidder.example/win?price=${AUCTION_PRICE}",
  "burl": "https://bidder.example/bill?price=${AUCTION_PRICE}",
  "adm": "[VAST_XML]"
}

Inline VAST response

xml
<VAST version="4.0">
  <Ad id="creative-video-1">
    <InLine>
      <AdSystem>Nexus Buyer</AdSystem>
      <AdTitle>Example pre-roll</AdTitle>
      <Impression><![CDATA[https://bidder.example/impression]]></Impression>
      <Creatives>
        <Creative>
          <Linear>
            <Duration>00:00:15</Duration>
            <MediaFiles>
              <MediaFile type="video/mp4" width="1280" height="720"><![CDATA[https://cdn.advertiser.example/video.mp4]]></MediaFile>
            </MediaFiles>
          </Linear>
        </Creative>
      </Creatives>
    </InLine>
  </Ad>
</VAST>

Instream qualification: A floating or article player is not automatically Instream. Use plcmt: 2 or 4 when the updated AdCOM definitions fit better.

White-label Nexus API documentation