Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Next »

Viewability Control

The ads player has a few features that can be used in order to control and increase viewability

Some controls are in the player configuration:

  • startOnView: The entire player is loaded when in view. This means that only when the player position is in view, the player will load and start.
    This flag requires using player templates/studio
    Note that inventory metric will be sent only after the player is in view and loaded
    After the player loads it continues without validating viewability

  • reqOnView: If set, the player will call all ad sources (request) when in view. If the player is not in view it waits till its in view and will resume.
    This flag do not requires using player templates/studio
    (Subject to other configurations such as midrolltime)

  • playOnView: If set, the player calls and sources also when not in view and initialize vpaids.
    This flag requires using player templates/studio
    It will initiate the ads play (startAd) only when in view
    Note that because of the nature of vpaids and SDKs, calling startAd does not guarantee and ad impression of the specific ad source

  • vitab: If set, viewability checks take into account if the tab is in view or not. Default is false

  • playOnViewPerc: Define the % of view that defines if the player is in view or not. Default is 50%
    This applies to all features

There are some controls that can be set per ad source.
When those settings are used, when the waterfall runs, if the player is not in view, the ad source is skipped and not used but the player continue running and might finish (errorlimit) without calling those ad sources if the player is not reaching view

Ad source settings are available at the ad source page, player settings tab

  • Required Viewable Percentage(%): % of view required. Set to 50 for standard use

  • Don't request if not in view:

    • If set, dont call the ad source when not in view.

    • If not set, the ad source will be called but startAd will be called only when in view.
      If the ad source respond and waiting for view, and the player finished handline all other ad sources that does not require view, the player will wait up to 3 sec for view and if not in view the player will discard the ad source and continue to the next waterfall cycle

Viewable Impression

The player reports viewable impression metric according to the MRC guidelines: When the ad is in view at least 2 consecutive seconds

  • No labels