Video Ads (2.4)
In this guide, you will find example bid requests and responses for video ads with OpenRTB 2.4.
Example requests and responses include:
- Instream pre-roll
- Instream mid-roll
- Instream post-roll
- Instream Interstitial
- Outstream
- Rewarded
Currently, Smaato’s VAST video capabilities are running on VAST Version 2.0, 3.0, and 4.0, as detailed in the IAB’s OpenRTB 2.4 specifications.
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. |
api |
Indicates the supported VPAID version, which in our case will be 2 corresponding to VPAID 2.0. |
Instream Pre-Roll (Request)
{
"allimps": 0,
"app": {
"bundle": "defaultBundleId",
"cat": [
"IAB7-42"
],
"id": "294",
"name": "appName",
"publisher": {
"id": "5020393",
"name": "PublisherName"
},
"storeurl": "https://itunes.apple.com/app/apple-store/id953922567567341232323"
},
"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",
"ipservice": 3,
"lat": 42.360504,
"lon": -71.0548,
"metro": "506",
"region": "MA",
"type": 2,
"zip": "02109"
},
"h": 480,
"ip": "50.255.150.200",
"js": 0,
"language": "en",
"make": "Apple",
"model": "iPhone",
"os": "iOS",
"osv": "4.3.2",
"pxratio": 1,
"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",
"w": 320
},
"ext": {
"pchain": "07bcf65f187117b4:5020393"
},
"id": "c47285e9-6af7-485a-be77-8a5666abb4e2",
"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
],
"skip": 0,
"startdelay": 0,
"w": 320
}
}
],
"regs": {
"coppa": 0,
"ext": {
}
},
"tmax": 1500,
"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)
{
"allimps": 0,
"app": {
"bundle": "defaultBundleId",
"cat": [
"IAB7-42"
],
"id": "294",
"name": "appName",
"publisher": {
"id": "5020393",
"name": "PublisherName"
},
"storeurl": "https://itunes.apple.com/app/apple-store/id953922567567341232323"
},
"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",
"ipservice": 3,
"lat": 42.360504,
"lon": -71.0548,
"metro": "506",
"region": "MA",
"type": 2,
"zip": "02109"
},
"h": 480,
"ip": "50.255.150.200",
"js": 0,
"language": "en",
"make": "Apple",
"model": "iPhone",
"os": "iOS",
"osv": "4.3.2",
"pxratio": 1,
"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",
"w": 320
},
"ext": {
"pchain": "07bcf65f187117b4:5020393"
},
"id": "209a3b6d-9be0-445b-a1bd-20f750e0f805",
"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
],
"skip": 0,
"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)
{
"allimps": 0,
"app": {
"bundle": "defaultBundleId",
"cat": [
"IAB7-42"
],
"id": "294",
"name": "appName",
"publisher": {
"id": "5020393",
"name": "PublisherName"
},
"storeurl": "https://itunes.apple.com/app/apple-store/id953922567567341232323"
},
"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",
"ipservice": 3,
"lat": 42.360504,
"lon": -71.0548,
"metro": "506",
"region": "MA",
"type": 2,
"zip": "02109"
},
"h": 480,
"ip": "50.255.150.200",
"js": 0,
"language": "en",
"make": "Apple",
"model": "iPhone",
"os": "iOS",
"osv": "4.3.2",
"pxratio": 1,
"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",
"w": 320
},
"ext": {
"pchain": "07bcf65f187117b4:5020393"
},
"id": "648f7135-486f-40ad-9002-28ee81392a13",
"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
],
"skip": 0,
"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)
{
"allimps": 0,
"app": {
"bundle": "defaultBundleId",
"cat": [
"IAB7-42"
],
"id": "294",
"name": "appName",
"publisher": {
"id": "5020393",
"name": "PublisherName"
},
"storeurl": "https://itunes.apple.com/app/apple-store/id953922567567341232323"
},
"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",
"ipservice": 3,
"lat": 42.360504,
"lon": -71.0548,
"metro": "506",
"region": "MA",
"type": 2,
"zip": "02109"
},
"h": 480,
"ip": "50.255.150.200",
"js": 0,
"language": "en",
"make": "Apple",
"model": "iPhone",
"os": "iOS",
"osv": "4.3.2",
"pxratio": 1,
"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",
"w": 320
},
"ext": {
"pchain": "07bcf65f187117b4:5020393"
},
"id": "b25a21b1-5989-4879-a84a-933ec8f26e45",
"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
],
"skip": 0,
"w": 320
}
}
],
"regs": {
"coppa": 0,
"ext": {
}
},
"tmax": 1500,
"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)
{
"allimps": 0,
"app": {
"bundle": "defaultBundleId",
"cat": [
"IAB7-42"
],
"id": "294",
"name": "appName",
"publisher": {
"id": "5020393",
"name": "PublisherName"
},
"storeurl": "https://itunes.apple.com/app/apple-store/id953922567567341232323"
},
"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",
"ipservice": 3,
"lat": 42.360504,
"lon": -71.0548,
"metro": "506",
"region": "MA",
"type": 2,
"zip": "02109"
},
"h": 480,
"ip": "50.255.150.200",
"js": 0,
"language": "en",
"make": "Apple",
"model": "iPhone",
"os": "iOS",
"osv": "4.3.2",
"pxratio": 1,
"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",
"w": 320
},
"ext": {
"pchain": "07bcf65f187117b4:5020393"
},
"id": "b0eeed0e-7b2d-43db-8735-81a2bd821436",
"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
],
"skip": 0,
"w": 320
}
}
],
"regs": {
"coppa": 0,
"ext": {
}
},
"tmax": 1500,
"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)
{
"allimps": 0,
"app": {
"bundle": "defaultBundleId",
"cat": [
"IAB7-42"
],
"id": "294",
"name": "appName",
"publisher": {
"id": "5020393",
"name": "PublisherName"
},
"storeurl": "https://itunes.apple.com/app/apple-store/id953922567567341232323"
},
"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",
"ipservice": 3,
"lat": 42.360504,
"lon": -71.0548,
"metro": "506",
"region": "MA",
"type": 2,
"zip": "02109"
},
"h": 480,
"ip": "50.255.150.200",
"js": 0,
"language": "en",
"make": "Apple",
"model": "iPhone",
"os": "iOS",
"osv": "4.3.2",
"pxratio": 1,
"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",
"w": 320
},
"ext": {
"pchain": "07bcf65f187117b4:5020393"
},
"id": "71109816-a781-40eb-abc6-d77c8cde7355",
"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
],
"skip": 0,
"w": 320
}
}
],
"regs": {
"coppa": 0,
"ext": {
}
},
"tmax": 1498,
"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"
}
]
}
]
}
Last Modified: November 29, 2021 at 2:01 pm