Skip to content

Video format

Video: Instream Mid-roll (2.6)

Mid-roll interrupts publisher-requested video content. Use a positive number when the exact delay in seconds is known, or -1 for a generic mid-roll opportunity.

  • plcmt 1 · Instream
  • startdelay -1 or seconds
  • VAST inline
  • Content remains primary

Request · imp object

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

Response · bid object

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

When Nexus sends an exact positive startdelay, buyers may use it for pacing and creative selection. Do not reinterpret -1 as one second.

White-label Nexus API documentation