Third-party in-stream ads XML summary for VAST ad server response

a

Google provides translated versions of our Help Center, though they are not meant to change the content of our policies. The English version is the official language we use to enforce our policies. To view this article in a different language, use the language dropdown at the bottom of the page.

Note The XML summary response should meet the VAST 2.0 specs. VAST 2.0 or higher is supported. Learn more about VAST 2.0
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

 

Was this helpful?

How can we improve it?
false
Search
Clear search
Close search
Google apps
Main menu
102481865904556416
true
Search Help Center
true
true
true
true
true
73067
false
false