Ad Integration
Add a VAST Tag to ParOne Account
ParOne can pass in dynamic variables to a VAST tag. You may provide a VAST tag in the Integrations
tab of your organization’s settings in app.parone.com
.
Dynamic VAST Parameters
ParOne supports adding dynamic VAST parameters. These fields will be replaced in the VAST tag call with the appropriate dynamic value.
Field | Value | Description |
---|---|---|
description_url | {mediainfo.description_url} | URL for page description |
content-creator | {mediainfo.content_creator} | ID of the content creator |
content-key | {mediainfo.id} | ID of the content |
tags | {mediainfo.tags} | The tags configured on the content in app.parone.com |
is_livestream | {mediainfo.is_livestream} | Whether the content is a livestream or not |
player-id | {player.playerId} | Value of the player-id attribute |
position | {player.position} | Value of the position attribute |
Custom VAST Parameters
To pass in custom VAST parameters, create a global variable on the page and reference the name of the variable in your templates.
For example, with the tag https://example.com/?custom_param={golfAds.example}
, provide
<script>
window.golfAds = {
example: "value",
}
</script>
This variable must be present on the page before our player initializes. It should not be added dynamically at runtime.
AMP Support for Custom VAST Parameters
Custom variables must be passed via data-param-*
attributes on the AMP tag. Pass in the variable names directly. The previous example would become:
<!-- AMP -->
<amp-video-iframe
data-param-example="value"
data-param-element-type="block-playlist"
layout="responsive"
data-param-hide-all="true"
width="16"
height="9"
src="https://sdk-amp.parone.io/index.html"
data-param-env="prod"
data-param-defaultlang="en-US"
data-param-feed="1-all-system-videos"
></amp-video-iframe>
Ads in Mobile Apps
If you intend to support ad playback in the video, you will need to properly handle users clicking on ads. This can be achieved by intercepting navigation to new URLs by the WebView. See here for an example.