Impostazioni globali

La classe MobileAds fornisce le impostazioni globali per l'SDK Google Mobile Ads.

Controllo del volume degli annunci video

Se l'app ha i propri controlli del volume (ad es. volumi di musica o effetti sonori personalizzati), la comunicazione del volume all'SDK Google Mobile Ads consente agli annunci video di rispettare le impostazioni del volume dell'app. In questo modo, gli utenti vedranno gli annunci video con il volume audio previsto.

Il volume del dispositivo, controllato tramite i pulsanti 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 i livelli di volume in modo indipendente in base 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 di app relativo all'SDK tramite il metodo statico setAppVolume(). I valori validi del volume degli annunci sono compresi tra 0.0 (silenzioso) e 1.0 (volume attuale del dispositivo). Ecco un esempio di come registrare il volume relativo delle app nell'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();
}

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

Kotlin

MobileAds.setAppMuted(true)

Java

MobileAds.setAppMuted(true);

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

Nota: gli annunci video che non sono idonei alla visualizzazione con l'audio disattivato non vengono restituiti per le richieste di annunci effettuate se il volume dell'app viene segnalato con audio disattivato o impostato su un valore di 0. Ciò potrebbe limitare la pubblicazione di un sottoinsieme del più ampio insieme di annunci video.

Annunci nativi

Consulta la pagina 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 l'opzione facoltativa 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.

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