Insertion Policies Interface Overview

Note: If you are using only the old Ad Insertion Policy feature, please refer to Insertion Policies and Ad Insertion Policies.

When you open Insertion Policies from the menu Insertion policy access, you see the following:

Insertion policy interface

Parts of Insertion Policies

Part Name Description
1 New insertion policy Create new insertion policy button. By default, you can create a maximum of 50 insertion policies for your Pulse account. Contact your Account Manager if you need to change this value. For more information, refer to Create Insertion Policy.
2 Insertion policy rank Number showing the insertion policy rank. When you hover over an insertion policy, an arrow appears instead of a number. Click on the arrow to move the insertion policy higher up.
Note: Currently, you can only move insertion policy up, not down.

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. Pulse looks at all insertion policies from top to bottom and picks the first one whose specified targeting matches the parameters sent in the ad request. It looks at the parent categories as well, so that all sub-categories of the categories specified in the insertion policy are considered matched. For more information, see Insertion Policy Targeting and Ranking below.

3 Insertion policy name Name of the insertion policy. Click here to open an insertion policy, view, and edit any of its settings. Click "Save" next to each modified field to save your changes.
4 Spot ad settings overview An overview of pre-roll, mid-roll, post-roll, and seek-roll settings, if there are any. To view all insertion policy settings, open the insertion policy by clicking on its name.

Insertion Policy Targeting and Ranking

Note: Insertion policies without any specified targeting are currently not taken into consideration by the Pulse Distribution Engine.

For an insertion policy to get selected, its specified targeting needs to match the parameters sent in the ad request, which means:

  • Only tag targeting specified: selected when it matches at least one value in the t parameter sent in the ad request.
  • Only category targeting specified: selected when it matches the category value in the s parameter sent in the ad request. Pulse looks at the parent categories as well, so that all sub-categories of the categories specified in the insertion policy are considered matched.
  • Both tag and category targeting specified: selected only when it matches the s parameter and at least one value in the t parameter sent in the ad request. Pulse looks at the parent categories as well, so that all sub-categories of the categories specified in the insertion policy are considered matched.
Note: If there is an insertion policy targeting a category whose category alias matches the unique ID of another category targeted in a different insertion policy, Pulse randomly selects the insertion policy (not based on rank) when that share is sent in the ad request.

Example Category Structure

For example, your account category structure looks as follows:

  • My Account (root category)
    • Sport (alias: sport)
      • Football (alias: football)
      • Basketball (alias: basketball)
      • Hockey (alias: hockey)
      • ...
    • News (alias: news)
    • TV Shows (unique ID: 123abc-456def-789g-0000)
      • Reality Shows (alias: reality_shows)
      • Kids Shows (alias: kids_show)
      • XY (alias: 123abc-456def-789g-0000)
        • XY Season 1
        • XY Season 2
        • XY Season 3
        • XY Season 4
        • XY Season 5
      • ...

Example Targeting

  • You want to have the same high ad load for each last episode of the five XY seasons because you expect more traffic. Instead of creating five additional sub-categories and configuring identical insertion policies for each of the five sub-categories, you can now create one insertion policy and target it against the tag season_finale, provided there is a matching tag coming from your player for each of the five episodes.
  • You want to have the same medium ad load specifically for kids watching kids shows. Now you can create one insertion policy and target it against the tag kids and category kids_show, provided there is a matching tag and category coming from your player.

Example Insertion Policies

Rank Name Specified tag targeting Specified category targeting
1 High Ad Load Several tags, including: reality_show Several categories, including: TV Shows, unique ID 123abc-456def-789g-0000
2 Loyal users Several tags, including: loyal_user -
3 TV Show Season Finale Several tags, including: season_finale -
4 Medium Ad Load Several tags, including: kids Several categories, including: Kids Shows, alias kids_show
5 TV Show Season Premiere Several tags, including: tv_show Several categories, including: XY, alias 123abc-456def-789g-0000
6 Sport - Several categories, including: Sport, alias sport

Example Insertion Policy Selection Scenarios

  1. An ad request comes in with t=loyal_user, season_finale&s=american_idol. Both Loyal users and TV Show Season Finale insertion policy match at least one tag coming in the ad request. The Loyal users insertion policy is selected because it is ranked higher.
  2. An ad request comes in with s=sport and no tags. The Sport insertion policy is selected because it matches the category targeting.
  3. An ad request comes in with t=game_finale&s=fotball. No insertion policy matches the parameters sent in the ad request, however the Sport insertion policy is selected because it targets the category Sport, which is the parent category of the Football sub-category.
  4. An ad request comes in with t=season_finale, tv_show, loyal_user&s=123abc-456def-789g-0000.
    1. The Loyal users insertion policy matches at least one tag.
    2. The TV Show Season Finale insertion policy matches at least one tag.
    3. The TV Show Season Premiere insertion policy matches the category and at least one tag.

    The Loyal users insertion policy gets selected because it is ranked highest.

  5. An ad request comes in with t=reality_show, tv_show&s=123abc-456def-789g-0000.
    1. The High Ad Load insertion policy matches the category and at least one tag.
    2. The TV Show Season Premiere insertion policy matches the category and at least one tag.

    Pulse randomly selects an insertion policy (not based on rank) because the unique ID of the TV Shows category targeted in the High Ad Load insertion policy is the same as the category alias of the XY category targeted in the TV Show Season Premiere insertion policy.

Was this article helpful?