Stay organized with collections Save and categorize content based on your preferences.

Specifying language

The IMA SDK allows you to 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 below.

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

  mAdDisplayContainer = mSdkFactory.createAdDisplayContainer();
  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. Please follow the following code snippet to do so:


  protected void onCreate(Bundle savedInstanceState) {

    playerView = findViewById(R.id.player_view);

    ImaSdkSettings imaSdkSettings = ImaSdkFactory.getInstance().createImaSdkSettings();
    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
Afrikaans af
Amharic am
Arabic ar
Arabic (Egypt) ar_eg
Arabic (Saudi Arabia) ar_sa
Basque eu
Belarusian be
Bengali bn
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
Farsi fa
Filipino fil
Finnish fi
French fr
French (Canada) fr_ca
French (Switzerland) fr_ch
Galician gl
German de
German (Austria) de_at
Greek el
Gujarati gu
Hebrew he
Hindi hi
Hungarian hu
Icelandic is
Indonesian id
Italian it
Japanese ja
Kannada kn
Korean ko
Lao lo
Latvian lv
Lingala ln
Lithuanian lt
Malay ms
Malayalam ml
Marathi mr
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
Swahili sw
Swedish sv
Swiss German gsw
Tagalog tl
Tamil ta
Telugu te
Thai th
Turkish tr
Ukrainian uk
Urdu ur
Vietnamese vi
Zulu zu