Localize the ad UI

  • The IMA DAI SDK enables localization of ads and UI controls by specifying a language.

  • Use the ImaSdkSettings.setLanguage() method with a locale code (e.g., 'fr' for French) to set the desired language.

  • This setting is applied when creating an AdsLoader using the IMA SDK factory.
Select platform: HTML5 Android iOS tvOS

Specify a language

The IMA DAI 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 following code snippet.

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

  adDisplayContainer = sdkFactory.createAdDisplayContainer();
  adDisplayContainer.setVideoStreamPlayer(videoStreamPlayer);
  adDisplayContainer.setAdContainer(mAdUiContainer);
  adsLoader = sdkFactory.createAdsLoader(context, imaSdkSettings, adDisplayContainer);

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