Configurações globais

A classe MobileAds fornece configurações globais para o SDK de última geração do GMA.

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 do GMA Next Gen 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 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 de forma independente os níveis de volume em relação ao volume do dispositivo para personalizar a experiência de áudio. Para os 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 setUserControlledAppVolume(). Os valores válidos de volume de anúncios 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 GMA Next Gen SDK on a background thread.
    MobileAds.initialize(
      this@MainActivity,
      // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
      InitializationConfig.Builder("SAMPLE_APP_ID").build()
    ) {}
    
    // Set app volume to be half of current device volume.
    MobileAds.setUserControlledAppVolume(0.5f)
  }
}

Java

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

  new Thread(
          () -> {
            // Initialize GMA Next Gen SDK on a background thread.
            MobileAds.initialize(
                this,
                // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
                new InitializationConfig.Builder("SAMPLE_APP_ID")
                    .build(),
                initializationStatus -> {
                });
            
            // Set app volume to be half of current device volume.
            MobileAds.setUserControlledAppVolume(0.5f);
          })
      .start();
}

Para informar ao SDK que o volume do app foi silenciado, use o método setUserMutedApp():

Kotlin

MobileAds.setUserMutedApp(true)

Java

MobileAds.setUserMutedApp(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 veiculados com o áudio silenciado não são retornados para solicitações feitas quando o volume do app é informado como silenciado ou definido como um valor de 0. Isso pode restringir um subconjunto do pool mais amplo de anúncios em vídeo de veiculação.

Consentimento para o uso de cookies

Se o app tiver requisitos especiais, defina o SharedPreferences gad_has_consent_for_cookies opcional. O SDK vai ativar os 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();