Set video ad pod position targeting
Overview
Equativ's in-stream video solution supports ad pod position targeting: you can specify, at which position(s) a video ad must be displayed within an ad pod. For instance, you can specify, that the insertion's video ad is displayed on the first, second and last position of the pre-roll ad break.
Available ad pod position targeting features:
- supports any position within the ad pod: first, second, third, etc. as well as last (n), penultimate (n-1) and antepenultimate (n-2)
- works with any in-stream video integration method: plugin, VPAID embedded ad manager, VAST URL; in case of the VAST URL integration method, the targeted player must support the ad pod feature and the "sequence" attributes, as specified in the IAB VAST standard
- works with passback ads; only insertions without any video ad pod position targeting are eligible to be used as passback ads
Setting up ad pod position targeting
Ad pod position targeting is optional. If undefined, the insertion is eligible for delivery on any position within the ad pod.
To set up ad pod position targeting:
- create an in-stream video insertion
- in the General settings section, use the Ad type: In-stream video > Web - App
- in the Placement section, select the format Video - Linear; the format Video - Non Linear does not support ad pod position targeting
- disable the "All types and positions" toogle switch
- enable the Ad break types (Pre-rolls, Mid-rolls, Post-rolls) where you want to apply the ad pod position targeting
- under Ad break position, select one or multiple position(s) in the ad pod; selecting multiple positions means that the insertion is eligible for delivery on all selected positions; for instance, selecting positions 1 and 2 means that the insertion is eligible to deliver on either position 1 or 2
- if needed, enter additional positions (4, 5,...) in the New position field; once you entered a new position, click the "+ Add" button to save it and to add additional positions
- if needed, enable the last (n), penultimate (n-1) and antepenultimate (n-2) positions. Warning: If the mabd parameter (maximum ad break duration, in seconds) is sent in the ad call without the ps parameter (pod size), the targeting of the n, n-1, and n-2 positions is not enforced! For more information about the mabd and ps parameters, see POST Ad API integration: parameter reference and GET Ad API integration.
Only insertions without ad pod position targeting can be used as passback ads.
Examples
The following table provides some examples with the insertions that are/are not eligible to be delivered:
Example | Eligible/not eligible insertions |
---|---|
requested ad pod size: 1 ad (ps=1) |
eligible:
not eligible:
|
requested ad pod size: 2 ads (ps=2) |
eligible for first position:
eligible for second position:
|
requested ad pod size: 5 ads (ps=5); insertion x is targeted to position 5, but only 3 insertions are booked | insertion x will not be delivered — the position 5 does not exist in an ad pod of 3 ads |