Configuración global

La clase MobileAds proporciona la configuración global del SDK de anuncios de Google para dispositivos móviles.

Control de volumen para anuncios de video

Si tu app tiene sus propios controles de volumen (como la música personalizada o los volúmenes de efectos de sonido), mostrar el volumen de la app al SDK de anuncios de Google para dispositivos móviles permite que los anuncios de video respetan la configuración de volumen de la app. De esta manera, se garantiza que los usuarios reciban anuncios de video con el volumen de audio esperado.

El volumen del dispositivo, que se controla con los botones de volumen o el control deslizante de volumen a nivel del SO, determina el volumen de la salida de audio del dispositivo. Sin embargo, las apps pueden ajustar los niveles de volumen de manera independiente según el volumen del dispositivo para personalizar la experiencia de audio. Para los formatos de anuncios de aplicación abierta, banner, intersticial, recompensados e intersticiales recompensados, puedes informar el volumen relativo de la app al SDK a través del método estático setAppVolume(). Los valores válidos del volumen del anuncio varían de 0.0 (silencioso) a 1.0 (volumen actual del dispositivo). A continuación, se muestra un ejemplo de cómo informar el volumen relativo de la app al 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 al SDK que se silenció el volumen de la app, usa el método setAppMuted():

Kotlin

MobileAds.setAppMuted(true)

Java

MobileAds.setAppMuted(true);

De forma predeterminada, el volumen de la app se establece en 1 (el volumen actual del dispositivo) y la app no está silenciada.

Nota: Los anuncios de video que no son aptos para mostrarse con audio silenciado no se muestran en las solicitudes de anuncios realizadas cuando el volumen de la app se informa como silenciado o se establece en un valor de 0. Esto puede restringir la publicación de un subconjunto del grupo de anuncios de video más amplio.

Anuncios nativos

Consulta VideoOptions para obtener instrucciones sobre cómo controlar la configuración de silenciamiento. El control de volumen personalizado no es compatible con los anuncios nativos.

Consentimiento para cookies

Si tu app tiene requisitos especiales, puedes configurar el elemento opcional SharedPreferences gad_has_consent_for_cookies. El SDK habilitará los anuncios limitados (LTD) cuando la preferencia gad_has_consent_for_cookies se establezca en cero.

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();