Skip to main content
Version: 11.7.0

Customizing the ad overlay text on Android

This guide explains how to customize the overlay text shown during an ad break. You may ask this question if you want to change the styling or override the texts shown during an ad break.

Depending on the ad integration kind you use, the steps to take differ.

Google IMA/DAI​

With Google IMA/DAI, it is not possible to directly edit the default UI. You can pass a locale to IMA to completely localize the ad UI.

Changing or localizing the text​

You can pass your preferred language while adding the Google IMA integration to the player:

private fun addGoogleImaIntegration() {
    val settings = ImaSdkFactory.getInstance().createImaSdkSettings()
    settings.language = "nl"

    val imaIntegration = createGoogleImaIntegration(tpv!!, settings)

    tpv?.player?.addIntegration(imaIntegration)
}

You can find a list of locales supported by the IMA SDK on Android here.

Changing the styling​

Please refer to the relevant Google IMA guide on how to disable the default UI and implement your own ad UI.

Remarks​

  • If you are using THEOplayer Open Video UI, there could be alternative ways to edit certain elements depending on the platform and the ad integration kind used. For reference, you can find a demo for the csai ad integration on Web SDK here.
  • The Why this ad? text or the ? (question mark) icon that may appear while using the Google IMA/DAI integration is inserted by the IMA SDK itself and is required to be displayed with any ad that was not manually selected. The icon is rendered as a VAST icon and is automatically generated by Ad Manager where required.

Resources​