Localize the ad UI

  • Use ImaSdkSettings.setLanguage() with the appropriate locale code to specify the language for localizing ads and player UI controls.

  • The IMA SDK supports a comprehensive list of locale codes for various languages and regions.
Select platform: HTML5 Android iOS tvOS

The IMA SDK lets you specify the language to localize ads and player UI controls.

Specify a language

Set the language to localize ads and the player UI controls using 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 when using the ExoPlayer-IMA extension, use ImaAdsLoader.Builder.setImaSdkSettings():

@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