2019-03-08 Release

Ability to set daily and hourly event (% ad completion or click through) and impression caps on certain goals, both through the Pulse UI and Goal API, and Content ID available as filter in Custom Reporting UI.

Daily and Hourly Event and Impression Caps in the Pulse User Interface

Note: Daily and hourly impression caps and daily and hourly event caps need to be enabled for your account. Contact your Account Manager if you want to use these features.
We have further extended the goal delivery capping functionality to allow for:
  • Daily and hourly event caps on 25%, 50%, 75%, and 100% ad completion goals: to limit the daily and hourly amount of 25%, 50%, 75%, or 100% ad completions delivered for these goals.
  • Daily and hourly event caps on click through goals: to limit the daily and hourly amount of click throughs delivered for these goals.
  • Daily and hourly impression caps on priority unreserved and unlimited impression goals: to limit the daily and hourly amount of impressions delivered for these goals.

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. However, this approach is static, as opposed to Pulse's dynamic design, and implies there is a 100% certainty you are going to have enough inventory to deliver on the cap. For things to keep in mind, refer to Daily and Hourly Goal Caps vs Pulse Dynamic Design.

To set the different impression and/or event caps, open the Add new goal page, select the desired delivery goal type, check the desired and applicable cap type, and enter a number to limit the daily and/or hourly delivery. For example:

Daily and hourly event cap

The configured caps are displayed in the Goal overview within the Impression caps and/or Event caps field in the following order: Total/Daily/Hourly, as applicable based on goal and cap type. For goals that do not support the impression or event caps, you see 'N/A'.

You can also set the daily and hourly impression and/or event cap for an existing goal by double-clicking the Goal field in the Campaign Goals list. This opens the Edit goal target window where you can define the applicable caps.

Edit and view configured impression and/or event caps

Daily and Hourly Event and Impression Caps in the Goal REST API

Note: Daily and hourly impression caps and daily and hourly event caps need to be enabled for your account. Contact your Account Manager if you want to use these features.

Support for daily and hourly event caps on % ad completion and click through goals, and daily and hourly impression caps on priority unreserved and unlimited impression goals has been added in the Goal REST API, which means you can handle all available caps through the https://api.videoplaza.com/api/1.0.cpvext/goal set of endpoints.

Pass in the following (optional) parameters in the request body:

<caps> 
    <cap>
        <type>totalCap|dailyCap|hourlyCap|dailyEventCap|hourlyEventCap</type>
        <value>number</value>
    </cap>
</caps>
You can combine the different impression and event (% ad completion or click through) caps where applicable. The valid cap types for different goals are:
  • totalCap: total impression cap, available for SHARE_OF_VOICE, FIRST_QUARTILE, SECOND_QUARTILE, THIRD_QUARTILE, COMPLETE, and CLICK_THROUGH goals
  • dailyCap: daily impression cap, available for IMPRESSION, SHARE_OF_VOICE, UNLIMITED_IMPRESSION, and RTB goals
  • hourlyCap: hourly impression cap, available for IMPRESSION, SHARE_OF_VOICE, UNLIMITED_IMPRESSION, and RTB goals
  • dailyEventCap: daily 25%, 50%, 75%, or 100% ad completion or click through cap, available for FIRST_QUARTILE, SECOND_QUARTILE, THIRD_QUARTILE, COMPLETE, and CLICK_THROUGH goals
  • hourlyEventCap: hourly 25%, 50%, 75%, or 100% ad completion or click through cap, available for FIRST_QUARTILE, SECOND_QUARTILE, THIRD_QUARTILE, COMPLETE, and CLICK_THROUGH goals

Content ID Available as Filter in Custom Reporting User Interface

Previously, content ID was available as a filter only in the Custom Reporting REST API. Now, it is also available as a filter in the Custom Reporting user interface.

Content IDs are available for reporting in Pulse from March 7, 2018, if you are sending this information to Pulse in your integration(s) through:

  • the content ID parameter in the content metadata object, when using the Pulse SDKs, HTML5 Ad Player or HTML5 Pulse SDK derived plugins, or
  • the content ID parameter, when using direct VAST or VMAP requests.

Documentation Releases

This release includes the following documentation updates: