Localize the ad UI

  • The IMA SDK allows you to localize ads and UI elements by setting the language using ImaSdkSettings.setLanguage().

  • You can integrate language settings into the BasicExample by modifying VideoPlayerController.java and building the ImaAdsLoader with the desired language.

  • The IMA SDK supports a wide variety of language locale codes, including regional variations for languages like Arabic, English, Spanish, and Chinese.
Select platform: HTML5 Android iOS tvOS

Specify a language

The IMA SDK lets you specify the language to be used to localize ads and the player UI controls. To do so, use the ImaSdkSettings.setLanguage() method with the appropriate locale code as demonstrated in the code snippet:

  // Create an AdsLoader and optionally set the language.
  ImaSdkSettings imaSdkSettings = ImaSdkFactory.getInstance().createImaSdkSettings();
  imaSdkSettings.setLanguage('fr');
  mSdkFactory = ImaSdkFactory.getInstance();

  mAdDisplayContainer = mSdkFactory.createAdDisplayContainer();
  mAdDisplayContainer.setPlayer(mVideoPlayerWithAdPlayback.getVideoAdPlayer());
  mAdDisplayContainer.setAdContainer(mVideoPlayerWithAdPlayback.getAdUiContainer());
  mAdsLoader = mSdkFactory.createAdsLoader(context, imaSdkSettings, mAdDisplayContainer);

To set the language within the BasicExample which uses the Exoplayer-IMA extension, a modification needs to be made to set ImaSdkSettings:

VideoPlayerController.java

@Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_my);

    playerView = findViewById(R.id.player_view);

    ImaSdkSettings imaSdkSettings = ImaSdkFactory.getInstance().createImaSdkSettings();
    imaSdkSettings.setLanguage("fr");
    ImaAdsLoader.Builder builder = new ImaAdsLoader.Builder(this).setImaSdkSettings(imaSdkSettings);

    adsLoader = builder.buildForAdTag(Uri.parse(getString(R.string.ad_tag_url)));
  }

Locale codes

IMA supports the following locale codes:

Language Country code
Arabic ar
Arabic (Egypt) ar_eg
Arabic (Saudi Arabia) ar_sa
Bulgarian bg
Catalan ca
Chinese (Simplified) zh
Chinese (Simplified, China) zh_cn
Chinese (Traditional, Hong Kong) zh_hk
Chinese (Traditional, Taiwan) zh_tw
Croatian hr
Czech cs
Danish da
Dutch nl
English en
English (Australia) en_au
English (Canada) en_ca
English (United Kingdom) en_gb
English (Ireland) en_ie
English (India) en_in
English (Singapore) en_sg
English (South Africa) en_za
Estonian et
Filipino fil
Finnish fi
French fr
French (Canada) fr_ca
French (Switzerland) fr_ch
German de
German (Austria) de_at
Greek el
Hebrew he
Hindi hi
Hungarian hu
Icelandic is
Indonesian id
Italian it
Japanese ja
Korean ko
Latvian lv
Lithuanian lt
Malay ms
Norwegian no
Polish pl
Portuguese pt
Portuguese (Brazil) pt_br
Portuguese (Portugal) pt_pt
Romanian ro
Russian ru
Serbian sr
Slovak sk
Slovenian sl
Spanish es
Spanish (Latin America) es_419
Spanish (Argentina) es_ar
Spanish (Chile) es_cl
Spanish (Colombia) es_co
Spanish (Costa Rica) es_cr
Spanish (Dominican Republic) es_do
Spanish (Ecuador) es_ec
Spanish (El Salvador) es_sv
Spanish (Guatemala) es_gt
Spanish (Honduras) es_hn
Spanish (Mexico) es_mx
Spanish (Nicaragua) es_ni
Spanish (Panama) es_pa
Spanish (Peru) es_pe
Spanish (Puerto Rico) es_pr
Spanish (Paraguay) es_py
Spanish (United States) es_us
Spanish (Uruguay) es_uy
Spanish (Venezuela) es_ve
Swedish sv
Thai th
Turkish tr
Ukrainian uk
Vietnamese vi