Line Item Settings

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.

Any ad technologies, either ad server or programmatic platforms can easily be integrated with the player in our UI. The various options for line items are explained below.

Creating your Line Items

  • Click the “Line Items” option on the left toolbar
  • Click “Create New Line item”

General options

  • Title: Enter a title to distinguish what the line item will refer to (e.g. Google Ad Manager, Rubicon, Appnexus etc)
  • Code: Will automatically populate in response to your title
  • Timeout: The number of seconds the line item is allowed to respond before the next line item is called. 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.

Creative

  • VAST URL: The VAST ad unit tag from your Ad Server or demand partner will be placed here

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.

  • Device type: Here you can select a device to limit where the campaigns will be delivered.

Behaviour

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.

Commercial behaviour

The setting "Commercial behaviour" can be best understood imagining the player is started off 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 exit screen 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 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.