VAST Integration

How to integrate Ooyala Pulse ad delivery with your video player by creating direct VAST requests.

Supported features and protocols

In Ooyala Pulse, the VAST template is enabled for:
  • standard pre-rolls,
  • standard mid-rolls,
  • standard post-rolls,
  • pause ads,
  • and overlays.

These are the ad formats you can request in a VAST integration.

The supported VAST protocols are:
  • 3.0 (recommended)
  • 2.0

VAST Ad Request

A request for a VAST ticket follows the format of URL?parameter_name=value&parameter_name=value&..., where:
  • URL: http://[subdomain].videoplaza.tv/proxy/distributor/v2, where [subdomain] is the sub domain of your Ooyala Pulse account and can be found under Account Settings>Integration Information of the Settings tab.
  • parameter_name=value: a list of the parameter and value pairs, separated from each other with ampersands (&), defining the characteristics and filters for the ads in the VAST ticket. For a list of all possible parameters, their descriptions and possible values, see VAST and VMAP Parameters

Example Request

The following URL requests a VAST ticket containing prerolls which can be served for:
  • the vast-example tag,
  • the category_id1 category,
  • and the content_partner_id1 content partner.

http://se-showroom.videoplaza.tv/proxy/distributor/v2?tt=p&t=vast-example&f=&s=category_id1,content_partner_id1&rnd=8170019078998&rt=vast_2.0

VAST response ticket

Sample of an inline VAST response:

