Templates

Templates define how the players should look and act.

Next to each name is some basic info and the (far right side) option to edit/duplicate/archive this template.

Add/Edit Template

When you click to add a new template or click to edit an existing one, you are presented with many useful options, most of which optional!

Please remember to click Save / Deploy after you’re done.

Clicking only Save (which is possible only when editing existing templates) saves the changes as draft. The changes won’t be reflected live until you then click Deploy.

Be aware if you only click Save, a red dot will appear next to the relevant template to indicate it’s not deployed live. This will also happen if you choose Preview!

OutStream

Main

1. Name (required) - the name of the template. Tip: use main keywords to know which template to choose when using Player Tags.

2. Description - any note you like to add about this template.

Performance

Left side

If clashed, the following options will give priority to the more strict ones.

For example, an Error Limit of 5 won’t matter if Maximum Waterfall Runs is 4, since the session will stop before having the possibility to reach Error Limit.

1. Vast Retry - number of consecutive waterfall retries.

2. Error Limit - the maximal number of full waterfall runs in a row that do not generate an impression. Once an impression is generated, the counter is reset to 0.

3. Maximum Impressions - limit the amount of impressions per player session.

4. Maximum Waterfall Runs - number of seconds to wait between each waterfall run.

5. Midroll Time - number of seconds to wait between each waterfall run.

Right side

If clashed, the following options will give priority to the less strict ones.

For example, if you choose both Autoplay and Play On View, then Autoplay will override Play On View since Autoplay is more general.

1. Autoplay - enable to make the player play video ads regardless if the player is visible or not.
   We suggest to disable it in order to avoid policy violations in premium Advertisers such as Google.
   * Technically, defines whether startAd is called automatically. If FALSE, startAd should be called after getting the onLoad callback event.

2. Loop - defines whether to continue looking for more ads at the end of the first impression.
   Disabling it is equal to setting a Maximum Impressions of 1.

   • Technically, if loop is FALSE, it will only play one ad. When using Video Content (as a preloader), it will also define whether or not to loop it.

3. Pause On Unseen - if set to TRUE, the player will pause when it is out of view.

4. Pause On Blur - if set to TRUE, the player will pause when the browser window loses focus.

5. Requests On View - send requests to Ad Sources only when the player is in view.

6. Check Tab Is In View - consider “in view” only if the relevant browser tab is actually in focus.

7. Player Load On View - Send Inventory only if the player is in view. Without Inventory, the player will be loaded but not open video ads.

8. Play On View - enable to make the player play video ads only if the player is in view.
   * Technically, if set to TRUE, the player will automatically check the viewability and will call startAd only when it is in view.
   We suggest to enable it in order to avoid policy violations in premium Advertisers such as Google.

Appearance

Player Caption

Enable Advertising Label - if set to TRUE, show an advertising label in the caption above the player view.
We suggest to enable it in order to avoid policy violations in premium Advertisers such as Google.

Player Mode

Can be set to:

1. In Read - never float the player, only show it regularly (e.g. in the middle of the page).

2. Floating (default) - make the player become Sticky only after it’s seen in a regular way (e.g. in the middle of the page) and the user scrolls away from it.

3. Sticky - always float the player and never show it regularly (e.g. in the middle of the page).
   We suggest to never enable Sticky in order to avoid policy violations in premium Advertisers such as Google.

Player Mode Settings

They only show up for Floating and Sticky whereas Sticky’s options are a subset for Floating:

1. Close Floating Button - if set to TRUE, show a close button only when the player is Floating that will disable the floating option.

2. Float On Bottom - the player will float both when scrolled down past it and above it, and not just down past it.
   If you enabled Autoplay, we suggest to also enable Float on Bottom to make sure the player is only autoplayed when visible (meaning even if it starts floating to begin with, it will at least be visible).

3. Float On Impression - the player will start floating only after an impression.

4. Resizing Method - define the size of the player when it is Floating, by scale to the original size
   or by fixed width and height sizes in pixels.

5. Size When Floating or Width/Height - based on Resizing Method.

6. Position (also for Sticky) - choose the corner of the screen where the player will appear and "float" to.
   Note Top and Bottom mean 100% of the page’s width.

7. Margins and/or Background Color - based on Position.
   Note only Top and Bottom offer Background Color.

Player Sizing

1. Player Size - Choose Responsive so the player's size will adapt to the frame in which it is wrapped, maintaining an aspect ratio of 16:9. Choose Fixed (size) to manually define both the Width and Height of the player.

2. Maximum Width - defines the maximum width of the player, as completion of Player Size.

3. Minimum Height - defines the minimum height, as completion to Player Size.

4. Z-Index (Overlapping) - specifies the stack order of the player. Overlapping elements with a larger z-index cover those with a smaller one.
   Tip: if the publisher asks you not to cover their elements, choose a lower z-index, and vice versa.

