Welcome to Video Advertising Documentation
Optimise your ad revenue and make the most of your growing audience with the Pulse Products. The Pulse ad management and programmatic trading tools are designed specifically to help broadcasters and publishers run their video ad businesses. For an overview, see Video Advertising Overview and Pulse Video Advertising Platform.
Break Number in Pulse SDKs
From version 220.127.116.11.0 for HTML5, version 18.104.22.168.0 for Android, and version 22.214.171.124.0 for iOS, the Pulse SDKs contain a break number parameter in the request settings object. This parameter enables you to override the number of the ad break targeted by the ad request, in order to request ads for a specific ad break. Read more in this release note.
Goal and Ad Format Performance Available in Performance Metrics Explorer
It is now possible to view the performance metrics and time series graphs either only for the campaigns you filtered on (default) or also include their goals OR their format types. This provides you with a quick and simple way to retrieve and share near-real time or historical performance metrics from specific campaigns, their goals, and ad format types, and the ability to monitor and visualise the progress of active campaigns, their goals, and ad format types. Read more in these release notes: 2019-07-15 Release and 2019-07-19 Release.
We have developed a sample Cast Application Framework (CAF) Receiver Application, based on Google's CAF Receiver API and support of the IAB VMAP standard, which you can use to create your own receiver application that can provide the ads metadata and request VMAP ads from Pulse to be served on a Chromecast device. The sample application and all its documentation can be found on GitHub: Cast Application Framework (CAF) Receiver Application. Read more in this release note.
New Parameter for Break Number in VAST and VMAP
A new parameter,
bn, is available for direct VAST and VMAP
integrations to help you identify and override the number of the ad break targeted
by the ad request, in order to request ads for a specific ad break. Read more in
Campaign, Goal and Ad Filtering Parameters.
Target Any Break
It is now possible to target a goal to one or more linear ad breaks by setting a break restriction rule when adding both normal and sponsor goals through the Pulse user interface. This allows you to show certain types of ads in specific ad breaks and provides greater control of your ad serving. For example, setting break restriction to break numbers 2 and 3 means that ads from that goal can only be shown in the second and third ad break. Support for break restriction has been added in the Goal REST API, which means you can target specific break numbers through the https://api.videoplaza.com/api/1.0.cpvext/goal set of endpoints. Read more in these release notes: 2019-04-26 Release and 2019-07-11 Release.
VideoJS v7.x and Brightcove Player v6.x HTML5 Plugin
A new plugin is available to integrate your VideoJS v7.x and Brightcove Player version 6.x with Pulse for ad serving. The plugin and all its documentation can be found on GitHub: Pulse Plugin for VideoJS and Brightcove Player. Read more in this release note.
Daily and Hourly Impression and Event Caps
- Daily and hourly impression caps: to limit the daily and hourly amount of impressions delivered for certain goals.
- Daily and hourly event (% ad completion and click through) caps: to limit the daily and hourly amount of events delivered for 25%, 50%, 75%, and 100% ad completion, or click through goals.
Currently, in Pulse, you can set the following impression and event caps, and combine them where applicable:
|Cap Type||Impressions (normal and sponsor)||Share of Voice (normal and sponsor)||Unlimited impressions||Priority unreserved||25%, 50%, 75%, or 100% Ad completion||Click throughs|
|Total Impression Cap||X||X||X|
|Daily Impression Cap||X||X||X||X|
|Hourly Impression Cap||X||X||X||X|
|Daily Event Cap||X||X|
|Hourly Event Cap||X||X|
This provides you with more control around delivery pacing and distribution during the entire goal period, and reduces the amount of manual work previously needed to achieve this. Using daily and/or hourly caps means that the goal's daily and/or hourly delivery should not exceed the cap, but there is no guarantee it will reach the cap, especially in case of traffic pattern changes. For more information, refer to Daily and Hourly Goal Caps vs Pulse Dynamic Design.
Support for caps has also been added in the Goal REST API, which means you can handle all available impression and event caps through the https://api.videoplaza.com/api/1.0.cpvext/goal set of endpoints. Read more in these release notes: 2019-02-14 Release and 2019-03-08 Release.
Where to Find What
- Pulse User Guide for Pulse administrators, ad operations, traffic managers and sales and product managers
- Developer Guides for developing and validating integrations between
your player and Pulse for ad serving:
- Mandatory Validation Importance and Process for all integrations
- Plugins for several video players
- Pulse SDKs (high level SDKs) for HTML5, Android, iOS and tvOS
- Pulse Integration Toolkit (low level SDKs) for HTML5, Android (deprecated) and iOS (deprecated)
- VAST and VMAP for VAST and VMAP integrations
- Chromecast for integrating Pulse ad delivery with Chromecast using VMAP
- SDK reference documentation (both Pulse and Core SDKs)
- Sample integrations and documentation
- Developer Guides for accessing and handling data in Pulse:
- Pulse REST API guides and examples
- Pulse REST API references:
- Knowledge Base Articles
- Pulse FAQ
- Pulse Video Advertising Release Notes for up-to-date information about the Pulse products
- Pulse Help Desk: use the Technical Support portal to report problems, ask Pulse related questions, request account configuration changes, or suggest a feature request. See Pulse Help Desk User Guide for more information.
- Pulse Statuspage: subscribe to receive Pulse incidents and maintenance notifications.