<VAST version="2.0" xsi:noNamespaceSchemaLocation="http://service.videoplaza.com/schema/iab/vast-2.0.xsd">
    <Ad id="b16b5cd5-7133-4057-b58d-6dda5849afb4">
        <InLine>
            <AdSystem>Videoplaza Monetizer</AdSystem>
            <AdTitle>The VAST preroll</AdTitle>
            <Impression>
                http://se-showroom.videoplaza.tv/proxy/tracker?sid=e8847228-0a6c-4715-bc71-b1a709c2e2ee&a=b16b5cd5-7133-4057-b58d-6dda5849afb4&e=0&t=3&tags=vast&shares=share_id_1&tid=14351fb3-01b3-4898-96bf-ab332ca2f0bd&pid=87a0a41c-4929-43ec-b2d8-6095f53e6324&rnd=-948245680
            </Impression>
            <Impression>http://example.com/123.gif?rnd=1302863942011</Impression>
            <Creatives>
                <Creative>
                    <Linear>
                        <Duration>00:00:30</Duration>
                        <TrackingEvents>
                            <Tracking event="start">
                                http://se-showroom.videoplaza.tv/proxy/tracker?sid=e8847228-0a6c-4715-bc71-b1a709c2e2ee&a=b16b5cd5-7133-4057-b58d-6dda5849afb4&e=14&t=3&tags=vast&shares=share_id_1&tid=14351fb3-01b3-4898-96bf-ab332ca2f0bd&pid=87a0a41c-4929-43ec-b2d8-6095f53e6324&rnd=-948245680
                            </Tracking>
                            <Tracking event="firstQuartile">
                                http://se-showroom.videoplaza.tv/proxy/tracker?sid=e8847228-0a6c-4715-bc71-b1a709c2e2ee&a=b16b5cd5-7133-4057-b58d-6dda5849afb4&e=15&t=3&tags=vast&shares=share_id_1&tid=14351fb3-01b3-4898-96bf-ab332ca2f0bd&pid=87a0a41c-4929-43ec-b2d8-6095f53e6324&rnd=-948245680
                            </Tracking>
                            <Tracking event="midpoint">
                                http://se-showroom.videoplaza.tv/proxy/tracker?sid=e8847228-0a6c-4715-bc71-b1a709c2e2ee&a=b16b5cd5-7133-4057-b58d-6dda5849afb4&e=16&t=3&tags=vast&shares=share_id_1&tid=14351fb3-01b3-4898-96bf-ab332ca2f0bd&pid=87a0a41c-4929-43ec-b2d8-6095f53e6324&rnd=-948245680
                            </Tracking>
                            <Tracking event="thirdQuartile">
                                http://se-showroom.videoplaza.tv/proxy/tracker?sid=e8847228-0a6c-4715-bc71-b1a709c2e2ee&a=b16b5cd5-7133-4057-b58d-6dda5849afb4&e=17&t=3&tags=vast&shares=share_id_1&tid=14351fb3-01b3-4898-96bf-ab332ca2f0bd&pid=87a0a41c-4929-43ec-b2d8-6095f53e6324&rnd=-948245680
                            </Tracking>
                            <Tracking event="complete">
                                http://se-showroom.videoplaza.tv/proxy/tracker?sid=e8847228-0a6c-4715-bc71-b1a709c2e2ee&a=b16b5cd5-7133-4057-b58d-6dda5849afb4&e=18&t=3&tags=vast&shares=share_id_1&tid=14351fb3-01b3-4898-96bf-ab332ca2f0bd&pid=87a0a41c-4929-43ec-b2d8-6095f53e6324&rnd=-948245680
                            </Tracking>
                        </TrackingEvents>
                        <VideoClicks>
                            <ClickThrough>
                                http://se-showroom.videoplaza.tv/proxy/tracker?sid=e8847228-0a6c-4715-bc71-b1a709c2e2ee&a=b16b5cd5-7133-4057-b58d-6dda5849afb4&e=20&t=3&tags=vast&shares=share_id_1&tid=14351fb3-01b3-4898-96bf-ab332ca2f0bd&pid=87a0a41c-4929-43ec-b2d8-6095f53e6324&rnd=-948245680&redirect=http%3A%2F%2Fwww.videoplaza.com%2Fdev-corner
                            </ClickThrough>
                        </VideoClicks>
                        <MediaFiles>
                            <MediaFile bitrate="434" delivery="progressive" height="270" scalable="true" type="video/x-flv" width="480">
                                http://se-showroom.cdn.videoplaza.tv/creatives/5524066b-7dfe-40f1-8a26-2e168286c77b.flv
                            </MediaFile>
                            <MediaFile bitrate="434" delivery="progressive" height="270" scalable="true" type="video/x-flv" width="480">
                                http://se-showroom.cdn.videoplaza.tv/creatives/f70029fa-a2fe-4b4b-8214-09af0484e331.flv
                            </MediaFile>
                        </MediaFiles>
                    </Linear>
                </Creative>
                <Creative>
                    <CompanionAds>
                        <Companion id="7703a45c-a9cf-4e6c-b982-ed5d2142b49a" height="250" width="300">
                            <HTMLResource>
                                <a href="http://se-showroom.videoplaza.tv/proxy/tracker?sid=e8847228-0a6c-4715-bc71-b1a709c2e2ee&a=7703a45c-a9cf-4e6c-b982-ed5d2142b49a&e=92&t=5&tags=vast&shares=share_id_1&tid=14351fb3-01b3-4898-96bf-ab332ca2f0bd&pid=87a0a41c-4929-43ec-b2d8-6095f53e6324&rnd=1383858707&redirect=http%3A%2F%2Fwww.videoplaza.com" target="_blank" alt=""><img src="http://se-showroom.cdn.videoplaza.tv/creatives/8d7161c8-6e1b-487d-834a-9248cc14b912.jpg" width="300" height="250" border="0" /></a><img src='http://se-showroom.videoplaza.tv/proxy/tracker?sid=e8847228-0a6c-4715-bc71-b1a709c2e2ee&a=7703a45c-a9cf-4e6c-b982-ed5d2142b49a&e=90&t=5&tags=vast&shares=share_id_1&tid=14351fb3-01b3-4898-96bf-ab332ca2f0bd&pid=87a0a41c-4929-43ec-b2d8-6095f53e6324&rnd=1383858707'/>
                            </HTMLResource>
                        </Companion>
                    </CompanionAds>
                </Creative>
            </Creatives>
            <Extensions>
                <Extension type="CustomTracking" name="Videoplaza Custom Ids"/>
            </Extensions>
        </InLine>
    </Ad>
</VAST>

Sample of VAST wrapper response:

