vast 0.1

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2010 Chris Dinn
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,45 @@
+VAST
+=====
+
+A library for parsing Digital Video Ad Serving Template (VAST) documents, as outlined by the Interactive Advertising Bureau at 
+[http://www.iab.net/iab_products_and_industry_services/508676/digitalvideo/vast]. This library strives to be as true to the 
+standard as possible, while presenting a Ruby-friendly interface.
+
+VAST outlines a standard document format for communication between digital video players and ad servers, including support for 
+multiple forms of creative and tracking support that conforms to the latest IAB standards.
+
+Installation
+------------
+
+VAST is available as a RubyGem.  
+
+    gem install vast
+
+Usage
+-----
+
+Parse a VAST document and access it's contents easily. See the documentation for the individual classes for an overview of
+what information available for each class.
+
+    document = VAST::Document.parse(File.read("vast_document.xml"))
+
+Problems/Bugs/Requests
+-----------------------------
+
+Please, file an issue.
+
+Note on Patches/Pull Requests
+-----------------------------
+
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+Copyright
+-----------------------------
+
+© 2010 Chris Dinn. See [LICENSE](http://github.com/chrisdinn/vast/blob/master/LICENSE) for details.

data/README.rdoc

@@ -0,0 +1,43 @@
+= VAST
+
+A library for parsing Digital Video Ad Serving Template (VAST) documents, as outlined by the Interactive Advertising Bureau at 
+http://www.iab.net/iab_products_and_industry_services/508676/digitalvideo/vast. This library strives to be as true to the 
+standard as possible, while presenting a Ruby-friendly interface.
+
+VAST outlines a standard document format for communication between digital video players and ad servers, including support for 
+multiple forms of creative and tracking support that conforms to the latest IAB standards.
+
+== Installation
+
+VAST is available as a RubyGem.  
+
+  gem install vast
+
+== Usage
+
+Parse a VAST document and access it's contents easily. See the documentation for the individual classes for an overview of
+what information available for each class.
+
+  document = VAST::Document.parse(File.read("vast_document.xml"))
+
+== Documentation
+
+Read the rdoc at http://rdoc.info/projects/chrisdinn/vast
+
+== Problems/Bugs/Requests
+
+Please, file an issue.
+
+== Note on Patches/Pull Requests
+
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+== Copyright
+
+© 2010 Chris Dinn. See LICENSE for details.

data/lib/vast.rb

@@ -0,0 +1,22 @@
+require 'vast/document'
+require 'vast/ad'
+require 'vast/inline_ad'
+require 'vast/creative'
+require 'vast/linear_creative'
+require 'vast/mediafile'
+
+# This module wraps VAST documents, as outlined by the IAB at http://www.iab.net/media/file/VAST-2_0-FINAL.pdf
+module VAST
+  VAST_VERSION = 2.0
+  VAST_SCHEMA_XSD_FILE = File.expand_path(File.join(File.dirname(__FILE__), 'vast_2.0.1.xsd'))
+  
+  # Raised when parsing a VAST document that does not conform to the VAST spec XSD
+  class InvalidDocumentError < StandardError; end
+  
+  # Raised when parsing a VAST ad node that is not complete
+  class InvalidAdError < StandardError; end
+  
+  # Raised when parsing a VAST creative node that is not complete
+  class InvalidCreativeError < StandardError; end
+  
+end

data/lib/vast/ad.rb

@@ -0,0 +1,78 @@
+module VAST
+  class Ad
+    attr_reader :source_node
+    
+    def initialize(node)
+      @source_node = node
+    end
+    
+    # Create proper ad type
+    def self.create(node)
+      if node.at('InLine')
+        InlineAd.new(node)
+      elsif node.at('Wrapper')
+        WrapperAd.new(node)
+      else
+        raise InvalidAdError
+      end
+    end
+    
+    # Ad id, if indicated
+    def id
+      @source_node[:id]
+    end
+    
+    # Name of source ad server
+    def ad_system
+      ad_system_node = @source_node.at("AdSystem")
+      if ad_system_node
+        ad_system_node.content
+      else
+        raise InvalidAdError, "missing AdSystem node in Ad"   
+      end
+    end
+    
+    # URI to request if ad does not play due to error
+    def error_url
+      error_url_node = @source_node.at("Error")
+      URI.parse(error_url_node.content) if error_url_node
+    end
+    
+    # Returns an array containing all linear creatives
+    def linear_creatives
+      @source_node.xpath('.//Creative/Linear').to_a.collect do |node|
+        LinearCreative.new(node)
+      end
+    end
+    
+    # Returns an array containing all non linear creatives
+    def non_linear_creatives
+      @source_node.xpath('.//Creative/NonLinearAds/NonLinear').to_a.collect do |node|
+        NonLinearCreative.new(node)
+      end
+    end
+    
+    # Returns an array containing all companion creatives
+    def companion_creatives
+      @source_node.xpath('.//Creative/CompanionAds/Companion').to_a.collect do |node|
+        CompanionCreative.new(node)
+      end
+    end
+    
+    # Each Ad should contain at least one impression.
+    def impression
+      URI.parse(@source_node.at('Impression').content)
+    end
+    
+    # Array of all impressions available for this ad, excluding those specific
+    # to a particular creative.
+    def impressions
+      @source_node.xpath('.//Impression').to_a.collect do |node|
+        URI.parse(node)
+      end
+    end
+    
+  end
+  
+  class WrapperAd < Ad; end
+end

data/lib/vast/creative.rb

@@ -0,0 +1,59 @@
+module VAST
+  class Creative
+    attr_reader :source_node
+    
+    def initialize(node)
+      @source_node = node
+    end
+    
+    def ad
+      Ad.create @source_node.ancestors('Ad').first
+    end
+    
+    def id
+      creative_node[:id]
+    end
+    
+    def ad_id
+      creative_node[:AdID]
+    end
+    
+    # The preferred order in which multiple Creatives should be displayed
+    def sequence
+      creative_node[:sequence]
+    end
+    
+    # Data to be passed into the video ad.
+    def ad_parameters
+      @source_node.at('AdParameters').content
+    end
+    
+    def tracking_urls
+      tracking_urls = {}
+      @source_node.xpath('.//Tracking').to_a.collect do |node|
+        underscored_name = underscore(node[:event])
+        tracking_urls[underscored_name.to_sym] = URI.parse(node.content)
+      end
+      tracking_urls
+    end
+    
+    protected
+    
+    def underscore(camel_cased_word)
+       camel_cased_word.to_s.gsub(/::/, '/').
+          gsub(/([A-Z]+)([A-Z][a-z])/,'\1_\2').
+          gsub(/([a-z\d])([A-Z])/,'\1_\2').
+          tr("-", "_").
+          downcase
+    end
+    
+    private
+    
+    def creative_node
+      @source_node.ancestors('Creative').first
+    end
+  end
+  
+  class NonLinearCreative < Creative; end
+  class CompanionCreative < Creative; end
+end

data/lib/vast/document.rb

@@ -0,0 +1,40 @@
+module VAST
+  class Document < Nokogiri::XML::Document
+    
+    # Parse a VAST XML document
+    def self.parse(*args)
+      super(*args)
+    end
+    
+    # Same as parse, but raises InvalidDocumentError if document is not valid
+    def self.parse!(*args)
+      document = parse(*args)
+      raise InvalidDocumentError unless document.valid?
+      document
+    end
+    
+    # Checks whether document conforms to the VAST XML Schema Definitions, accessible at
+    # http://www.iab.net/iab_products_and_industry_services/508676/digitalvideo/vast
+    def valid?
+      xsd = Nokogiri::XML::Schema(File.read(VAST_SCHEMA_XSD_FILE))
+      xsd.valid?(self)
+    end
+    
+    # All ads in the document
+    def ads
+      self.root.xpath('.//Ad').to_a.collect do |node|
+        Ad.create(node)
+      end
+    end
+    
+    # All inline ads
+    def inline_ads
+      ads.select{ |ad| ad.kind_of?(VAST::InlineAd) }
+    end
+    
+    # All wrapper ads
+    def wrapper_ads
+      ads.select{ |ad| ad.kind_of?(VAST::WrapperAd) }
+    end
+  end
+end

data/lib/vast/inline_ad.rb

@@ -0,0 +1,15 @@
+module VAST
+  class InlineAd < Ad
+    
+    # URI of request to survey vendor
+    def survey_url
+      URI.parse @source_node.at('Survey').content
+    end
+    
+    # Common name of ad
+    def ad_title
+      @source_node.at('AdTitle').content
+    end
+  end
+end
+

data/lib/vast/linear_creative.rb

@@ -0,0 +1,39 @@
+module VAST
+  class LinearCreative < Creative
+    
+    # Duration of creative
+    def duration
+      @source_node.at('Duration').content
+    end
+    
+    # URI to open as destination page when user clicks on the video
+    def click_through_url
+      URI.parse @source_node.at('ClickThrough').content
+    end
+    
+    # An array of URIs to request for tracking purposes when user clicks on the video
+    def click_tracking_urls
+      @source_node.xpath('.//ClickTracking').to_a.collect do |node|
+        URI.parse node.content
+      end
+    end
+    
+    # A hash of URIs to request on custom events such as hotspotted video. This library
+    # required custom click urls to identify themselves with an `id` attribute, which is
+    # used as the key for this hash
+    def custom_click_urls
+      custom_click_urls = {}
+      @source_node.xpath('.//CustomClick').to_a.collect do |node|
+        key = underscore(node[:id]).to_sym
+        custom_click_urls[key] = URI.parse(node.content)
+      end
+      custom_click_urls
+    end
+    
+    def mediafiles
+      @source_node.xpath('.//MediaFile').to_a.collect do |node|
+        Mediafile.new(node)
+      end
+    end
+  end
+end

data/lib/vast/mediafile.rb

@@ -0,0 +1,54 @@
+module VAST
+  class Mediafile
+    attr_reader :source_node
+    
+    def initialize(node)
+      @source_node = node
+    end
+    
+    # Location of linear file
+    def url
+      URI.parse @source_node.content
+    end
+    
+    def id
+      @source_node[:id]
+    end
+    
+    # Method of delivery of ad, either "streaming" or "progressive"
+    def delivery
+      @source_node[:delivery]
+    end
+    
+    # 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.
+    def type
+      @source_node[:type]
+    end
+    
+    # Bitrate of encoded video in Kbps
+    def bitrate
+      @source_node[:bitrate].to_i
+    end
+    
+    # Pixel dimensions of video width
+    def width
+      @source_node[:width].to_i
+    end
+    
+    # Pixel dimensions of video height
+    def height
+      @source_node[:height].to_i
+    end
+    
+    # Whether it is acceptable to scale the image.
+    def scalable?
+      @source_node[:scalable]=="true"
+    end
+    
+    # Whether the ad must have its aspect ratio maintained when scaled
+    def maintain_aspect_ratio?
+      @source_node[:maintainAspectRatio]=="true"
+    end
+  end
+end

data/lib/vast_2.0.1.xsd

@@ -0,0 +1,643 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified"
+	attributeFormDefault="unqualified">
+	<xs:element name="VAST">
+		<xs:annotation>
+			<xs:documentation>IAB VAST, Video Ad Serving Template, video xml ad response, Version 2.0.1, xml schema prepared by Tremor Media</xs:documentation>
+		</xs:annotation>
+		<xs:complexType>
+			<xs:sequence>
+				<xs:element name="Ad" maxOccurs="unbounded" minOccurs="0">
+					<xs:annotation>
+						<xs:documentation>Top-level element, wraps each ad in the response</xs:documentation>
+					</xs:annotation>
+					<xs:complexType>
+						<xs:choice maxOccurs="1" minOccurs="1">
+							<xs:element name="InLine" maxOccurs="1" minOccurs="0">
+								<xs:annotation>
+									<xs:documentation>Second-level element surrounding complete ad data for a single ad</xs:documentation>
+								</xs:annotation>
+								<xs:complexType>
+									<xs:sequence>
+										<xs:element name="AdSystem" maxOccurs="1" minOccurs="1"
+											type="AdSystem_type">
+											<xs:annotation>
+												<xs:documentation>Indicates source ad server</xs:documentation>
+											</xs:annotation>
+										</xs:element>
+										<xs:element name="AdTitle" type="xs:string" maxOccurs="1"
+											minOccurs="1">
+											<xs:annotation>
+												<xs:documentation>Common name of ad</xs:documentation>
+											</xs:annotation>
+										</xs:element>
+										<xs:element name="Description" type="xs:string"
+											minOccurs="0" maxOccurs="1">
+											<xs:annotation>
+												<xs:documentation>Longer description of ad</xs:documentation>
+											</xs:annotation>
+										</xs:element>
+										<xs:element name="Survey" type="xs:anyURI" minOccurs="0"
+											maxOccurs="1">
+											<xs:annotation>
+												<xs:documentation>URL of request to survey vendor</xs:documentation>
+											</xs:annotation>
+										</xs:element>
+										<xs:element name="Error" type="xs:anyURI" minOccurs="0"
+											maxOccurs="1">
+											<xs:annotation>
+												<xs:documentation>URL to request if ad does not play due to error</xs:documentation>
+											</xs:annotation>
+										</xs:element>
+										<xs:element name="Impression" type="Impression_type"
+											maxOccurs="unbounded" minOccurs="1">
+											<xs:annotation>
+												<xs:documentation>URL to track impression</xs:documentation>
+											</xs:annotation>
+										</xs:element>
+										<xs:element maxOccurs="1" minOccurs="1" name="Creatives">
+											<xs:annotation>
+												<xs:documentation>Any number of companions in any desired pixel dimensions.</xs:documentation>
+											</xs:annotation>
+											<xs:complexType>
+												<xs:sequence>
+												<xs:element name="Creative" maxOccurs="unbounded">
+												<xs:annotation>
+												<xs:documentation>Wraps each creative element within an InLine or Wrapper Ad</xs:documentation>
+												</xs:annotation>
+												<xs:complexType>
+												<xs:choice>
+												<xs:element name="Linear" minOccurs="0"
+												maxOccurs="1">
+												<xs:complexType>
+												<xs:sequence>
+												<xs:element name="Duration" type="xs:time"
+												maxOccurs="1" minOccurs="1">
+												<xs:annotation>
+												<xs:documentation>Duration in standard time format, hh:mm:ss</xs:documentation>
+												</xs:annotation>
+												</xs:element>
+												<xs:element name="TrackingEvents" minOccurs="0"
+												type="TrackingEvents_type" maxOccurs="1"> </xs:element>
+												<xs:element name="AdParameters" type="xs:string"
+												minOccurs="0" maxOccurs="1">
+												<xs:annotation>
+												<xs:documentation>Data to be passed into the video ad</xs:documentation>
+												</xs:annotation>
+												</xs:element>
+												<xs:element name="VideoClicks" minOccurs="0"
+												type="VideoClicks_type" maxOccurs="1"> </xs:element>
+												<xs:element name="MediaFiles" minOccurs="0"
+												maxOccurs="1">
+												<xs:complexType>
+												<xs:sequence>
+												<xs:element name="MediaFile" minOccurs="1"
+												maxOccurs="unbounded">
+												<xs:annotation>
+												<xs:documentation>Location of linear file</xs:documentation>
+												</xs:annotation>
+												<xs:complexType>
+												<xs:simpleContent>
+												<xs:extension base="xs:anyURI">
+												<xs:attribute name="id" type="xs:string"
+												use="optional">
+												<xs:annotation>
+												<xs:documentation>Optional identifier</xs:documentation>
+												</xs:annotation>
+												</xs:attribute>
+												<xs:attribute name="delivery" use="required">
+												<xs:annotation>
+												<xs:documentation>Method of delivery of ad</xs:documentation>
+												</xs:annotation>
+												<xs:simpleType>
+												<xs:restriction base="xs:NMTOKEN">
+												<xs:enumeration value="streaming"/>
+												<xs:enumeration value="progressive"/>
+												</xs:restriction>
+												</xs:simpleType>
+												</xs:attribute>
+												<xs:attribute name="type" use="required"
+												type="xs:string">
+												<xs:annotation>
+												<xs:documentation>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</xs:documentation>
+												</xs:annotation>
+												</xs:attribute>
+												<xs:attribute name="bitrate" type="xs:integer"
+												use="optional">
+												<xs:annotation>
+												<xs:documentation>Bitrate of encoded video in Kbps</xs:documentation>
+												</xs:annotation>
+												</xs:attribute>
+												<xs:attribute name="width" type="xs:integer"
+												use="required">
+												<xs:annotation>
+												<xs:documentation>Pixel dimensions of video</xs:documentation>
+												</xs:annotation>
+												</xs:attribute>
+												<xs:attribute name="height" type="xs:integer"
+												use="required">
+												<xs:annotation>
+												<xs:documentation>Pixel dimensions of video</xs:documentation>
+												</xs:annotation>
+												</xs:attribute>
+												<xs:attribute name="scalable" type="xs:boolean"
+												use="optional">
+												<xs:annotation>
+												<xs:documentation>Whether it is acceptable to scale the image.</xs:documentation>
+												</xs:annotation>
+												</xs:attribute>
+												<xs:attribute name="maintainAspectRatio"
+												type="xs:boolean" use="optional">
+												<xs:annotation>
+												<xs:documentation>Whether the ad must have its aspect ratio maintained when scales</xs:documentation>
+												</xs:annotation>
+												</xs:attribute>
+												<xs:attribute name="apiFramework" type="xs:string"
+												use="optional">
+												<xs:annotation>
+												<xs:documentation>The apiFramework defines the method to use for communication if the MediaFile is interactive. Suggested values for this element are “VPAID”, “FlashVars” (for Flash/Flex), “initParams” (for Silverlight) and “GetVariables” (variables placed in key/value pairs on the asset request).</xs:documentation>
+												</xs:annotation>
+												</xs:attribute>
+												</xs:extension>
+												</xs:simpleContent>
+												</xs:complexType>
+												</xs:element>
+												</xs:sequence>
+												</xs:complexType>
+												</xs:element>
+												</xs:sequence>
+												</xs:complexType>
+												</xs:element>
+												<xs:element name="CompanionAds" minOccurs="0"
+												maxOccurs="1">
+												<xs:complexType>
+												<xs:sequence>
+												<xs:element name="Companion" minOccurs="0"
+												maxOccurs="unbounded" type="Companion_type">
+												<xs:annotation>
+												<xs:documentation>Any number of companions in any desired pixel dimensions.</xs:documentation>
+												</xs:annotation>
+												</xs:element>
+												</xs:sequence>
+												</xs:complexType>
+												</xs:element>
+												<xs:element name="NonLinearAds" minOccurs="0"
+												maxOccurs="1">
+												<xs:complexType>
+												<xs:sequence>
+												<xs:element name="TrackingEvents" minOccurs="0"
+												type="TrackingEvents_type" maxOccurs="1"> </xs:element>
+												<xs:element name="NonLinear" minOccurs="1"
+												maxOccurs="unbounded" type="NonLinear_type">
+												<xs:annotation>
+												<xs:documentation>Any number of companions in any desired pixel dimensions.</xs:documentation>
+												</xs:annotation>
+												</xs:element>
+												</xs:sequence>
+												</xs:complexType>
+												</xs:element>
+												</xs:choice>
+												<xs:attribute name="id" type="xs:string"
+												use="optional"/>
+												<xs:attribute name="sequence" type="xs:integer"
+												use="optional">
+												<xs:annotation>
+												<xs:documentation>The preferred order in which multiple Creatives should be displayed</xs:documentation>
+												</xs:annotation>
+												</xs:attribute>
+												<xs:attribute name="AdID" type="xs:string"
+												use="optional">
+												<xs:annotation>
+												<xs:documentation>Ad-ID for the creative (formerly ISCI)</xs:documentation>
+												</xs:annotation>
+												</xs:attribute>
+												</xs:complexType>
+												</xs:element>
+												</xs:sequence>
+											</xs:complexType>
+										</xs:element>
+										<xs:element name="Extensions" minOccurs="0" maxOccurs="1">
+											<xs:complexType>
+												<xs:sequence>
+												<xs:element name="Extension" type="xs:anyType"
+												minOccurs="0" maxOccurs="unbounded">
+												<xs:annotation>
+												<xs:documentation>Any valid XML may be included in the Extensions node</xs:documentation>
+												</xs:annotation>
+												</xs:element>
+												</xs:sequence>
+											</xs:complexType>
+										</xs:element>
+									</xs:sequence>
+								</xs:complexType>
+							</xs:element>
+							<xs:element name="Wrapper" maxOccurs="1" minOccurs="0">
+								<xs:annotation>
+									<xs:documentation>Second-level element surrounding wrapper ad pointing to Secondary ad server.</xs:documentation>
+								</xs:annotation>
+								<xs:complexType>
+									<xs:sequence>
+										<xs:element name="AdSystem" type="AdSystem_type"
+											maxOccurs="1" minOccurs="1">
+											<xs:annotation>
+												<xs:documentation>Indicates source ad server</xs:documentation>
+											</xs:annotation>
+										</xs:element>
+										<xs:element name="VASTAdTagURI" type="xs:anyURI"
+											maxOccurs="1" minOccurs="1">
+											<xs:annotation>
+												<xs:documentation>URL of ad tag of downstream Secondary Ad Server</xs:documentation>
+											</xs:annotation>
+										</xs:element>
+										<xs:element name="Error" type="xs:anyURI" minOccurs="0"
+											maxOccurs="1">
+											<xs:annotation>
+												<xs:documentation>URL to request if ad does not play due to error</xs:documentation>
+											</xs:annotation>
+										</xs:element>
+										<xs:element name="Impression" type="xs:anyURI"
+											maxOccurs="unbounded" minOccurs="1">
+											<xs:annotation>
+												<xs:documentation>URL to request to track an impression</xs:documentation>
+											</xs:annotation>
+										</xs:element>
+										<xs:element name="Creatives">
+											<xs:complexType>
+												<xs:sequence>
+												<xs:element name="Creative" maxOccurs="unbounded"
+												minOccurs="0">
+												<xs:complexType>
+												<xs:choice>
+												<xs:element name="Linear" minOccurs="0"
+												maxOccurs="1">
+												<xs:complexType>
+												<xs:sequence>
+												<xs:element name="TrackingEvents" minOccurs="0"
+												type="TrackingEvents_type" maxOccurs="1"> </xs:element>
+												<xs:element name="VideoClicks" minOccurs="0"
+												maxOccurs="1">
+												<xs:complexType>
+												<xs:sequence>
+												<xs:element name="ClickTracking" minOccurs="0"
+												maxOccurs="unbounded">
+												<xs:annotation>
+												<xs:documentation>URL to request for tracking purposes when user clicks on the video</xs:documentation>
+												</xs:annotation>
+												<xs:complexType>
+												<xs:simpleContent>
+												<xs:extension base="xs:anyURI">
+												<xs:attribute name="id" type="xs:string"
+												use="optional"/>
+												</xs:extension>
+												</xs:simpleContent>
+												</xs:complexType>
+												</xs:element>
+												</xs:sequence>
+												</xs:complexType>
+												</xs:element>
+												</xs:sequence>
+												</xs:complexType>
+												</xs:element>
+												<xs:element name="CompanionAds" minOccurs="0"
+												maxOccurs="1">
+												<xs:complexType>
+												<xs:sequence>
+												<xs:element name="Companion" minOccurs="0"
+												maxOccurs="unbounded" type="Companion_type">
+												<xs:annotation>
+												<xs:documentation>Definition of Companion ad, if served separately</xs:documentation>
+												</xs:annotation>
+												</xs:element>
+												</xs:sequence>
+												</xs:complexType>
+												</xs:element>
+												<xs:element name="NonLinearAds" minOccurs="0"
+												maxOccurs="1">
+												<xs:complexType>
+												<xs:sequence>
+												<xs:element name="TrackingEvents" minOccurs="0"
+												type="TrackingEvents_type" maxOccurs="1"> </xs:element>
+												<xs:element name="NonLinear" minOccurs="0"
+												maxOccurs="unbounded" type="NonLinear_type">
+												<xs:annotation>
+												<xs:documentation>Any number of companions in any desired pixel dimensions.</xs:documentation>
+												</xs:annotation>
+												</xs:element>
+												</xs:sequence>
+												</xs:complexType>
+												</xs:element>
+												</xs:choice>
+												<xs:attribute name="id" type="xs:string"
+												use="optional"/>
+												<xs:attribute name="sequence" type="xs:integer"
+												use="optional">
+												<xs:annotation>
+												<xs:documentation>The preferred order in which multiple Creatives should be displayed</xs:documentation>
+												</xs:annotation>
+												</xs:attribute>
+												<xs:attribute name="AdID" type="xs:string"
+												use="optional">
+												<xs:annotation>
+												<xs:documentation>Ad-ID for the creative (formerly ISCI)</xs:documentation>
+												</xs:annotation>
+												</xs:attribute>
+												</xs:complexType>
+												</xs:element>
+												</xs:sequence>
+											</xs:complexType>
+										</xs:element>
+										<xs:element name="Extensions" minOccurs="0" maxOccurs="1">
+											<xs:complexType>
+												<xs:sequence>
+												<xs:element name="Extension" type="xs:anyType"
+												minOccurs="0" maxOccurs="unbounded">
+												<xs:annotation>
+												<xs:documentation>Any valid XML may be included in the Extensions node</xs:documentation>
+												</xs:annotation>
+												</xs:element>
+												</xs:sequence>
+											</xs:complexType>
+										</xs:element>
+									</xs:sequence>
+								</xs:complexType>
+							</xs:element>
+						</xs:choice>
+						<xs:attribute name="id" type="xs:string" use="required"/>
+					</xs:complexType>
+				</xs:element>
+			</xs:sequence>
+			<xs:attribute name="version" type="xs:string" use="required">
+				<xs:annotation>
+					<xs:documentation>Current version is 2.0. The 2.0.1 version corrects an error in the Wrapper section related the Linear node's TrackingEvents and VideoCLicks elements.</xs:documentation>
+				</xs:annotation>
+			</xs:attribute>
+		</xs:complexType>
+	</xs:element>
+	<xs:complexType name="TrackingEvents_type">
+		<xs:sequence>
+			<xs:element name="Tracking" minOccurs="0" maxOccurs="unbounded">
+				<xs:annotation>
+					<xs:documentation>The name of the event to track for the Linear element. The creativeView should always be requested when present.</xs:documentation>
+				</xs:annotation>
+				<xs:complexType>
+					<xs:simpleContent>
+						<xs:extension base="xs:anyURI">
+							<xs:attribute name="event" use="required">
+								<xs:annotation>
+									<xs:documentation>The name of the event to track. For nonlinear ads these events should be recorded on the video within the ad.</xs:documentation>
+								</xs:annotation>
+								<xs:simpleType>
+									<xs:restriction base="xs:NMTOKEN">
+										<xs:enumeration value="creativeView"/>
+										<xs:enumeration value="start"/>
+										<xs:enumeration value="midpoint"/>
+										<xs:enumeration value="firstQuartile"/>
+										<xs:enumeration value="thirdQuartile"/>
+										<xs:enumeration value="complete"/>
+										<xs:enumeration value="mute"/>
+										<xs:enumeration value="unmute"/>
+										<xs:enumeration value="pause"/>
+										<xs:enumeration value="rewind"/>
+										<xs:enumeration value="resume"/>
+										<xs:enumeration value="fullscreen"/>
+										<xs:enumeration value="expand"/>
+										<xs:enumeration value="collapse"/>
+										<xs:enumeration value="acceptInvitation"/>
+										<xs:enumeration value="close"/>
+									</xs:restriction>
+								</xs:simpleType>
+							</xs:attribute>
+						</xs:extension>
+					</xs:simpleContent>
+				</xs:complexType>
+			</xs:element>
+		</xs:sequence>
+	</xs:complexType>
+	<xs:complexType name="VideoClicks_type">
+		<xs:sequence>
+			<xs:element name="ClickThrough" minOccurs="0" maxOccurs="1">
+				<xs:annotation>
+					<xs:documentation>URL to open as destination page when user clicks on the video</xs:documentation>
+				</xs:annotation>
+				<xs:complexType>
+					<xs:simpleContent>
+						<xs:extension base="xs:anyURI">
+							<xs:attribute name="id" type="xs:string" use="optional"/>
+						</xs:extension>
+					</xs:simpleContent>
+				</xs:complexType>
+			</xs:element>
+			<xs:element name="ClickTracking" minOccurs="0" maxOccurs="unbounded">
+				<xs:annotation>
+					<xs:documentation>URL to request for tracking purposes when user clicks on the video</xs:documentation>
+				</xs:annotation>
+				<xs:complexType>
+					<xs:simpleContent>
+						<xs:extension base="xs:anyURI">
+							<xs:attribute name="id" type="xs:string" use="optional"/>
+						</xs:extension>
+					</xs:simpleContent>
+				</xs:complexType>
+			</xs:element>
+			<xs:element name="CustomClick" minOccurs="0" maxOccurs="unbounded">
+				<xs:annotation>
+					<xs:documentation>URLs to request on custom events such as hotspotted video</xs:documentation>
+				</xs:annotation>
+				<xs:complexType>
+					<xs:simpleContent>
+						<xs:extension base="xs:anyURI">
+							<xs:attribute name="id" type="xs:string" use="optional"/>
+						</xs:extension>
+					</xs:simpleContent>
+				</xs:complexType>
+			</xs:element>
+		</xs:sequence>
+	</xs:complexType>
+	<xs:complexType name="Companion_type">
+		<xs:sequence>
+			<xs:choice>
+				<xs:element name="StaticResource" minOccurs="0" maxOccurs="1">
+					<xs:annotation>
+						<xs:documentation>URL to a static file, such as an image or SWF file</xs:documentation>
+					</xs:annotation>
+					<xs:complexType>
+						<xs:simpleContent>
+							<xs:extension base="xs:anyURI">
+								<xs:attribute name="creativeType" type="xs:string" use="required">
+									<xs:annotation>
+										<xs:documentation>Mime type of static resource</xs:documentation>
+									</xs:annotation>
+								</xs:attribute>
+							</xs:extension>
+						</xs:simpleContent>
+					</xs:complexType>
+				</xs:element>
+				<xs:element name="IFrameResource" type="xs:anyURI" minOccurs="0" maxOccurs="1">
+					<xs:annotation>
+						<xs:documentation>URL source for an IFrame to display the companion element</xs:documentation>
+					</xs:annotation>
+				</xs:element>
+				<xs:element name="HTMLResource" type="xs:string" minOccurs="0" maxOccurs="1">
+					<xs:annotation>
+						<xs:documentation>HTML to display the companion element</xs:documentation>
+					</xs:annotation>
+				</xs:element>
+			</xs:choice>
+			<xs:element maxOccurs="1" minOccurs="0" name="TrackingEvents" type="TrackingEvents_type">
+				<xs:annotation>
+					<xs:documentation>The creativeView should always be requested when present. For Companions creativeView is the only supported event.</xs:documentation>
+				</xs:annotation>
+			</xs:element>
+			<xs:element name="CompanionClickThrough" type="xs:anyURI" minOccurs="0" maxOccurs="1">
+				<xs:annotation>
+					<xs:documentation>URL to open as destination page when user clicks on the the companion banner ad.</xs:documentation>
+				</xs:annotation>
+			</xs:element>
+			<xs:element name="AltText" type="xs:string" minOccurs="0" maxOccurs="1">
+				<xs:annotation>
+					<xs:documentation>Alt text to be displayed when companion is rendered in HTML environment.</xs:documentation>
+				</xs:annotation>
+			</xs:element>
+			<xs:element name="AdParameters" type="xs:string" minOccurs="0" maxOccurs="1">
+				<xs:annotation>
+					<xs:documentation>Data to be passed into the companion ads. The apiFramework defines the method to use for communication (e.g. “FlashVar”)</xs:documentation>
+				</xs:annotation>
+			</xs:element>
+		</xs:sequence>
+		<xs:attribute name="id" type="xs:string" use="optional">
+			<xs:annotation>
+				<xs:documentation>Optional identifier</xs:documentation>
+			</xs:annotation>
+		</xs:attribute>
+		<xs:attribute name="width" type="xs:integer" use="required">
+			<xs:annotation>
+				<xs:documentation>Pixel dimensions of companion</xs:documentation>
+			</xs:annotation>
+		</xs:attribute>
+		<xs:attribute name="height" type="xs:integer" use="required">
+			<xs:annotation>
+				<xs:documentation>Pixel dimensions of companion</xs:documentation>
+			</xs:annotation>
+		</xs:attribute>
+		<xs:attribute name="expandedWidth" type="xs:integer" use="optional">
+			<xs:annotation>
+				<xs:documentation>Pixel dimensions of expanding companion ad when in expanded state</xs:documentation>
+			</xs:annotation>
+		</xs:attribute>
+		<xs:attribute name="expandedHeight" type="xs:integer" use="optional">
+			<xs:annotation>
+				<xs:documentation>Pixel dimensions of expanding companion ad when in expanded state</xs:documentation>
+			</xs:annotation>
+		</xs:attribute>
+		<xs:attribute name="apiFramework" type="xs:string" use="optional">
+			<xs:annotation>
+				<xs:documentation>The apiFramework defines the method to use for communication with the companion</xs:documentation>
+			</xs:annotation>
+		</xs:attribute>
+	</xs:complexType>
+	<xs:complexType name="NonLinear_type">
+		<xs:sequence>
+			<xs:choice>
+				<xs:element name="StaticResource" minOccurs="0" maxOccurs="1">
+					<xs:annotation>
+						<xs:documentation>URL to a static file, such as an image or SWF file</xs:documentation>
+					</xs:annotation>
+					<xs:complexType>
+						<xs:simpleContent>
+							<xs:extension base="xs:anyURI">
+								<xs:attribute name="creativeType" type="xs:string" use="required">
+									<xs:annotation>
+										<xs:documentation>Mime type of static resource</xs:documentation>
+									</xs:annotation>
+								</xs:attribute>
+							</xs:extension>
+						</xs:simpleContent>
+					</xs:complexType>
+				</xs:element>
+				<xs:element name="IFrameResource" type="xs:anyURI" minOccurs="0" maxOccurs="1">
+					<xs:annotation>
+						<xs:documentation>URL source for an IFrame to display the companion element</xs:documentation>
+					</xs:annotation>
+				</xs:element>
+				<xs:element name="HTMLResource" type="xs:string" minOccurs="0" maxOccurs="1">
+					<xs:annotation>
+						<xs:documentation>HTML to display the companion element</xs:documentation>
+					</xs:annotation>
+				</xs:element>
+			</xs:choice>
+			<xs:element name="NonLinearClickThrough" type="xs:anyURI" minOccurs="0" maxOccurs="1">
+				<xs:annotation>
+					<xs:documentation>URL to open as destination page when user clicks on the the non-linear ad unit.</xs:documentation>
+				</xs:annotation>
+			</xs:element>
+			<xs:element name="AdParameters" type="xs:string" minOccurs="0" maxOccurs="1">
+				<xs:annotation>
+					<xs:documentation>Data to be passed into the video ad. </xs:documentation>
+				</xs:annotation>
+			</xs:element>
+		</xs:sequence>
+		<xs:attribute name="id" type="xs:string" use="optional">
+			<xs:annotation>
+				<xs:documentation>Optional identifier</xs:documentation>
+			</xs:annotation>
+		</xs:attribute>
+		<xs:attribute name="width" type="xs:integer" use="required">
+			<xs:annotation>
+				<xs:documentation>Pixel dimensions of companion</xs:documentation>
+			</xs:annotation>
+		</xs:attribute>
+		<xs:attribute name="height" type="xs:integer" use="required">
+			<xs:annotation>
+				<xs:documentation>Pixel dimensions of companion</xs:documentation>
+			</xs:annotation>
+		</xs:attribute>
+		<xs:attribute name="expandedWidth" type="xs:integer" use="optional">
+			<xs:annotation>
+				<xs:documentation>Pixel dimensions of expanding nonlinear ad when in expanded state</xs:documentation>
+			</xs:annotation>
+		</xs:attribute>
+		<xs:attribute name="expandedHeight" type="xs:integer" use="optional">
+			<xs:annotation>
+				<xs:documentation>Pixel dimensions of expanding nonlinear ad when in expanded state</xs:documentation>
+			</xs:annotation>
+		</xs:attribute>
+		<xs:attribute name="scalable" type="xs:boolean" use="optional">
+			<xs:annotation>
+				<xs:documentation>Whether it is acceptable to scale the image.</xs:documentation>
+			</xs:annotation>
+		</xs:attribute>
+		<xs:attribute name="maintainAspectRatio" type="xs:boolean" use="optional">
+			<xs:annotation>
+				<xs:documentation>Whether the ad must have its aspect ratio maintained when scales</xs:documentation>
+			</xs:annotation>
+		</xs:attribute>
+		<xs:attribute name="minSuggestedDuration" type="xs:time" use="optional">
+			<xs:annotation>
+				<xs:documentation>Suggested duration to display non-linear ad, typically for animation to complete. Expressed in standard time format hh:mm:ss</xs:documentation>
+			</xs:annotation>
+		</xs:attribute>
+		<xs:attribute name="apiFramework" type="xs:string" use="optional">
+			<xs:annotation>
+				<xs:documentation>The apiFramework defines the method to use for communication with the nonlinear element</xs:documentation>
+			</xs:annotation>
+		</xs:attribute>
+	</xs:complexType>
+	<xs:complexType name="AdSystem_type">
+		<xs:simpleContent>
+			<xs:extension base="xs:string">
+				<xs:attribute name="version" type="xs:string" use="optional">
+					<xs:annotation>
+						<xs:documentation>Internal version used by ad system</xs:documentation>
+					</xs:annotation>
+				</xs:attribute>
+			</xs:extension>
+		</xs:simpleContent>
+	</xs:complexType>
+	<xs:complexType name="Impression_type">
+		<xs:simpleContent>
+			<xs:extension base="xs:anyURI">
+				<xs:attribute name="id" type="xs:string" use="optional"/>
+			</xs:extension>
+		</xs:simpleContent>
+	</xs:complexType>
+</xs:schema>