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 viewabilityreqOnView: 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 sourcevitab: 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