<VAST version="2.0" xsi:noNamespaceSchemaLocation="http://service.videoplaza.com/schema/iab/vast-2.0.xsd">
    <Ad id="2b582fcb-ef46-4978-be87-3b6ed34777e5">
        <Wrapper>
            <AdSystem>Videoplaza Monetizer</AdSystem>
            <VASTAdTagURI>http://agency.com/campaign-vast.xml</VASTAdTagURI>
            <Impression>
                http://vp-demo-jf.videoplaza.tv/proxy/tracker?sid=a5b895ef-941f-44d3-9ecc-4e1a9ef496b4&a=2b582fcb-ef46-4978-be87-3b6ed34777e5&e=0&t=3&tags=vasten&shares=&tid=375301a0-6c30-4e6d-b13f-94bf5c57c8ad&pid=27652101-0cd2-4903-bde3-de197f575866&rnd=1018724390
            </Impression>
            <Creatives>
                <Creative id="2b582fcb-ef46-4978-be87-3b6ed34777e5">
                    <Linear>
                        <TrackingEvents>
                            <Tracking event="start">
                                http://vp-demo-jf.videoplaza.tv/proxy/tracker?sid=a5b895ef-941f-44d3-9ecc-4e1a9ef496b4&a=2b582fcb-ef46-4978-be87-3b6ed34777e5&e=14&t=3&tags=vasten&shares=&tid=375301a0-6c30-4e6d-b13f-94bf5c57c8ad&pid=27652101-0cd2-4903-bde3-de197f575866&rnd=1018724390
                            </Tracking>
                            <Tracking event="firstQuartile">
                                http://vp-demo-jf.videoplaza.tv/proxy/tracker?sid=a5b895ef-941f-44d3-9ecc-4e1a9ef496b4&a=2b582fcb-ef46-4978-be87-3b6ed34777e5&e=15&t=3&tags=vasten&shares=&tid=375301a0-6c30-4e6d-b13f-94bf5c57c8ad&pid=27652101-0cd2-4903-bde3-de197f575866&rnd=1018724390
                            </Tracking>
                            <Tracking event="midpoint">
                                http://vp-demo-jf.videoplaza.tv/proxy/tracker?sid=a5b895ef-941f-44d3-9ecc-4e1a9ef496b4&a=2b582fcb-ef46-4978-be87-3b6ed34777e5&e=16&t=3&tags=vasten&shares=&tid=375301a0-6c30-4e6d-b13f-94bf5c57c8ad&pid=27652101-0cd2-4903-bde3-de197f575866&rnd=1018724390
                            </Tracking>
                            <Tracking event="thirdQuartile">
                                http://vp-demo-jf.videoplaza.tv/proxy/tracker?sid=a5b895ef-941f-44d3-9ecc-4e1a9ef496b4&a=2b582fcb-ef46-4978-be87-3b6ed34777e5&e=17&t=3&tags=vasten&shares=&tid=375301a0-6c30-4e6d-b13f-94bf5c57c8ad&pid=27652101-0cd2-4903-bde3-de197f575866&rnd=1018724390
                            </Tracking>
                            <Tracking event="complete">
                                http://vp-demo-jf.videoplaza.tv/proxy/tracker?sid=a5b895ef-941f-44d3-9ecc-4e1a9ef496b4&a=2b582fcb-ef46-4978-be87-3b6ed34777e5&e=18&t=3&tags=vasten&shares=&tid=375301a0-6c30-4e6d-b13f-94bf5c57c8ad&pid=27652101-0cd2-4903-bde3-de197f575866&rnd=1018724390
                            </Tracking>
                        </TrackingEvents>
                        <VideoClicks>
                            <ClickTracking>
                                http://vp-demo-jf.videoplaza.tv/proxy/tracker?sid=a5b895ef-941f-44d3-9ecc-4e1a9ef496b4&a=2b582fcb-ef46-4978-be87-3b6ed34777e5&e=20&t=3&tags=vasten&shares=&tid=375301a0-6c30-4e6d-b13f-94bf5c57c8ad&pid=27652101-0cd2-4903-bde3-de197f575866&rnd=1018724390
                            </ClickTracking>
                        </VideoClicks>
                    </Linear>
                </Creative>
            </Creatives>
            <Extensions>
                <Extension type="CustomTracking" name="Videoplaza Custom Ids"/>
            </Extensions>
        </Wrapper>
    </Ad>
</VAST>

Was this article helpful?