Updating Ad render settings with the Web Player

Overview

This document explains how to customize ad rendering behaviour in the Bitmovin Web Player when using the Google IMA SDK. The IMA SDK's AdsRenderingSettings object allows developers to configure how ads are rendered. Bitmovin Player provides access to the IMA ad manager through the onAdsManagerAvailable callback.

Example

const playerConfig = {
  ....
    onAdsManagerAvailable: (IMAAdManager) => {

      const adsRenderingSettings = {
        // Example settings – customize as needed
        bitrate: 400,
        loadVideoTimeout: 1000,
        mimeTypes: ["video/mp4", "video/webm"],
      };

      IMAAdManager.updateAdsRenderingSettings(adsRenderingSettings);
    }
  }
};

Supported adsRenderingSettings Parameters

The following properties can be configured using the updateAdsRenderingSettings().

Parameter	Type	Description
`autoAlign`	`boolean`	Set to `false` for fine-grained control over the positioning of all non-linear ads. If `true`, ads are positioned at the bottom center. if `false`, at the top left corner. Default is `true`.
`bitrate`	`number`	Maximum recommended bitrate in kbit/s. The SDK selects media with a bitrate below this value or the closest higher bitrate if none are lower. Default is `-1`, allowing the SDK to select the maximum bitrate.
`enablePreloading`	`boolean`	Enables preloading of video assets. For more information, see the guide to preloading media.
`loadVideoTimeout`	`number`	Timeout in milliseconds for loading a video ad media file. If loading exceeds this time, ad playback is canceled, and the next ad in the pod plays, if available. Use `-1` for the default of 8 seconds.
`mimeTypes`	`string[]`	Supported linear video MIME types. If specified, the SDK includes media matching these MIME types and excludes others. For example: `['video/mp4', 'video/webm']`. If not specified, the SDK selects media based on player capabilities.
`playAdsAfterTime`	`number`	For VMAP and ad rules playlists, plays ad breaks scheduled after this time (in seconds).
`uiElements`	`string[]`	Specifies which IMA UI elements to display during ads.
`useStyledLinearAds`	`boolean`	Renders linear ads with full UI styling.
`useStyledNonLinearAds`	`boolean`	Renders non-linear ads with a close and recall button.

⚠️ Not all settings are guaranteed to be supported by every ad tag or environment. Always test across your target browsers and devices.

Resource

• Bitmovin Web Player Ads Integration
• IMA SDK - AdsRenderingSettings Reference

Updated 22 days ago