Integrating Ooyala Pulse Ads
Usage Considerations
- Muted autoplay is not supported currently with the Pulse plugin. Autoplay should not be used in combination with ads served using the Pulse plugin.
Enabling the Ooyala Pulse Ad Source for Your Account
Before you can use Ooyala's Pulse ad integration:- Log into the Ooyala Customer Portal.
- Submit a ticket requesting that the Ooyala Pulse ad source be added to your Ooyala account.
Options for Associating Ad Tags with Your Video Assets
Once the Ooyala Pulse ad source is enabled for your account, you can associate Ooyala Pulse ads with your videos using:
- Player Embedded Parameters. Specify embedded parameters at the page level of the player.
- Custom Metadata in Backlot. Specify custom metadata on individual videos with the Backlot UI or API.
- Backlot Ad Sets. Create ad sets with the Backlot UI or API.
These ways of setting parameters complement each other, which means that it is possible to set the same parameter in different locations. Values for parameters are read from their base location first, if present, and then read from any subsequent location where they can be set. In general, parameters set in the player override those set as custom metadata, which in turn override those set in the ad set. For a list of where each parameter can be set and where the base values are located, see Ooyala Pulse Ad Parameters.
Loading the Ooyala Pulse Plugin on the Page
- If you use Backlot to generate your HTML embed code, and you choose the V4 HTML5 Standard Player Embed Code (recommended) option, the Ooyala Pulse plugin is automatically included and should not be explicitly added to the web page where you launch the player. For details, see Configuring Player Embed Settings in Backlot.
- If you choose the V4 HTML5 Player Embed Code (Advanced) option in Backlot, or if you manually create the HTML embed code yourself, you need to add the Ooyala Pulse plugin to your web page so that the Ooyala Pulse plugin loads before the player is created.
- Add the pulse.min.js script to the page where you are loading the
player. You must load this plugin after you load core.min.js.
<script language=“javascript" src="url_where_hosted/pulse.min.js"></script>
- Associate the player with the Ooyala Pulse ad plugin by passing in videoplaza-ads-manager as one of the player parameters during the player creation (OO.Player.create).
- Pass any global parameters. See Configuring Ad Parameters.
Option: Integrate with Ooyala Pulse Using Player Embedded Parameters
Pass Ooyala Pulse ad tags to the Ooyala player using the videoplaza-ads-manager parameter and its child parameters, as described in Ooyala Pulse Ad Parameters.The following example shows how to use Ooyala Pulse page-level parameters with Player V4.
<!DOCTYPE html> <html> <head> <title>Ooyala Pulse Example</title> <!-- V4 JS core is required. Plugins such as skin, discovery and Advertising need to be loaded separately --> <script src="url_where_hosted/core.min.js"></script> <script src="url_where_hosted/other-plugin/discovery_api.min.js"></script> <!-- Change these html5-skin.min.css and html5-skin.js to your local build if necessary --> <script src="url_where_hosted/html5-skin/build/html5-skin.min.js"></script> <link rel="stylesheet" href="url_where_hosted/html5-skin.min.css"/> <!-- A Video Plugin is required. This example shows the Main Video Plugin --> <script src="url_where_hosted/video-plugin/main_html5.min.js"></script> <!-- Ad module --> <script src="url_where_hosted/pulse.min.js"></script> </head> <body> <div id="container" style="width:640px; height:360px;"></div> <script> var playerParam = { "pcode": "YOUR_PCODE", "playerBrandingId": "YOUR_PLAYER_ID", "skin": { // Config contains the configuration setting for player skin. Change to your local config when necessary. "config": "url_where_hosted/skin.json" }, "videoplaza-ads-manager":{ // Pulse settings "pulse_host": "//pulse-host.videoplaza.tv", "pulse_device_container": "deviceContainer", "pulse_persistend_id": "persistendId", // Values mapped to the request settings "pulse_height": 640, "pulse_width": 360, "pulse_max_bitrate": 400, "pulse_linear_cuepoints": "5,23,34", "pulse_non_linear_cuepoints": "12,14,50", "pulse_insertion_point_filter": "onBeforeContent,playbackPosition", "pulse_referrer_url": "//www.ooyala.com", "pulse_linear_slot_size": 3, "pulse_max_linear_break_duration": 20, // Values mapped to the content metadata "pulse_category": "myCategory", "pulse_content_form": "longForm", //Can be 'longForm' or 'shortForm' "pulse_content_id": "myCustomId", "pulse_content_partner": "myContentPartner", "pulse_duration": 52, // The flags will be merged with the ones coming from the Backlot Ad Set, if any. // If you want to override them completely, set pulse_override_metadata to true. "pulse_flags": "flag1,flag2", // The tags will be merged with the ones coming from the Backlot Ad Set, if any. // If you want to override them completely, set pulse_override_metadata to true. "pulse_tags": "tag1,tag2", "pulse_custom_parameters": { "key1": value1, "key2": value2 }, // Integration settings "pulse_override_metadata": true, // If set, all the Backlot metadata (ad set or custom) will be ignored. "pulse_show_ad_title": false } }; OO.ready(function() { window.pp = OO.Player.create("container", "YOUR_ASSET_ID", playerParam); }); </script> </body> </html>
Option: Integrate with Ooyala Pulse through Backlot Custom Metadata
- Backlot UI: For instructions on how to set custom metadata on an asset using the Backlot UI, see Adding Custom Metadata.
- Backlot API: For instructions on how to set custome metadata on an asset using the Backlot API, see Custom Metadata.
Option: Integrate with Ooyala Pulse through Backlot Ad Sets
- Create an Ooyala Pulse ad set using:
- Backlot UI: To create an ad set using the Backlot UI, see Creating Ad Sets for Integrating with Ad Sources.
- Backlot API: To create an ad set programmatically, see Ad Sets. For the Ad Source, select the Videoplaza Module.
The required ad set field for creating an Ooyala Pulse ad set is:
vpDomain: The host for your Ooyala Pulse account, which is derived from the "sub-domain" found in the Pulse UI. Here is how it is formulated:
//[sub-domain].videoplaza.tv
- Assign an ad set to an asset or multiple assets using:
- Backlot UI: For instructions on how to assign your Ooyala Pulse ad set to
- a single asset, see Managing Monetization
- multiple assets, see Bulk Applying Settings
- Player API: With the Player API, you can only associate an ad set with an asset on your web page. To associate an ad set with an asset on multiple players you must replicate the code for each player. To associate an ad set with an asset using the Player API, see Assigning Ad Sets Dynamically.
- Backlot API: With the Backlot API, you can associate an ad set with an asset more concretely. When you associate an asset with an ad set using the Backlot API, the asset and the ad set will be paired together on any player and page on which you play the asset. For details, see Associate Ad Set with Asset.
- Backlot UI: For instructions on how to assign your Ooyala Pulse ad set to