Video Ads (2.2)
This guide for the Smaato Demand Platform (SDX) includes example bid requests and responses for video ads with OpenRTB 2.2.
Example requests and responses include:
- Instream pre-roll
- Instream mid-roll
- Instream post-roll
- Instream Interstitial
- Outstream
- Rewarded
Video Object Descriptions
| Video Object | Description |
|---|---|
instl |
Denotes that the video ad will be shown as an interstitial. |
video |
The video object containing the following request details: |
linearity |
Indicates whether the ad will be shown in a linear (i.e. pre- or midroll) or non-linear (i.e. overlay) fashion. (1 = Linear, 2 = Non-linear) |
maxduration |
Indicates the maximum allowed video duration for this request. |
mimes |
Indicates which video formats a publisher supports |
minduration |
Indicates the minimum allowed video duration for this request. |
protocol |
Indicates the supported VAST video version. |
Example requests and responses include:
- Instream pre-roll
- Instream mid-roll
- Instream post-roll
- Instream interstitial
- Outstream
- Rewarded
Instream Pre-Roll (Request)
{
"app":{
"bundle":"defaultBundleId",
"cat":[
"IAB7-42"
],
"id":"5020536",
"name":"appName",
"publisher":{
"id":"5020393",
"name":"PublisherName"
}
},
"at":2,
"bcat":[
"IAB17-18",
"IAB7-42",
"IAB23",
"IAB7-28",
"IAB26",
"IAB25",
"IAB9-9",
"IAB24"
],
"device":{
"connectiontype":0,
"devicetype":4,
"didmd5":"d1c553888076489a45af4b6dfb9392eb",
"didsha1":"81407cd1808b59681f2da1341d8ac62dfa9293fa",
"geo":{
"city":"Boston",
"country":"USA",
"lat":42.360504,
"lon":-71.0548,
"metro":"506",
"region":"MA",
"type":2,
"zip":"02109"
},
"ip":"50.255.150.200",
"js":0,
"language":"en",
"make":"Apple",
"model":"iPhone",
"os":"iOS",
"osv":"4.3.2",
"ua":"Mozilla/5.0 (iPhone; U; CPU iPhone OS 4_3_2 like Mac OS X; en-us) AppleWebKit/533.17.9 (KHTML, like Gecko) Version/5.0.2 Mobile/8H7 Safari/6533.18.5"
},
"ext":{
"pchain":"07bcf65f187117b4:5020393"
},
"id":"60735435-df51-4d03-830d-36d009e27d70",
"imp":[
{
"displaymanager":"SOMA",
"ext":{
},
"id":"1",
"instl":0,
"secure":0,
"tagid":"5020536",
"video":{
"battr":[
1,
3,
5,
8,
9
],
"h":50,
"linearity":1,
"maxbitrate":4000,
"maxduration":60,
"mimes":[
"video/3gpp",
"video/mov",
"video/mp4",
"video/mpv"
],
"minbitrate":250,
"minduration":5,
"pos":0,
"protocols":[
2,
5
],
"startdelay":0,
"w":320
}
}
],
"regs":{
"coppa":0,
"ext":{
}
},
"tmax":1499,
"user":{
"ext":{
}
}
}Instream Pre-Roll (Response)
{
"id":"vast-response-from-msan",
"seatbid":[
{
"seat":"vast_seat1",
"bid":[
{
"impid":"1",
"price":9.051027,
"id":"vast_seat1-bid1-from-msan",
"adm":"<VAST version=\"2.0\"><Ad id=\"preroll-1\"><InLine><AdSystem>2.0</AdSystem><AdTitle>5773100</AdTitle><Creatives><Creative><Linear><Duration>00:00:15</Duration><MediaFiles><MediaFile height=\"360\" width=\"640\" type=\"video/mp4\" delivery=\"streaming\">http://ndtrs.net/videos/video.mp4</MediaFile></MediaFiles></Linear></Creative><Creative><CompanionAds><Companion height=\"250\" width=\"300\" id=\"573242\"><HTMLResource><![CDATA[<A href=\"http://ndtrs.net/beacon\" target=\"_blank\"><IMG SRC=\"http://ndtrs.net/images/image.png\" ALT=\"Click Here\" /></A><img src=\"http://ndtrs.net/images/image.png\" height=\"1\" width=\"1\" />]]></HTMLResource></Companion></CompanionAds></Creative></Creatives></InLine></Ad></VAST>",
"adomain":[
"example.com"
],
"crid":"16969426",
"cid":"2445",
"iurl":"http://ndtrs.net/images/image.png",
"nurl":"http://ndtrs.net/winnotice/win?case=rtbVastResponse"
}
]
}
]
}Instream Mid-Roll (Request)
{
"app":{
"bundle":"defaultBundleId",
"cat":[
"IAB7-42"
],
"id":"5020536",
"name":"appName",
"publisher":{
"id":"5020393",
"name":"PublisherName"
}
},
"at":2,
"bcat":[
"IAB17-18",
"IAB7-42",
"IAB23",
"IAB7-28",
"IAB26",
"IAB25",
"IAB9-9",
"IAB24"
],
"device":{
"connectiontype":0,
"devicetype":4,
"didmd5":"d1c553888076489a45af4b6dfb9392eb",
"didsha1":"81407cd1808b59681f2da1341d8ac62dfa9293fa",
"geo":{
"city":"Boston",
"country":"USA",
"lat":42.360504,
"lon":-71.0548,
"metro":"506",
"region":"MA",
"type":2,
"zip":"02109"
},
"ip":"50.255.150.200",
"js":0,
"language":"en",
"make":"Apple",
"model":"iPhone",
"os":"iOS",
"osv":"4.3.2",
"ua":"Mozilla/5.0 (iPhone; U; CPU iPhone OS 4_3_2 like Mac OS X; en-us) AppleWebKit/533.17.9 (KHTML, like Gecko) Version/5.0.2 Mobile/8H7 Safari/6533.18.5"
},
"ext":{
"pchain":"07bcf65f187117b4:5020393"
},
"id":"988010a2-891d-4725-9d58-8cded9df01af",
"imp":[
{
"displaymanager":"SOMA",
"ext":{
},
"id":"1",
"instl":0,
"secure":0,
"tagid":"5020536",
"video":{
"battr":[
1,
3,
5,
8,
9
],
"h":50,
"linearity":1,
"maxbitrate":4000,
"maxduration":60,
"mimes":[
"video/3gpp",
"video/mov",
"video/mp4",
"video/mpv"
],
"minbitrate":250,
"minduration":5,
"pos":0,
"protocols":[
2,
5
],
"startdelay":-1,
"w":320
}
}
],
"regs":{
"coppa":0,
"ext":{
}
},
"tmax":1499,
"user":{
"ext":{
}
}
}Instream Mid-Roll (Response)
{
"id":"vast-response-from-msan",
"seatbid":[
{
"seat":"vast_seat1",
"bid":[
{
"impid":"1",
"price":9.051027,
"id":"vast_seat1-bid1-from-msan",
"adm":"<VAST version=\"2.0\"><Ad id=\"preroll-1\"><InLine><AdSystem>2.0</AdSystem><AdTitle>5773100</AdTitle><Creatives><Creative><Linear><Duration>00:00:15</Duration><MediaFiles><MediaFile height=\"360\" width=\"640\" type=\"video/mp4\" delivery=\"streaming\">http://ndtrs.net/videos/video.mp4</MediaFile></MediaFiles></Linear></Creative><Creative><CompanionAds><Companion height=\"250\" width=\"300\" id=\"573242\"><HTMLResource><![CDATA[<A href=\"http://ndtrs.net/beacon\" target=\"_blank\"><IMG SRC=\"http://ndtrs.net/images/image.png\" ALT=\"Click Here\" /></A><img src=\"http://ndtrs.net/images/image.png\" height=\"1\" width=\"1\" />]]></HTMLResource></Companion></CompanionAds></Creative></Creatives></InLine></Ad></VAST>",
"adomain":[
"example.com"
],
"crid":"16969426",
"cid":"2445",
"iurl":"http://ndtrs.net/images/image.png",
"nurl":"http://ndtrs.net/winnotice/win?case=rtbVastResponse"
}
]
}
]
}Instream Post-Roll (Request)
{
"app":{
"bundle":"defaultBundleId",
"cat":[
"IAB7-42"
],
"id":"5020536",
"name":"appName",
"publisher":{
"id":"5020393",
"name":"PublisherName"
}
},
"at":2,
"bcat":[
"IAB17-18",
"IAB7-42",
"IAB23",
"IAB7-28",
"IAB26",
"IAB25",
"IAB9-9",
"IAB24"
],
"device":{
"connectiontype":0,
"devicetype":4,
"didmd5":"d1c553888076489a45af4b6dfb9392eb",
"didsha1":"81407cd1808b59681f2da1341d8ac62dfa9293fa",
"geo":{
"city":"Boston",
"country":"USA",
"lat":42.360504,
"lon":-71.0548,
"metro":"506",
"region":"MA",
"type":2,
"zip":"02109"
},
"ip":"50.255.150.200",
"js":0,
"language":"en",
"make":"Apple",
"model":"iPhone",
"os":"iOS",
"osv":"4.3.2",
"ua":"Mozilla/5.0 (iPhone; U; CPU iPhone OS 4_3_2 like Mac OS X; en-us) AppleWebKit/533.17.9 (KHTML, like Gecko) Version/5.0.2 Mobile/8H7 Safari/6533.18.5"
},
"ext":{
"pchain":"07bcf65f187117b4:5020393"
},
"id":"ddd571c8-aa0c-43f6-8602-05f46968c33e",
"imp":[
{
"displaymanager":"SOMA",
"ext":{
},
"id":"1",
"instl":0,
"secure":0,
"tagid":"5020536",
"video":{
"battr":[
1,
3,
5,
8,
9
],
"h":50,
"linearity":1,
"maxbitrate":4000,
"maxduration":60,
"mimes":[
"video/3gpp",
"video/mov",
"video/mp4",
"video/mpv"
],
"minbitrate":250,
"minduration":5,
"pos":0,
"protocols":[
2,
5
],
"startdelay":-2,
"w":320
}
}
],
"regs":{
"coppa":0,
"ext":{
}
},
"tmax":1499,
"user":{
"ext":{
}
}
}Instream Post-Roll (Response)
{
"id":"vast-response-from-msan",
"seatbid":[
{
"seat":"vast_seat1",
"bid":[
{
"impid":"1",
"price":9.051027,
"id":"vast_seat1-bid1-from-msan",
"adm":"<VAST version=\"2.0\"><Ad id=\"preroll-1\"><InLine><AdSystem>2.0</AdSystem><AdTitle>5773100</AdTitle><Creatives><Creative><Linear><Duration>00:00:15</Duration><MediaFiles><MediaFile height=\"360\" width=\"640\" type=\"video/mp4\" delivery=\"streaming\">http://ndtrs.net/videos/video.mp4</MediaFile></MediaFiles></Linear></Creative><Creative><CompanionAds><Companion height=\"250\" width=\"300\" id=\"573242\"><HTMLResource><![CDATA[<A href=\"http://ndtrs.net/beacon\" target=\"_blank\"><IMG SRC=\"http://ndtrs.net/images/image.png\" ALT=\"Click Here\" /></A><img src=\"http://ndtrs.net/images/image.png\" height=\"1\" width=\"1\" />]]></HTMLResource></Companion></CompanionAds></Creative></Creatives></InLine></Ad></VAST>",
"adomain":[
"example.com"
],
"crid":"16969426",
"cid":"2445",
"iurl":"http://ndtrs.net/images/image.png",
"nurl":"http://ndtrs.net/winnotice/win?case=rtbVastResponse"
}
]
}
]
}Instream Interstitial (Request)
{
"app":{
"bundle":"defaultBundleId",
"cat":[
"IAB7-42"
],
"id":"5020539",
"name":"appName",
"publisher":{
"id":"5020393",
"name":"PublisherName"
}
},
"at":2,
"bcat":[
"IAB17-18",
"IAB7-42",
"IAB23",
"IAB7-28",
"IAB26",
"IAB25",
"IAB9-9",
"IAB24"
],
"device":{
"connectiontype":0,
"devicetype":4,
"didmd5":"d1c553888076489a45af4b6dfb9392eb",
"didsha1":"81407cd1808b59681f2da1341d8ac62dfa9293fa",
"geo":{
"city":"Boston",
"country":"USA",
"lat":42.360504,
"lon":-71.0548,
"metro":"506",
"region":"MA",
"type":2,
"zip":"02109"
},
"ip":"50.255.150.200",
"js":0,
"language":"en",
"make":"Apple",
"model":"iPhone",
"os":"iOS",
"osv":"4.3.2",
"ua":"Mozilla/5.0 (iPhone; U; CPU iPhone OS 4_3_2 like Mac OS X; en-us) AppleWebKit/533.17.9 (KHTML, like Gecko) Version/5.0.2 Mobile/8H7 Safari/6533.18.5"
},
"ext":{
"pchain":"07bcf65f187117b4:5020393"
},
"id":"a7ec5797-ae77-4f6c-b9b3-05105095f026",
"imp":[
{
"displaymanager":"SOMA",
"ext":{
},
"id":"1",
"instl":1,
"secure":0,
"tagid":"5020539",
"video":{
"battr":[
1,
3,
5,
8,
9
],
"h":50,
"linearity":1,
"maxbitrate":4000,
"maxduration":60,
"mimes":[
"video/3gpp",
"video/mov",
"video/mp4",
"video/mpv"
],
"minbitrate":250,
"minduration":5,
"pos":0,
"protocols":[
2,
5
],
"w":320
}
}
],
"regs":{
"coppa":0,
"ext":{
}
},
"tmax":1498,
"user":{
"ext":{
}
}
}Instream Interstitial (Response)
{
"id":"vast-response-from-msan",
"seatbid":[
{
"seat":"vast_seat1",
"bid":[
{
"impid":"1",
"price":9.051027,
"id":"vast_seat1-bid1-from-msan",
"adm":"<VAST version=\"2.0\"><Ad id=\"preroll-1\"><InLine><AdSystem>2.0</AdSystem><AdTitle>5773100</AdTitle><Creatives><Creative><Linear><Duration>00:00:15</Duration><MediaFiles><MediaFile height=\"360\" width=\"640\" type=\"video/mp4\" delivery=\"streaming\">http://ndtrs.net/videos/video.mp4</MediaFile></MediaFiles></Linear></Creative><Creative><CompanionAds><Companion height=\"250\" width=\"300\" id=\"573242\"><HTMLResource><![CDATA[<A href=\"http://ndtrs.net/beacon\" target=\"_blank\"><IMG SRC=\"http://ndtrs.net/images/image.png\" ALT=\"Click Here\" /></A><img src=\"http://ndtrs.net/images/image.png\" height=\"1\" width=\"1\" />]]></HTMLResource></Companion></CompanionAds></Creative></Creatives></InLine></Ad></VAST>",
"adomain":[
"example.com"
],
"crid":"16969426",
"cid":"2445",
"iurl":"http://ndtrs.net/images/image.png",
"nurl":"http://ndtrs.net/winnotice/win?case=rtbVastResponse"
}
]
}
]
}Outstream (Request)
{
"app":{
"bundle":"defaultBundleId",
"cat":[
"IAB7-42"
],
"id":"5020537",
"name":"appName",
"publisher":{
"id":"5020393",
"name":"PublisherName"
}
},
"at":2,
"bcat":[
"IAB17-18",
"IAB7-42",
"IAB23",
"IAB7-28",
"IAB26",
"IAB25",
"IAB9-9",
"IAB24"
],
"device":{
"connectiontype":0,
"devicetype":4,
"didmd5":"d1c553888076489a45af4b6dfb9392eb",
"didsha1":"81407cd1808b59681f2da1341d8ac62dfa9293fa",
"geo":{
"city":"Boston",
"country":"USA",
"lat":42.360504,
"lon":-71.0548,
"metro":"506",
"region":"MA",
"type":2,
"zip":"02109"
},
"ip":"50.255.150.200",
"js":0,
"language":"en",
"make":"Apple",
"model":"iPhone",
"os":"iOS",
"osv":"4.3.2",
"ua":"Mozilla/5.0 (iPhone; U; CPU iPhone OS 4_3_2 like Mac OS X; en-us) AppleWebKit/533.17.9 (KHTML, like Gecko) Version/5.0.2 Mobile/8H7 Safari/6533.18.5"
},
"ext":{
"pchain":"07bcf65f187117b4:5020393"
},
"id":"a458a2c5-dfec-463f-bca2-2ebdbddaa17a",
"imp":[
{
"displaymanager":"SOMA",
"ext":{
},
"id":"1",
"instl":0,
"secure":0,
"tagid":"5020537",
"video":{
"battr":[
1,
3,
5,
8,
9
],
"ext":{
"outstream":1
},
"h":50,
"linearity":1,
"maxbitrate":4000,
"maxduration":60,
"mimes":[
"video/3gpp",
"video/mov",
"video/mp4",
"video/mpv"
],
"minbitrate":250,
"minduration":5,
"pos":0,
"protocols":[
2,
5
],
"w":320
}
}
],
"regs":{
"coppa":0,
"ext":{
}
},
"tmax":1498,
"user":{
"ext":{
}
}
}Outstream (Response)
{
"id":"vast-response-from-msan",
"seatbid":[
{
"seat":"vast_seat1",
"bid":[
{
"impid":"1",
"price":9.051027,
"id":"vast_seat1-bid1-from-msan",
"adm":"<VAST version=\"2.0\"><Ad id=\"preroll-1\"><InLine><AdSystem>2.0</AdSystem><AdTitle>5773100</AdTitle><Creatives><Creative><Linear><Duration>00:00:15</Duration><MediaFiles><MediaFile height=\"360\" width=\"640\" type=\"video/mp4\" delivery=\"streaming\">http://ndtrs.net/videos/video.mp4</MediaFile></MediaFiles></Linear></Creative><Creative><CompanionAds><Companion height=\"250\" width=\"300\" id=\"573242\"><HTMLResource><![CDATA[<A href=\"http://ndtrs.net/beacon\" target=\"_blank\"><IMG SRC=\"http://ndtrs.net/images/image.png\" ALT=\"Click Here\" /></A><img src=\"http://ndtrs.net/images/image.png\" height=\"1\" width=\"1\" />]]></HTMLResource></Companion></CompanionAds></Creative></Creatives></InLine></Ad></VAST>",
"adomain":[
"example.com"
],
"crid":"16969426",
"cid":"2445",
"iurl":"http://ndtrs.net/images/image.png",
"nurl":"http://ndtrs.net/winnotice/win?case=rtbVastResponse"
}
]
}
]
}Rewarded (Request)
{
"app":{
"bundle":"defaultBundleId",
"cat":[
"IAB7-42"
],
"id":"5020538",
"name":"appName",
"publisher":{
"id":"5020393",
"name":"PublisherName"
}
},
"at":2,
"bcat":[
"IAB17-18",
"IAB7-42",
"IAB23",
"IAB7-28",
"IAB26",
"IAB25",
"IAB9-9",
"IAB24"
],
"device":{
"connectiontype":0,
"devicetype":4,
"didmd5":"d1c553888076489a45af4b6dfb9392eb",
"didsha1":"81407cd1808b59681f2da1341d8ac62dfa9293fa",
"geo":{
"city":"Boston",
"country":"USA",
"lat":42.360504,
"lon":-71.0548,
"metro":"506",
"region":"MA",
"type":2,
"zip":"02109"
},
"ip":"50.255.150.200",
"js":0,
"language":"en",
"make":"Apple",
"model":"iPhone",
"os":"iOS",
"osv":"4.3.2",
"ua":"Mozilla/5.0 (iPhone; U; CPU iPhone OS 4_3_2 like Mac OS X; en-us) AppleWebKit/533.17.9 (KHTML, like Gecko) Version/5.0.2 Mobile/8H7 Safari/6533.18.5"
},
"ext":{
"pchain":"07bcf65f187117b4:5020393"
},
"id":"8dc30a76-5c16-44bb-816c-de7a18aff7b8",
"imp":[
{
"displaymanager":"SOMA",
"ext":{
},
"id":"1",
"instl":1,
"secure":0,
"tagid":"5020538",
"video":{
"battr":[
1,
3,
5,
8,
9
],
"ext":{
"rewarded":1
},
"h":50,
"linearity":1,
"maxbitrate":4000,
"maxduration":60,
"mimes":[
"video/3gpp",
"video/mov",
"video/mp4",
"video/mpv"
],
"minbitrate":250,
"minduration":5,
"pos":0,
"protocols":[
2,
5
],
"w":320
}
}
],
"regs":{
"coppa":0,
"ext":{
}
},
"tmax":1499,
"user":{
"ext":{
}
}
}Rewarded (Response)
{
"id":"vast-response-from-msan",
"seatbid":[
{
"seat":"vast_seat1",
"bid":[
{
"impid":"1",
"price":9.051027,
"id":"vast_seat1-bid1-from-msan",
"adm":"<VAST version=\"2.0\"><Ad id=\"preroll-1\"><InLine><AdSystem>2.0</AdSystem><AdTitle>5773100</AdTitle><Creatives><Creative><Linear><Duration>00:00:15</Duration><MediaFiles><MediaFile height=\"360\" width=\"640\" type=\"video/mp4\" delivery=\"streaming\">http://ndtrs.net/videos/video.mp4</MediaFile></MediaFiles></Linear></Creative><Creative><CompanionAds><Companion height=\"250\" width=\"300\" id=\"573242\"><HTMLResource><![CDATA[<A href=\"http://ndtrs.net/beacon\" target=\"_blank\"><IMG SRC=\"http://ndtrs.net/images/image.png\" ALT=\"Click Here\" /></A><img src=\"http://ndtrs.net/images/image.png\" height=\"1\" width=\"1\" />]]></HTMLResource></Companion></CompanionAds></Creative></Creatives></InLine></Ad></VAST>",
"adomain":[
"example.com"
],
"crid":"16969426",
"cid":"2445",
"iurl":"http://ndtrs.net/images/image.png",
"nurl":"http://ndtrs.net/winnotice/win?case=rtbVastResponse"
}
]
}
]
}ADM Object Description
In accordance with the IAB, the ADM object should contain a plain VAST XML tag as shown in the OpenRTB 2.2 specifications and the VAST XML Schema Definitions.
Last Modified: November 29, 2021 at 2:02 pm