Configuración global

Selecciona la plataforma: Android (beta) Android iOS Unity

La clase MobileAds proporciona la configuración global para GMA Next-Gen SDK.

Control de volumen para anuncios de video

Si tu app tiene sus propios controles de volumen (como volúmenes de música o efectos de sonido personalizados), divulgar el volumen de la app a GMA Next-Gen SDK permite que los anuncios de video respeten la configuración de volumen de la app. Esto garantiza que los usuarios reciban anuncios de video con el volumen de audio esperado.

El volumen del dispositivo, controlado por medio de los botones de volumen o el control deslizante de volumen del sistema operativo, determina el volumen de la salida de audio del dispositivo. Sin embargo, las apps pueden ajustar de forma independiente los niveles de volumen en relación con el volumen del dispositivo para adaptar la experiencia de audio. Para los formatos de anuncios de apertura de app, banner, intersticial, recompensado y recompensado intersticial, puedes informar el volumen relativo de la app al SDK a través del método estático setUserControlledAppVolume(). Los valores de volumen de anuncios válidos varían de 0.0 (silencio) 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 GMA Next-Gen SDK on a background thread.
    MobileAds.initialize(
      this@MainActivity,
      // Sample Ad Manager 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 Ad Manager 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 al SDK que el volumen de la app se silenció, usa el setUserMutedApp() método:

Kotlin

MobileAds.setUserMutedApp(true)

Java

MobileAds.setUserMutedApp(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 para 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 más amplio de anuncios de video de servir.

Consentimiento para cookies

Si tu app tiene requisitos especiales, puedes establecer el parámetro opcional SharedPreferences gad_has_consent_for_cookies. El SDK habilitará 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();