Insertion Policy selection

This page explains how the targeting and ranking configured in the new Insertion Policy affect the Pulse decisioning process. If you are using the old category-based Ad Insertion Policy, see Ad Insertion Policy.

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, all of its specified targeting needs to match the parameters sent in the ad request, which means:

  • Only tag targeting specified: selected when it matches the t parameter sent in the ad request.
  • Only category targeting specified: selected when it matches 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 both the t parameter and 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.
By default, insertion policies are ranked in order of creation, with the most recent ones at the bottom (ranked lowest). You can adjust the insertion policy rank by hovering over an insertion policy with rank 2 or lower and clicking the arrow to move the insertion policy higher up.
Note: Currently, you can only move insertion policies up, not down.

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.

The rank of the insertion policy is important when more than one insertion policy matches the tag targeting, category targeting, or both tag and category targeting coming in the ad request, because then the insertion policy with the highest rank gets selected.

When the new insertion policy is selected by Pulse, it overrides the old category-based ad insertion policy.

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_shows)
      • 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 video 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 agains the tag kids and the category kids_show, provided there is a matching tag and category coming from your video player.

Example insertion policies

Rank Name Specified tag targeting Specified category targeting
1 High Ad Load At least one of: several tags, including reality_show Several categories, including: TV Shows, unique ID 123abc-456def-789g-0000
2 Loyal users
  • All of: loyal_user
  • At least one of: loyal_user_female, loyal_user_male
  • None of: violence, kids
-
3 TV Show Season Finale At least one of: several tags, including season_finale -
4 Medium Ad Load
  • All of: kids
  • None of: violence
Several categories, including: Kids Shows, alias kids_shows
5 TV Show Season Premiere At least one of: 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,loyal_user_female,season_finale&s=american_idol. Both Loyal users and TV Show Season Finale insertion policy match the tag targeting coming in the ad request. Loyal users insertion policy is selected because it is ranked higher.
  2. An ad request comes in with s=sport and no tags. Sport insertion policy is selected because it matches the category targeting.
  3. An ad request comes in with t=game_finale&s=football. No insertion policy matches the parameters sent in the ad request, however 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,loyal_user_male&s=123abc-456def-789g-0000.
    1. Loyal users insertion policy matches the tag targeting.
    2. TV Show Season Finale insertion policy matches at least one tag.
    3. TV Show Season Premiere insertion policy matches the category and at least one tag.

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

  5. An ad request comes in with t=violence&s=kids_shows. The Medium Ad Load insertion policy matches the category targeting, however it is not selected because the tag violence is included in the ad request. No other insertion policy matches any of the targeting, so the old category-based ad insertion policy for the Kids Shows category acts as the default.
  6. 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.