Ad services

With our ad services proposition you can manage all (video) ads that are played through our platform.

Ad units

Ad units are at the base of our platform's ad services and define your inventory. They are the positions where you could show a (video) ad. The times that the player reaches the ad unit (with or without showing an ad) is called inventory.

The connection to the ad system through the VAST URL is managed in line items (more about these later), which you can target to one or more ad units. In our system there are three types of ad units.

By default all the player controls are turned off during commercials. With the options "Show Play/Pause button" and "Show Mute/Unmute button" you can allow these simple controls to be shown. Enter text in "Text Commercial Time Remaining" to show a countdown prefixed by this text. These ad unit settings can be overruled per line item by settings the "Disable controls" option in the line item.

When "Allow skipping" is enabled the user will be able to skip the ad after the specified amount of seconds. You can also alter the text that is displayed during the countdown and the text that is used in the button to skip the ad. Please note that our player respects the DfP setting "skippable" even when the "Allow skipping" setting is disabled in our system.

By default an ad unit code is generated from the title replacing any non-word characters with underscores. This code will be used in the embed tag (for embedding outstream formats) and in our analytics.

In-stream ad units

In-stream ad units define positions before or after media and are always linked to either a playout (all media playback through that playout) or a mediaclip (one on one advertising). In the position overview you can manage all the playouts (and soon mediaclips) which can run instream ads.

The various options for in-stream ad units are explained below.

Playout or mediaclip

Select either a playout or a mediaclip to define where the ad unit will run on. If there are two ad units targeted (one for a playout and one for a media clip), the media clip ad units will overrule the settings of the playout.

Commercial behaviour

The setting "Commercial behaviour" can be best understood imagining the player is started of with a playlist.

  • If you choose "Once per load", only the first clip in the playlist will show a pre-roll commercial. Then, if in the exitscreen a related clip is clicked, a new clip is loaded into the player. Hence, another pre-roll commercial will be shown.
  • If you choose "Once per session", only the first clip in the playlist will show a pre-roll commercial. Subsequent loads of clips or clip lists do not. (until you refresh the page)
  • If you choose "Once per clip", each clip in the playlist will show a pre-roll commercial. Subsequent loads of clips or clip lists will too.

Minimum clip duration

Enter a number in seconds. This allows you to set a minimum duration of the media clip in order for the ad unit to be allowed to run. Example: If you set this to 30 seconds, no ads will run on media clips shorter then 30 seconds.

Out-stream ad units

If the inventory from in-stream ad units is not sufficient or you want to increase your inventory you can make use of our out-stream formats. At the moment we support three different types of outstream formats: The inArticle (or inMenu), the inOverlay and the pre-content. Please refer to our outstream suite for more information about these.

The various options for out-stream ad units are explained below.

In and out view

The in and out view option plays or/and unmutes the video when the video player scrolls into or out of the current view. For example, a player is embedded halfway through an article but is not visible directly when the user arrives on a page. When the user scrolls down to read more of the article, the player comes into view and can start playing.

Force in and outview actions

Some mobile devices, like an iPhone, don't support inline playing of video by default. The configured in and out view actions are disabled by default on those devices. If you are sure you want to enable them, you can do so by enabling the "force in view actions" option. Exceptions are assets encoded using our "image sequence" profile, which can be player inline on an iPhone, and where view actions are not disabled by default.

Also see: https://support.bluebillywig.com/inarticle-ios-webview-guide

Block insecure HTML5 VPAID ads

If this setting is enabled in the line item or the ad unit, it will force ads to run in a secure iFrame disallowing page access using javascript.

Preload line items

This option allows you to start calling all VAST URL's in the line items at the first user interaction in order to enable faster playback once the user arrives at the player position. Without this option enabled the first VAST call will be done when the player is "InView".

Placement option

By default the player will be placed at the position of the script element. With this option you can place the script on the bottom of the page and find the proper place on the page using the "DOM Selector".

Placement DOM selector

The DOM Selector allows you to find an element that will be used by the placement option. This selector uses jQuery and can use anything jQuery can use. See http://api.jquery.com/category/selectors/ for full documentation. The jQuery library is already included in our player.

Examples:

  • #article-identifier p.paragraph (# is used for the id attribute of dom-elements, . (dot) for the classname. p can be used to select all <p> elements.)
  • div.article p:nth-child(4), div.article p:last (This will select the 4th <p> element within a <div class=”article”> element, and the last <p> element found within the <div class=”article”> element. When used with the Placement option afterSelector/first element the player will be placed after the first element found, so if there are less then 4 <p> elements found, it will be placed after the last <p> element.)

Attempt iFrame breakout

When the adunit is placed by another adsystem that places it within a friendly iFrame, this option will allow the player to break out of that iFrame in order to do proper "InView" calculations.1

Add (css) clear:both to player wrapper

Add the css style 'clear:both' to the player wrapper. Useful for situations in which our player can not detect the correct width to use.

Custom javascript code