5. Opening Animation - If set to TRUE, the player will open with an animation.

6. Custom CSS - use your own CSS to change the appearance of the player.

Extensions

Preloader

An element that can be shown between video ads.

Preloader Type Content

Content means Video Content, meaning to show video content between video ads.

1. Add as many links as you want to create playlists.
   Each video requires a URL, however the Click Through URL is optional
   URL: Link to video content (usually mp4 file) you would like to use.
   Click Through URL: The link where users will be redirected to when clicking on the Video

2. Autoplay Content - if set to TRUE, the video content will start playing automatically.
   If not, it will be Click-to-play.

3. Random Contents - if set to TRUE, the order in which the different videos are reproduced is random.

4. Poster - the link to an image that will be shown while the content is loading.

5. Preroll - defines the number of preroll ads that will try to generate.
   Can't be more then 4 prerolls.

6. Preroll Time Out (only if Preroll was chosen) - the time for the player to generate preroll ads.
   Must be larger then 3 seconds.

Preloader Type Image

Show images between video ads.

1. URL - Link to an image file you would like to use.

2. Click Through URL - The link where users will be redirected to when clicking on the image.

Preloader Type JS

Use HTML code between video ads. This HTML code will be put inside an iframe.

1. Full Html - if the code uses <head> and <body>, respect it. If it’s disabled, <head> and <body> tags will be stripped and the entire HTML will be put into <body>.

2. Close Button - if set to TRUE, show a close button when the preloader appears.
   We suggest to enable it. Since the preloader might appear floating, enabling it should avoid policy violations in premium Advertisers such as Google.

3. Width and Height - size of the iframe in pixels.

4. URL - link to the HTML file that you would like to use.
   Note it must have a TXT extension, not HTM or HTML!

5. Background Color - choose or type the color you would like to use for the iframe's background.

Passback

An HTML code (that will also remain) after the player finishes up its session. This HTML code will be put inside an iframe.

1. Passback URL - a link to a HTML file that will be called once the player has finished all its retries.
   Note it must have a TXT extension, not HTM or HTML!

2. Width and Height - size of the iframe in pixels.

3. Passback Priority - if set to TRUE, show the passback, even if there is a preloader.
   It is only relevant in cases where both a preloader and a passback are defined.

4. No Float - if set to TRUE, prevent the iFrame with the passback from Floating (only if the player itself uses floating).

5. No Passback After Impression - don't show passback after there was a video impression.

6. No Close Button - if set to TRUE, remove the close button from the iframe.

7. Background Color - choose or type the color you would like to use for the iframe's background.

8. Full Html - if the code uses <head> and <body>, respect it. If it’s disabled, <head> and <body> tags will be stripped and the entire HTML will be put into <body>.

Controls

Left side

1. Timeline Mode - choose where (if at all) to put player’s timeline.

2. Skip Button
   

   

   If set to TRUE, show a Skip button within the player.

   1. Skip Timer - the amount of seconds to wait before showing the Skip Button.
      It must be > 0.

   2. Skip Text - change the text shown in the Skip button from the default.

Right side

1. Play/Pause button - if set to TRUE, the player will have a Play/Pause button.

2. Close button - if set to TRUE, the close button will appear in the top left corner of the player.

3. Close Outside - If set to TRUE, the close button will appear in outside/above the player.
   Note this controls every other Close button element as well (in Floating, in Extensions, etc.).

4. Position and Margin - choose the corner of the screen where the close button will appear and stick to.
   The Default option depends on Close Outside - if Close Outside is not checked then the close button will appear at the top left corner of the player view. Otherwise the button will appear at the top right corner of the caption above the player.

5. Overlay Margin - define the size of the non clickable area around the close button

6. Sound Button - if set to TRUE, the player will have a button users can click on to turn on sound.
   Note this concerns just the existence of a button! Ads that are autoplay start off muted.

Logo

1. Enable Logo - if set to TRUE, show a logo on the top right corner of the player.

2. Custom Logo - customize the logo so that yours will appear instead of the system’s logo.

   1. Link - the link to the logo you would like to use instead of the system’s one.
      We recommend using a png, with a transparent background

   2. Clickthrough - the link that will open when clicking on the logo instead of the system’s one.

   3. Width and Height - size in pixels of the custom logo.

   4. Top - the distance of the custom logo from the top frame in pixels.

3. Hide Logo On Ad - if set to TRUE, logo is hidden when showing ads.
   If you Enable Logo, we suggest enabling Hide Logo On Ad too in order to avoid policy violations in premium Advertisers such as Google, as external logos aren’t supposed to interfere with ads.

4. Text - change the text that appears right next to the logo from the default.

Advanced

Left side

Right side

InStream

Main

Content

Ad Config

Performance

Appearance

Mobile

Controls

Logo

Advanced