Element | Attributes | Values | Required | Supported | Notes |
VAST | | Root node | Yes | Yes | |
| version | String (2.0 and above) | Yes | Yes | Must support 2.0 and above |
- Ad | id - unique identifier | String | Yes | Yes | Top-level element wraps each ad in the response |
-- InLine | None | None | Yes | Yes | Second-level element surrounding complete ad data for a single ad |
--- AdSystem | Company Node Name | String | Yes | Yes | Indicates source ad server |
| version | String | Preferred | Yes | Internal version used by ad system |
--- AdTitle | None | String | No | Yes | Common name of ad |
--- Description | None | String | No | Yes | Longer description of ad |
--- Survey | None | URI | No | No | URI of request to survey vendor (Google will only support research tracking pixels. This can be implemented under the In-Line node as a Impression element.) |
--- Error | None | URI | No | Yes | URI to request if ad does not play due to error (Google will only execute a request to the URI upon error but does not have the ability to pass additional error information.) |
--- Impression | None | URI | Yes | Yes | URI to track impression |
--- Creatives | None | None | Yes | Yes | Container for one or more Creative elements |
---- Creative | | | Yes | Yes | Wraps each creative element |
| id | String | No | Yes | Optional identifier |
| sequence | Integer | No | Yes | The preferred order in which multiple Creatives should be displayed |
| AdID | String | No | Yes | Ad-ID for the creative (formerly ISCI) |
----- Linear | | | Yes | Yes | |
------ Duration | None | Time | Yes | Yes | |
------ TrackingEvents | | | No | No | |
------- Tracking | | URI | No | No | URI to track various events during playback |
| event | creativeView, start, firstQuartile, midpoint, thirdQuartile, complete, mute, unmute, pause, rewind, resume, fullscreen, expand, collapse, acceptInvitation, close | Yes (only for start, firstQuartile, midpoint, thirdQuartile, complete, mute, unmute, pause, resume, skip [if skippable in-stream]) | Yes (only for start, firstQuartile, midpoint, thirdQuartile, complete, mute, unmute, pause, resume, skip [if skippable in-stream]) | The name of the event to track for the Linear element. The creativeView should always be requested when present. |
------ AdParameters | | String | No | No | Data to be passed into the video ad. |
------ VideoClicks | | | Yes | Yes | |
------- ClickThrough | None | URI | Yes | Yes | URI to open as destination page when user clicks on the video |
------- ClickTracking | | URI | No | Yes | URI to request for tracking purposes when user clicks on the video |
------- CustomClick | | URI | No | Yes | URIs to request on custom events such as hotspotted video |
| id | String | No | No | Optional identifier |
------ MediaFiles | | | Yes | Yes | |
------- MediaFile | | URI | Yes | Yes | Location of linear file |
| delivery | progressive | Yes | Yes | Method of delivery of ad (Streaming is not preferred by Google) |
| type | String | Yes | Yes | MIME type (Popular MIME types is "video/x-ms-wmv" for Windows Media) |
| bitrate | Integer | Yes | Yes | Bitrate of encoded video in Kbps |
| width | Integer (480) | Yes | Yes | Pixel dimensions of video |
| height | Integer (360) | Yes | Yes | Pixel dimensions of video |
| scalable | Boolean | No | No | Whether it is acceptable to scale the image (Google does this by default.) |
| maintainAspectRatio | Boolean | No | Yes | Google's player will always maintain the aspect ratio no matter what value is set for this attribute. |
| apiFramework | String | No | No | The apiFramework defines the method to use for communication if the MediaFile is interactive. |
----- CompanionAds | | | No | Yes | Companion banners are only currently supported on Google Ads. They are not currently supported on the Google Ad Manager. |
------ Companion | | | No | Yes | Any number of companions in any desired pixel dimensions. |
| id | String | No | Yes | Optional identifier |
| width | Integer (300) | Yes (if serving companion) | Yes | Pixel dimensions of companion (we accept 300x250 and 300x60 companion banners) |
| height | Integer (60 or 250) | Yes (if serving companion) | Yes | Pixel dimensions of companion (we accept 300x250 and 300x60 companion banners) |
| expandedWidth | Integer | No | No | Pixel dimensions of expanding companion ad when in expanded state (expandables not allowed with In-Stream ads on Google) |
| expandedHeight | Integer | No | No | Pixel dimensions of expanding companion ad when in expanded state (expandables not allowed with In-Stream ads on Google) |
| apiFramework | String | No | No | The apiFramework defines the method to use for communication with the companion |
------- StaticResource | | URI | No | Yes | URI to a static file, such as an image or SWF file |
| creativeType | String | Yes (if serving companion using StaticResource) | Yes | Mime type of static resource |
------- IFrameResource | None | URI | No | Yes | URI source for an IFrame to display the companion element |
------- HTMLResource | None | CDATA | No | No | HTML to display the companion element |
------- JavaScriptResource | None | CDATA | No | No | JavaScript to display the companion element |
------- TrackingEvents | | | No | No | |
-------- Tracking | | URI | No | No | URI to display the companion element |
| event | creativeView | Yes (if serving companion) | No | The creativeView should always be requested when present. For Companions creativeView is the only supported event. |
------- CompanionClickThrough | None | URI | No (yes if serving static image or flash file without hard-coded click-through) | Yes | URI to open as destination page when user clicks on the companion (SWF creatives must comply proper casing clickTAG) |
------- AltText | None | String | No | Yes | Alt test to be displayed when companion is rendered in HTML environment |
------- AdParameters | | String | No | No | Data to be passed into the companion ads |
----- NonLinearAds | | | No | No | Not currently supported (only Linear In-Stream) |
--- Extensions | | | No | No | |
---- Extension | type | Any | No | No | Any valid XML may be included in the Extensions node. |
- Wrapper | None | None | No | No (with exception to 2 wrappers allowed via the Google Ad Manager only) | Second-level element surrounding wrapper ad pointing to Secondary ad server |