Configurações globais

A classe MobileAds fornece configurações globais para o SDK dos anúncios para dispositivos móveis do Google.

Controle de volume do anúncio em vídeo

Se o app tiver controles de volume próprios, como ajustes personalizados de música ou efeitos sonoros, a divulgação do volume do app ao SDK dos anúncios para dispositivos móveis do Google permite que os anúncios em vídeo respeitem as configurações de volume do app. Isso garante que os usuários recebam anúncios em vídeo no volume esperado.

O volume do dispositivo, controlado por botões de volume ou pelo controle deslizante de volume no nível do SO, determina o volume da saída de áudio do dispositivo. No entanto, os apps podem ajustar os níveis de volume de forma independente em relação ao volume do dispositivo para personalizar a experiência de áudio. Para formatos de anúncio intersticial, de abertura do app, de banner e premiado, é possível informar o volume relativo do app ao SDK usando o método estático setAppVolume(). Os valores válidos do volume do anúncio variam de 0.0 (silêncio) a 1.0 (volume atual do dispositivo). Confira um exemplo de como relatar o volume relativo do app ao SDK:

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
  super.onCreate(savedInstanceState)

  val backgroundScope = CoroutineScope(Dispatchers.IO)
  backgroundScope.launch {
    // Initialize the Google Mobile Ads SDK on a background thread.
    MobileAds.initialize(this@MainActivity) {}
    
    // Set app volume to be half of current device volume.
    MobileAds.setAppVolume(0.5f)
  }
}

Java

@Override
protected void onCreate(Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);

  new Thread(
          () -> {
            // Initialize the Google Mobile Ads SDK on a background thread.
            MobileAds.initialize(this, initializationStatus -> {});
            
            // Set app volume to be half of current device volume.
            MobileAds.setAppVolume(0.5f);
          })
      .start();
}

Para informar ao SDK que o volume do app está desativado, use o método setAppMuted():

Kotlin

MobileAds.setAppMuted(true)

Java

MobileAds.setAppMuted(true);

Por padrão, o volume do app é definido como 1 (o volume atual do dispositivo) e o app não é silenciado.

Observação: os anúncios em vídeo que não podem ser exibidos com áudio silenciado não são retornados para solicitações de anúncio feitas quando o volume do app é informado como silenciado ou definido como 0. Isso pode impedir que um subconjunto do conjunto mais amplo de anúncios em vídeo seja veiculado.

Anúncios nativos

Consulte VideoOptions para instruções sobre como controlar as configurações de silenciamento. O controle de volume personalizado não é compatível com anúncios nativos.

Consentimento para cookies

Se o app tiver requisitos especiais, defina o SharedPreferences gad_has_consent_for_cookies opcional. O SDK vai ativar anúncios limitados (LTD) quando a preferência gad_has_consent_for_cookies for definida como zero.

Kotlin

val sharedPrefs = PreferenceManager.getDefaultSharedPreferences(context)
// Set the value to 0 to enable limited ads.
sharedPrefs.edit().putInt("gad_has_consent_for_cookies", 0).apply()

Java

Context activity = getActivity();
SharedPreferences sharedPreferences =
  PreferenceManager.getDefaultSharedPreferences(activity);
// Set the value to 0 to enable limited ads.
sharedPreferences.edit().putInt("gad_has_consent_for_cookies", 0).apply();