Configuración global

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

Control de volumen de anuncios de video

Si tu app tiene sus propios controles de volumen (como volúmenes personalizados de música o efectos de sonido), divulgar el volumen de la app al SDK de anuncios de Google para dispositivos móviles permite que los anuncios de video respeten la configuración del volumen de la app. Esto garantiza que los usuarios reciban anuncios de video con el volumen de audio esperado.

El volumen del dispositivo, controlado mediante los botones de volumen o el control deslizante de volumen del SO, determina el volumen de la salida de audio del dispositivo. Sin embargo, las apps pueden ajustar de manera independiente los niveles de volumen relacionados con el volumen del dispositivo para personalizar la experiencia de audio. En el caso de los formatos de anuncios de aplicación abierta, banner, intersticiales, recompensados e intersticiales recompensados, puedes informar el volumen relativo de la app al SDK a través del método setAppVolume() estático. Los valores válidos para el volumen de anuncios varían entre 0.0 (silencio) y 1.0 (volumen actual del dispositivo). Este es un ejemplo de cómo informar el volumen relativo de la app al SDK:

Java

@Override
protected void onCreate(Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);
  setContentView(R.layout.activity_my);

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

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
  super.onCreate(savedInstanceState)
  setContentView(R.layout.activity_main)

  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)
  }
}

Para informar al SDK que se silenció el volumen de la app, usa el método setAppMuted():

Java

MobileAds.setAppMuted(true);

Kotlin

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.

Anuncios nativos

Consulta VideoOptions a fin de obtener instrucciones para controlar la configuración de silencio. Por el momento, el control de volumen personalizado no es compatible con los anuncios nativos.

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

Java

Context activity = getActivity();
SharedPreferences sharedPreferences =
  PreferenceManager.getDefaultSharedPreferences(activity);
sharedPreferences.edit().putInt("gad_has_consent_for_cookies", 0).apply();

Kotlin

val sharedPrefs = PreferenceManager.getDefaultSharedPreferences(context)
sharedPrefs.edit().putInt("gad_has_consent_for_cookies", 0).apply()