Media File Targeting is now available in SpringServe by turning on the Media File Targeting beta feature. With this feature, clients have the ability to include/exclude demand sources from eligible supply, based on attributes of the media file in the VAST response, specifically Duration, Mime Type and Bitrate. As an example, if a supply source wants to ensure that only media files with the .mp4 extensions, that have a bit rate between 1200 kilo bytes and 4000 kilobytes, and that are less than 20 seconds in duration play on their supply, this can be achieved by using media file targeting and the behavior of this feature is listed in detail below.
With this feature, you will find a new section on the targeting tab of applicable Supply and Demand Tags called Media File Targeting. This feature works on all Managed and Connected Supply & Demand Tags with the following exceptions:
This feature is highlighted in the screenshot below with the default selections for each targeting parameter.
This section details the behavior of each targeting parameter in MediaFile Targeting.
The default selection for Duration Targeting is All. By selecting Custom, three options become available for Minimum Duration, Maximum Duration and a checkbox to Block Unknown Durations.
Based on the selections in the screenshot above, we will show media files that have a duration between and including 12 seconds and 48 seconds. Additionally, because the "Block Unknown Durations" Checkbox is selected, we will also exclude all media files from vast responses that don't have a duration specified.
The default selection for Mime Type Targeting is All. By selecting Custom, users have the option to choose specific mime types along with a checkbox to Block Unknown Durations. This is highlighted in the screenshot below
Based on the selections made above, for example, Media Files with Mime Types mpeg and webm will pass this targeting check. Additionally, because the "Block Unknown Mime Types" Checkbox is not checked, if there are any Vast responses that include Media Files with unspecified Mime Types, these will pass targeting as well.
The default selection for Bitrate Targeting is All. By selecting Custom, three options become available for Minimum Bitrate, Maximum Bitrate and a checkbox to Block Unknown Bitrates.
Please note that the units for Minimum and Maximum Bitrate selections are in Kilobytes per the IAB Vast spec. For the screenshot above, based on the selections made we will show media files that have Bitrates between zero and including 1500 kbs. Additionally, because the "Block Unknown Bitrates" Checkbox is selected, we will also exclude all media files from vast responses that don't have a Bitrate specified.
For Duration and Bitrate Targeting, please note that if you leave Min Duration and Min Bitrate empty, our ad server treats that selection like it has a value of zero seconds and zero kilobytes respectively.
Additionally, under managed and connected demand tags, you will find that for each of these parameters, hovering over the Custom button will display a pop over message with the text "Applies to VAST Only Supply" as highlighted in the screenshot below.
It is important to note a few things about how this is handled in SpringServe's AdServer. The first thing to note is that because both Supply and Demand Tags are eligible for Media File Targeting, if Media File Targeting is applied to both Supply and Demand Tags, then this targeting is applied on each applicable tag in each applicable link of the call chain. Secondly, because of the way the VAST spec works, the three Media File Targeting attributes are applied a bit differently to the VAST responses. As a rule of thumb:
The 2 screenshots below are of a sample VAST response from a demand source that returns a Pod with 3 slots. For the sake of brevity, the first screenshot shows the last two ad slots collapsed with the focus being emphasized on the first ad slot and the second shows the first and third slots collapsed with a focus on the second ad slot.
Here is the first screenshot
And here is the second screenshot:
As you can see in the 2 screenshots above, the Duration Attribute applies to All media files in the <Ad> attribute of the VAST response whereas the Bitrate and Mime Type which is called as type in the <MediaFile> Attribute of the VAST response apply to individual media files.
To troubleshoot errors in reporting, you can run a Vast Error Code Report with the appropriate supply and demand tags as filters and find error metrics specific to Media File Targeting, namely:
You can find additional information on Vast Error Codes at this link.