1. Voltax Help Center
  2. General
  3. Guides
  4. VMS Guides

Voltax Player Guide

We offer you the ability to fully customize the player you embed on your site. In the following sections, we will show you the tools that you have at your disposal in the player table and player configuration screens. 


PLAYER TABLE

In the player table, you can see an overview of and manage all previously created players. The players are sorted in accordance to their last modification date. 

Deleting and Duplicating a Player

To delete a player, simply hover and click on the “Delete” icon. You will be asked to confirm your choice within a popup window. To duplicate a player, simply hover and click the “Duplicate” button. Note: deleting a player will remove it from all pages it was embedded in. 


 

Searching for a Player

You can search for a specific player by using the bar on the top right. Results will be shown according to titles and player IDs. 
 

Pagination and Total Amount of Players 

The pagination element on the top right shows you how many total players are part of this property. 

pagination.png

CREATE NEW PLAYER 

To create a new player from scratch, simply click on the "Create a Player" button on the top right corner of the screen. Once you've clicked "Create Player", you'll be directed to the 'Player type selector' page. This page is divided into 3 boxes : 

  1. Accompanying (This player will serve video ads next to content videos.)
  2. Outstream (This player will serve video ads without accompanying content videos.)
  3. Vertical aligned player (This player will serve vertical, short-form videos optimized for mobile-first viewing.)

Screen_Shot_2022-11-30_at_11.13.19.png

 

Accompanying Content Player: 

Please note that the Player Details side rail will appear in all the player editor page. Its goal is to remind the user the Player Name, Player Type, and to view a preview of how the player looks.

Appearance & General Settings

  • Player Name: Set a unique player name that will enable you to recognize it quickly. 

Note: The ‘Player Name’ field is mandatory, and the player can't be saved without it. 

  • Player Theme: Choose between Blue, Red, or Orange
  • Float Theme: choose between Black or White
  • Custom CSS: Allows to enter a custom CSS in order to change the player’s size, margins, etc.
     
  • Custom JavaScript: Allows to enter a custom CSS in order to change the player’s size, margins, etc.
     

Behavior & Settings

  • Playback Method
    • Scroll to Play: Content will begin playing when the user scrolls down and the player is within view
      • Trigger Pixels: Set the number of pixels that will load before the content is displayed (default 10000px)
    • Autoplay: Content will automatically begin playing when the page loads
    • Autoplay When Visible: Content will automatically begin playing when the player is visible on the screen
    • Click to Play: Content will begin playing when the user clicks on the player

    • General Settings : check on/off the following settings

  • Auto-Skip Settings
    • This section allows to either customize the settings per device type (mobile/desktop)
    • Keep Watching Video: 
      • Count Down Time: Seconds "Next / Stay" buttons are shown

      • 'Keep Watching' timing: Seconds before "Keep Watching" triggers next video

         

  • Float Settings
    • This section allows to either customize the settings per device type (mobile/desktop)
    • Choose between these 3 floating behaviors: 
      • Anchoring: 
        • Toggle on/off to select if the float behavior is Anchor only (No Main Player)
        • Toggle on/off to select if you like the Anchor behavior to apply only when ads are running
        • Adjust Anchoring Behavior (Below only or Above & Below): Anchoring position relative to main player
        • Adjust Anchoring Position On the screen (Bottom Or Top)
        • Anchoring Alignment(Left side of screen/Right side of screen/Custom): Align to screen or specific element
        • Vertical Margin: Type in the pixel margin to set
        • Horizontal Margin: Type in the pixel margin to set
        • Enable Floating width in pixels: Type in the pixel margin to set. If not specified, the default is 50% of the main player
      • Sticky:
        • Toggle on/off Sticky to top only (No Main Player)
        • Adjust Anchoring Behavior (Below only or Above & Below): Anchoring position relative to main player
        • Adjust Anchoring Position On the screen (Bottom Or Top)
        • Sticky Margin: Type in the pixel margin to set
        • Plug in the Width in Landscape positio

        •  

      • Static: Simply a player without a float behavior
  • Player Layout
    • Full Screen: Video content will take up 100% of the player’s viewability
       
    • Split View: Apply split view to present the video’s title and description in a side-by-side layout 
      • Apply Video Ratio (40%-70%)

Monetization

  • Publisher type: Choose between Owned and Operated and partners (either mmplus or external partners) and apply the following fields: 
    • Seller ID
    • STN Seller ID
    • Publisher Operator Domain
    • Publisher Operator ID
    • If enabled: apply the 
      • Min Request Interval
        GAM Type: Select up to 2 types of GAM (External/Internal)



 

  • Midroll Settings:
    • If enabled, select the Number of Slots
    • Recurs every sec
    • Remove Midroll 0
       
  • Preroll Settings: 
    • If enabled, select Number of slots 
    • Apply Skip GAM request on first preroll
  • On Demand: Toggle Enabled/Disabled
  • Assertive yield: 
    • If enabled, select the currency to apply (USD, NIS, etc.)
  • Geo Edge: 
    • If enabled, Apply the relevant Geo Edge key
  • Additional Settings: Toggle on/off the following options:
    • Aggressive Requests
    • Stop Monetization on User Interaction
    • Disable Companion Ads
    • Disable user syncs
    • Disable Vpaid
    • Showcase Publisher
    • Enable Permutive Script
    • Enable Brand Safety and IAB Taxonomy (toggled on by default)
  • Com Score account: usually auto applied from the organization settings. By clicking the Edit button, you can change the com score id number
  • Don't play ads when not in view: Choose between Disabled/ All platforms/GAM only/ Ad Server only

Header Bidding

  • Set up the floor price and check on/off "Use only config floor price"
  • APS: If enabled, 
    • Select Publisher type
    • Edit the Slot ID name
  • Prebid: If enabled, 
    • Select the SSP or SSP group to apply
  • RTB: If enabled, 
    • Apply RTB Interval (milliseconds)
  • Unified ID: If enabled, 
    • Apply the unified ID 
  • ID5: If enabled, 
    • Apply the ID5 number
  • LiveRamp:  If enabled, 
    • Apply the LiveRamp number

Ad Server

In this section, simply paste the MM ad server tag to the the text box. Advertisers use the ad server tags to store ad creative files, and deliver them to websites our player is injected in.

 

Additional Settings

  • Playlist ID: here is where you apply what playlist to include to this player. To learn more about playlists, click here.
  • Location: This is the HTML element into which the player will be injected. You can choose between: 
    • Inject by STN
    • CSS selector 
    • Set Path Manually 
    • Inject by external ID
  • Injection Relationship With Element
    • Within element - Before the content
    • Within element - After the content
    • Before Element - Adjacent to content
    • After Element - Adjacent to content
  • More settings:
    • Enable Child Protection
    • Enable ComScore
    • Enable STN Player (Uses Voltax config & Voltax Content)

       

Deal Terms

In this section you can review/edit the player Deal terms. The tables to review are Rate Cards and Content

Voltax Player API

Full Voltax Player API can be found here- https://developer.voltax.io/docs/voltax-player-api

Articles in this section