Skip to content

Video format

Video: Rewarded (2.6)

Rewarded is signaled at the impression level with rwdd: 1. The plcmt value still describes the real player context; this full-screen example is an interstitial placement.

  • rwdd 1
  • plcmt 3 · Interstitial
  • instl 1
  • Reward after completion

Request · imp object

json
{
  "id": "1",
  "instl": 1,
  "rwdd": 1,
  "secure": 1,
  "bidfloor": 1.5,
  "bidfloorcur": "USD",
  "video": {
    "mimes": ["video/mp4"],
    "minduration": 15,
    "maxduration": 30,
    "protocols": [2, 3, 7],
    "w": 1080,
    "h": 1920,
    "plcmt": 3,
    "linearity": 1,
    "skip": 0,
    "delivery": [1, 2]
  }
}

Response · bid object

json
{
  "id": "bid-rewarded-1",
  "impid": "1",
  "price": 1.82,
  "adomain": ["advertiser.example"],
  "cid": "campaign-video-6",
  "crid": "creative-video-6",
  "mtype": 2,
  "protocol": 7,
  "dur": 30,
  "w": 1080,
  "h": 1920,
  "nurl": "https://bidder.example/win?price=${AUCTION_PRICE}",
  "burl": "https://bidder.example/bill?price=${AUCTION_PRICE}",
  "adm": "[VAST_XML]"
}

Reward policy: The publisher grants the reward after the configured completion event. A bid response must not grant, simulate, or self-report the reward.

White-label Nexus API documentation