Welcome to Video Advertising Documentation

Optimise your ad revenue and make the most of your growing audience with Ooyala Video Adverstising Products. Ooyala’s 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.

Hot Topics

Revised Ooyala Pulse REST API Developer Guide

In the new REST API developer guide, we have restructured the information in a more meaningful and logical flow to reflect a typical workflow used in the Pulse user interface:

  1. Account Management: set up your Pulse account, which is a must before creating ad campaigns.
  2. Campaign Management: after the account is set up, your ad operators are able to create and manage ad campaigns.
  3. Forecasting: after a two week period of running your campaigns, your sales have data to forecast on your campaigns and inventory, so they are able to compose better sales packages for your advertisers.
  4. Analytics: after running ad campaigns, your accounting team is able to extract reports for reconciliation and your analysts are able to report on trends in your inventory and success rates of your sales packages.

New Insertion Policies UI and API

Insertion Policies in Pulse define the foundation for your ad serving settings, by setting the allowed ad formats, number of linear ads, behaviour of non-linear ads, and so on.

Previously, the insertion policies had to be defined for each combination of category, device container and content play length. In this scenario, you could have many duplicate insertion policies and maintenance of the insertion policies was tedious.

Now, you can create an insertion policy and target it against:
  • Tags: for example, a user group like loyal users. This means the insertion policy can be used on any content, because tags are not necessarily tied to your category tree. The tags specified in the insertion policy need to match at least one tag coming in the ad request to Pulse.
  • Categories: for example, Sport. This means you can control the ad serving down to content level, but through a new user interface and API, providing a simple way to overview, manage, and reuse your insertion policies. One of the categories specified in the insertion policy needs to match the share coming in the ad request to Pulse.
  • Tags and categories: for example, loyal users watching sport. This means you can minutely control the ad serving based on precise combinations of tags and content categories. The tags and categories specified in the insertion policy need to match at least one tag and the share coming in the ad request to Pulse.

    Pulse looks at the parent categories as well, so that all sub-categories of the categories specified in the insertion policy are considered matched.

By using the new insertion policies functionality, you reduce the amount of insertion policies you need to configure across your category tree. You can rank the insertion policies, so when more than one insertion policy matches the tag targeting, category targeting, or both tag and category targeting coming in the ad request, then the insertion policy with the highest rank gets selected and overrides the default ad insertion policy which targets the underlying category. If no insertion policy matches the parameters coming in the ad request, the old category based ad insertion policy acts as the default.

You can also manipulate your insertion policies through the Insertion Policy API.

Custom Reporting

A new reporting tool, called Custom Reporting, is now available in Pulse. This reporting functionality utilises a new framework to allow for much more complex reporting than Insight. Instead of pre aggregating data, reports are scheduled and created on the fly. The result is a big increase in flexibility and range of data with the tradeoff of time to produce the report.

Custom Reporting can be used for:
  • Advanced invoicing and reconciliation reporting.
  • Monthly financial revenue reports.
  • Reports that are too complex to be created within Insight.
  • Historical reporting, not already defined in Insight.
  • Reports with dimensions and filters not supported by Insight.
Typical use cases would be:
  • Getting advanced reports across all sales channels.
  • Reporting on error related events.
  • Combining many dimensions and filters.
  • Reporting where no predefined report definitions exist.

Where to Find What

Find your Video Advertising documentation here:

Watch It

If you are looking for primers on using Ooyala's Video Advertising Products, we have a number of video tutorials with tips, tricks and how-tos. View the video tutorials at Ooyala Training Videos.

Was this article helpful?