Impostazioni globali

La classe MobileAds fornisce impostazioni globali per Google Mobile Ads SDK (Legacy).

Controllo del volume degli annunci video

Se la tua app ha i propri controlli del volume, ad esempio volume personalizzato di musica o effetti sonori, la divulgazione del volume dell'app a Google Mobile Ads SDK (Legacy) consente agli annunci video di rispettare le impostazioni di volume dell'app. In questo modo, avrai la certezza che l'utente vedrà gli annunci video con il volume audio previsto.

Il volume del dispositivo, controllato tramite i tasti del volume o il cursore del volume a livello di sistema operativo, determina il volume dell'uscita audio del dispositivo. Tuttavia, le app possono regolare in modo indipendente i livelli di volume rispetto al volume del dispositivo per personalizzare l'esperienza audio. Per i formati degli annunci apertura app, banner, interstitial, con premio e interstitial con premio, puoi segnalare il volume relativo dell'app all'SDK tramite il metodo statico setAppVolume(). I valori validi per il volume degli annunci sono compresi tra 0.0 (silenzioso) e 1.0 (volume attuale del dispositivo). Ecco un esempio di come segnalare il volume relativo dell'app all'SDK:

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

  val backgroundScope = CoroutineScope(Dispatchers.IO)
  backgroundScope.launch {
    // Initialize Google Mobile Ads SDK (Legacy) on a background thread.
    MobileAds.initialize(this@MainActivity) {}
    
    // Set app volume to be half of current device volume.
    MobileAds.setAppVolume(0.5f)
  }
}

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

  new Thread(
          () -> {
            // Initialize Google Mobile Ads SDK (Legacy) on a background thread.
            MobileAds.initialize(this, initializationStatus -> {});
            
            // Set app volume to be half of current device volume.
            MobileAds.setAppVolume(0.5f);
          })
      .start();
}

Per informare l'SDK che il volume dell'app è stato disattivato, utilizza il metodo setAppMuted():

MobileAds.setAppMuted(true)

MobileAds.setAppMuted(true);

Per impostazione predefinita, il volume dell'app è impostato su 1 (il volume del dispositivo corrente) e l'audio dell'app non è disattivato.

Annunci nativi

Consulta VideoOptions per istruzioni su come controllare le impostazioni di disattivazione dell'audio. Il controllo del volume personalizzato non è supportato per gli annunci nativi.

Consenso per i cookie

Se la tua app ha requisiti speciali, puoi impostare il campo facoltativo SharedPreferences gad_has_consent_for_cookies. L'SDK attiverà gli annunci con limitazioni (LTD) quando la preferenza gad_has_consent_for_cookies è impostata su zero.

val sharedPrefs = PreferenceManager.getDefaultSharedPreferences(context)
// Set the value to 0 to enable limited ads.
sharedPrefs.edit().putInt("gad_has_consent_for_cookies", 0).apply()

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