It's possible to add custom javascript code that will be executed when the player is placed. You can use the references $$api (the player API) and $$wrapper (the player wrapper element) in your code. This option is not enabled by default. Contact support for more information.

Passback javascript code

Works similar to the custom javascript code, but will be executed only once all ads finished playing or no ad was found. You can use the references $$adPlayed (is true when an ad was played or false otherwise), $$api (the player API) and $$wrapper (the player wrapper element) in your code. This option is not enabled by default. Contact support for more information.

Allow Blue Billywig IMA

Allow usage of the Blue Billywig Interactive Media Ads component. This component is used to play inline video on devices which normally disable this like the iPhone. This setting is enabled by default. Please contact support for more information or if you want to alter this setting.

Display ad units

Display ad units are positions within our media player where display ads could be shown. Right now the different display positions are:

  • an overlay position displaying over the bottom of the video of 768x90px
  • a display position in the end screen of the video of 300x250px

Line items

In a line item you make the connection to your ad system through a VAST (Video Ad Serving Template) URL. Multiple line items can be targeted to an ad unit by priority. Each of the line items will be checked for a viable ad to play in our player and the first one that delivers a valid ad will run.

You can run a line item on one or more ad units. Please note that if you change the settings of a line item it will change for each of the ad units it is targeted to.

The various options for line items are explained below.

Timeout

You can set a timeout on the line item which dictates the maximum time the line item gets to start an ad. If it does not deliver within this time the player will move on to the next line item if there is one available, or otherwise the main content.

VAST URL, macro's and custom targeting

Enter the full VAST URL to your ad system. You can use the following macro's which will be replaced by our player:

Macro Explanation Value
[url] The url the player is placed on. If the player is placed in an iFrame and the option "attempt iFrame breakout" is not used, the [url] will be the url of the iFrame. a URL encoded string
[deeplink] The deeplink of the mediaclip (is the same as [url] if not set) a URL encoded string
[timestamp] The timestamp that the VAST request was done. a number
[correlator] Same as [timestamp] a number
[playerwidth] The width of the player in pixels. When responsive sizing is used the width will return the width of the player at the moment of requesting the ad. a number (in pixels)
[playerheight] The width of the player in pixels. When responsive sizing is used the width will return the width of the player at the moment of requesting the ad. a number (in pixels)
[clipTitle] The title of the clip. Only available for in-stream the URL encoded title string
[clipID] The ID of the clip. Only available for in-stream the ID string
[playmode] The playmode selected by the player. Useful for example when using key/value targeting in combination with DfP "html5" or "flash"
[format] The format selected by the player. Almost the same as playmode, but returns another value. Useful in combination with liverail ( LR_FORMAT ). "application/x-shockwave-flash" or "application/javascript"

Furthermore you can add custom parameters to the embed code while embedding the player which will be passed to the VAST URL. By substituting %%<key>%% with the value part of the macro_<key>=<value> embed-code parameter.

An example: If you place %%foo%% in an ad tag url:
https://testsuite.acc.bbvms.com/mediaclip/692.xml?output=vast&targeting=%%foo%%
and book it in your line item, then embedding the player with:
https://testsuite.acc.bbvms.com/p/default/c/213.js?macro_foo=bar
results in the player requesting the VAST URL:
https://testsuite.acc.bbvms.com/mediaclip/692.xml?output=vast&targeting=bar

Conditions

Here you can add conditions that need to be met before the line item will load.

Block insecure HTML5 VPAID ads

If this setting is enabled in the line item or the ad unit, it will force ads to run in a secure iFrame. When disabled, javascript VPAID ads will have access to the page they are running on.

Preferred playmode

The preferred playmode specifies the technique the player should try first to load and display the ad. Mobile devices do not support Flash, while old browsers like IE8 do not support HTML5 video. Some browsers support both techniques. This option specifies which technique is preferred when both are available. If you choose "Force Flash" then the process of loading the ad will only start when the user has Flash enabled.

Another thing to consider is if the ad system you are using supports HTML5/javascript VPAID or only Flash/SWF VPAID. For HTML5 to work there needs to be an mp4 or webm video file (normal VAST) or a javascript VPAID URL available. Please contact your ad provider to ensure you are using the right setting. Keep in mind that Flash is being phased out and browsers are slowing down the use of Flash components, so when possible use HTML5.

Minimum clip duration

Enter a number in seconds. This allows you to set a minimum duration of the media clip in order for the line item to be allowed to run. Example: If you set this to 30 seconds, no ads will run on media clips shorter then 30 seconds. This only applies to line items that are targetted to instream ad units.

Allow skipping

When enabled the user will be able to skip the ad after the specified amount of seconds. You can also alter the text that is displayed during the countdown and the text that is used in the button to skip the ad. Please note that our player respects the DfP setting "skippable" even when the "Allow skipping" setting is disabled in our system.

Disable controls

When using this option you will overrule the ad unit's settings to display controls. This can be useful if you know that the VAST URL that is booked on the line item will return a VPAID player which has it's own controls.