2019-02-14 Release

Ability to set different impression caps in the Pulse UI on share of voice and impression goals, and ability to handle the impression caps through the Goal API.

Daily and Hourly Impression Caps on Share of Voice and Impression Goals

Note: This functionality needs to be enabled for your account. Contact your Account Manager if you want to use daily and/or hourly impression caps.

The ability to configure share of voice and impression goals, both normal and sponsor, has been extended. Previously, you could only set total impression caps on share of voice goals and daily impression caps on impression goals. Now, you can also set daily and hourly impression caps on share of voice goals, and hourly impression caps on impression goals, both normal and sponsor. 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 impression 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. 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. Things to keep in mind:
  • If you get less inventory than you needed, you are not going to reach the hourly and/or daily cap, which then leads to wasted inventory.
  • If you get more inventory than you expected, Pulse cannot make use of that extra inventory in a good way.
  • Delivery information is re-evaluated at fixed intervals, currently approximately every 5 minutes. This means that regardless of the cap, if the cap is reached within the update window, some over-delivery will occur during that time.

To set the daily and/or hourly impression cap when creating a new normal mode or sponsor mode share of voice or impression goal, open the Add new goal page and check the Use daily impression cap and/or Use hourly impression cap, and enter a number to limit the daily and/or hourly amount of impressions delivered for that goal.

Daily and hourly impression caps

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

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

Edit impression caps for existing goals and view configured impression caps

Impression Caps Available through the Goal REST API

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

Previously, you could configure impression caps only through the Pulse user interface. Now, support for caps has been added in the Goal REST API, which means you can handle total, daily, and hourly impression 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</type>
        <value>number</value>
    </cap>
</caps>
You can combine the different impression caps where applicable. The valid cap types for different goals are:
  • totalCap: available for SHARE_OF_VOICE, FIRST_QUARTILE, SECOND_QUARTILE, THIRD_QUARTILE, COMPLETE, and CLICK_THROUGH goals
  • dailyCap: available for SHARE_OF_VOICE and IMPRESSION goals
  • hourlyCap: available for SHARE_OF_VOICE and IMPRESSION goals

Documentation Releases

This release includes the following documentation updates: