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.

Modified: October 15, 2019 at 4:13 pm