IAB VAST (Video Ad Serving Template), Version 4.0
Top-level element, wraps each ad in the response or ad unit in an ad pod. This MUST be present unless an Error element is present.
Second-level element surrounding complete ad data for a single ad
Second-level element surrounding wrapper ad pointing to Secondary ad server.
Identifies the sequence of multiple Ads that are part of an Ad Pod.
A Boolean value that identifies a conditional ad.
Used when there is no ad response. When the ad server does not or cannot return an Ad. If included the video player must send a request to the URI provided (Sec 3.2.1).
Current version is 4.0
URLs to ping when icon action occurs.
The name of the event to track for the element. The creativeView should always be requested when present.
The name of the event to track. For nonlinear ads these events should be recorded on the video within the ad.
The time during the video at which this url should be pinged. Must be present for progress event.
URL to request for tracking purposes when user clicks on the video.
URLs to request on custom events such as hotspotted video.
URL to open as destination page when user clicks on the video. This can occur zero to many times. The XSD syntax can't represent that.
Ad server ID for the impression
A base creative resource type (sec 3.13) for non-video creative content. This specifies static, IFrame, or HTML content, or a combination thereof
HTML to display the companion element. This can occur zero to many times, but order should not be important.
URI source for an IFrame to display the companion element. This can occur zero to many times, but order should not be important.
URI to a static file, such as an image or SWF file. This can occur zero to many times, but order should not be important.
MIME type of static resource
URL to open as destination page when user clicks on the icon.
URLs to ping when user clicks on the the icon.
A URI for the tracking resource file to be called when the icon creative is displayed.
Program represented in the Icon.
Pixel dimensions of icon.
Pixel dimensions of icon.
The x-cooridinate of the top, left corner of the icon asset relative to the ad display area
The y-cooridinate of the top left corner of the icon asset relative to the ad display area.
The duration for which the player must display the icon. Expressed in standard time format hh:mm:ss.
Start time at which the player should display the icon. Expressed in standard time format hh:mm:ss.
The apiFramework defines the method to use for communication with the icon element
The pixel ratio for which the icon creative is intended. The pixel ratio is the ratio of physical pixels on the device to the device-independent pixels. An ad intended for display on a device with a pixel ratio that is twice that of a standard 1:1 pixel ratio would use the value "2" Default value is "1"
Any valid XML may be included in the Extensions node. This can occur zero to many times.
The MIME type of any code that might be included in the extension.
Specifies whether the parameters are XML-encoded
The URI to a static creative file to be used for the ad component identified in the parent element, which is either: <NonLinear>, <Companion>, or <Icon>.
Video formatted ad that plays linearly
Any number of icons representing advertising industry initiatives. This can occur zero to many times. The XSD syntax can't represent that.
The time at which the ad becomes skippable, if absent, the ad is not skippable.
Video formatted ad that plays linearly
Video formatted ad that plays linearly
Data to be passed into the video ad. Used to pass VAST info to VPAID object.
Duration in standard time format, hh:mm:ss
URI location of linear file. Content must be wrapped in CDATA tag.
Optional identifier
Either "progressive" for progressive download protocols (such as HTTP) or "streaming" for streaming protocols.
MIME type. Popular MIME types include, but are not limited to "video/x-ms-wmv" for Windows Media, and "video/x-flv" for Flash Video. Image ads or interactive ads can be included in the MediaFiles section with appropriate Mime types
Pixel dimensions of video
Pixel dimensions of video
The codec used to produce the media file as specified in RFC 4281.
Bitrate of encoded video in Kbps. If bitrate is supplied, minBitrate and maxBitrate should not be supplied.
Minimum bitrate of an adaptive stream in Kbps. If minBitrate is supplied, maxBitrate must be supplied and bitrate should not be supplied.
Maximum bitrate of an adaptive stream in Kbps. If maxBitrate is supplied, minBitrate must be supplied and bitrate should not be supplied.
Whether it is acceptable to scale the image.
Whether the ad must have its aspect ratio maintained when scales
identifies the API needed to execute an interactive media file, but current support is for backward compatibility. Please use the <InteractiveCreativeFile> element to include files that require an API for execution.
URI location to raw, high-quality media file for high-resolution environments. Content must be wrapped in CDATA tag.
For any media file that uses APIs for advanced creative functionality, the InteractivityCreativeFile element is used to identify the file and framework needed to execute advanced functions for the ad.
Identifies the MIME type of the file provided.
identifies the API needed to execute the Creative file if applicable
An ad that is overlain on top of video content during playback
URLs to ping when user clicks on the the non-linear ad unit. This can occur zero to many times (unbounded). The XSD syntax can't represent that.
Identifier provided to ad server for click reports
An ad that is overlain on top of video content during playback
Custom content used to pass information to ad unit
URI to advertiser page opened on viewer clicks through.
URLs to ping when user clicks on the the non-linear ad unit.
Identifier provided to ad server for click reports
Data to be passed into the companion ads. The apiFramework defines the method to use for communication (e.g. “FlashVar”)
Alt text to be displayed when companion is rendered in HTML environment.
URL to open as destination page when user clicks on the the companion banner ad.
A URI to a tracking resource file used to track a companion clickthrough.
An id provided by the ad server to track the click in reports.
The creativeView should always be requested when present. For Companions creativeView is the only supported event.
Optional identifier
Pixel dimensions of companion slot
Pixel dimensions of companion slot
Pixel dimensions of the companion asset
Pixel dimensions of the companion asset
Pixel dimensions of expanding companion ad when in expanded state
Pixel dimensions of expanding companion ad when in expanded state
The apiFramework defines the method to use for communication with the companion
Used to match companion creative to publisher placement areas on the page.
The pixel ratio for which the icon creative is intended. The pixel ratio is the ratio of physical pixels on the device to the device-independent pixels. An ad intended for display on a device with a pixel ratio that is twice that of a standard 1:1 pixel ratio would use the value "2" Default value is "1"
General subclass type for Companion Ad elements. This can occur zero to many times.
How the player should treat a companion ad when multiple are supplied
The preferred order in which multiple Creatives should be displayed
Identifies an API needed to execute the creative
A string used to identify the ad server that provides the creative.
To be deprecated in future version of VAST. Ad-ID for the creative (formerly ISCI)
Any number of companions in any desired pixel dimensions.
Any number of companions in any desired pixel dimensions.
The UniversalAdId is used to provide a unique creative identifier for the purposes of tracking ad creative. This is used for Ad-ID(r) for ads served in the United States.
Base type structure used by Inline or Wrapper ad content element types
Indicates source ad server
Internal version used by ad system
URL to request if ad does not play due to error
XML node for custom extensions, as defined by the ad server. When used, a custom element should be nested under <Extensions> to help separate custom XML elements from VAST elements.
One instance of <Extension> should be used for each custom extension. The type attribute identifies the MIME type of any code provided in the extension.
The MIME type of any code that might be included in the extension.
URI for impression tracking
The price of the ad that can be used in real time bidding systems.
The pricing model used.
Three letter ISO-4217 currency symbol that identifies the currency of the value provied. Ex: USD, GBP, etc.
The ViewableImpression element allows for tracking URIs to report viewability
A URI that directs the video player to a tracking resource file that the video player should request at the time that criteria is met for a viewable impression. This can occur zero to many times.
A URI that directs the video player to a tracking resource file that the video player should request if the ad is executed but never meets criteria for a viewable impression.
A URI that directs the video player to a tracking resource file that the video player should request if the player cannot determine whether criteria is met for a viewable impression. This can occur zero to many times.
An ad server id for the impression. Impression resources of the same id should be requested at the same time or as close in time as possible to help prevent discrepancies.
Verification elements are nested under AdVerifications. The Verification element is used to contain the JavaScript or Flash code used to collect data. Multiple Verification elements may be used in cases where more than one verification vendor needs to collect data or when different API frameworks are used.
The name of the event to track for the element. The creativeView should always be requested when present.
Verification elements are nested under AdVerifications. The Verification element is used to contain the JavaScript or Flash code used to collect data. Multiple Verification elements may be used in cases where more than one verification vendor needs to collect data or when different API frameworks are used. When included, verification contents must be executed (if possible) BEFORE the media file or interactive creative file is executed, to ensure verification can track ad play as intended.
The name of the event to track for the element. The creativeView should always be requested when present.
The home page URL for the verification service provider that supplies the resource file.
The AdVerification element is used to initiate a controlled container where code can be executed for collecting data to verify ad playback details.
The AdVerification element is used to initiate a controlled container where code can be executed for collecting data to verify ad playback details.
A container for one or more Creative elements used to provide creative files for ad.
A URI to another VAST response that may be another VAST Wrapper or a VAST InLine ad.
a Boolean value that identifies whether subsequent wrappers after a requested VAST response is allowed.
a Boolean value that identifies whether multiple ads are allowed in the requested VAST response.
a Boolean value that provides instruction for using an available Ad when the requested VAST response returns no ads.
Common name of ad
Name of advertiser as defined by the ad serving party
A string that provides a category code or label that identifies the ad content.
A URI for the organizational authority that produced the list being used to identify ad content.
A container for one or more Creative elements used to provide creative files for ad.
Longer description of ad
URL of request to survey vendor
MIME type of the resource being served