Configurações globais

Selecionar plataforma: Android Android iOS Unity

A classe MobileAds oferece configurações globais para Google Mobile Ads SDK.

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 para o 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.Google Mobile Ads SDK Isso garante que os usuários recebam anúncios em vídeo com o volume de áudio esperado.

O volume do dispositivo, controlado pelos 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 de abertura do app, banner, intersticial, premiado e intersticial premiado, é possível informar o volume relativo do app ao SDK usando o método estático setAppVolume(). Os valores de volume de anúncio válidos variam de 0.0 (silencioso) a 1.0 (volume atual do dispositivo). Confira um exemplo de como informar o volume relativo do app ao SDK:

Kotlin

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

  val backgroundScope = CoroutineScope(Dispatchers.IO)
  backgroundScope.launch {
    // Initialize 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 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 foi silenciado, use o método setAppMuted():

Kotlin

MobileAds.setAppMuted(true)

Java

MobileAds.setAppMuted(true);

Por padrão, o volume do aplicativo é definido como 1 (o volume atual do dispositivo) e o aplicativo não está 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úncios feitas quando o volume do app é informado como silenciado ou definido como um valor de 0. Isso pode restringir um subconjunto do pool de anúncios em vídeo mais amplo.

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, você poderá definir o opcional SharedPreferences gad_has_consent_for_cookies. 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();