Impostazioni generali

Seleziona la piattaforma: Android (beta) Android iOS Unity

La classe MobileAds fornisce le impostazioni globali per GMA Next-Gen SDK.

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 comunicazione del volume dell'app a GMA Next-Gen SDK consente agli annunci video di rispettare le impostazioni di 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 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 comunicare il volume relativo dell'app all'SDK tramite il metodo statico setUserControlledAppVolume(). I valori validi del volume degli annunci vanno da 0.0 (silenzioso) a 1.0 (volume del dispositivo corrente). Ecco un esempio di come comunicare il volume relativo dell'app all'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();
}

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

Kotlin

MobileAds.setUserMutedApp(true)

Java

MobileAds.setUserMutedApp(true);

Per impostazione predefinita, il volume dell'app è impostato su 1 (il volume del dispositivo corrente) 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 quando il volume dell'app viene segnalato come disattivato o impostato su un valore di 0. Ciò potrebbe limitare la pubblicazione di un sottoinsieme del pool di annunci video più ampio.

Consenso all'uso dei cookie

Se la tua app ha requisiti speciali, puoi impostare l'opzione SharedPreferences gad_has_consent_for_cookies. L'SDK attiverà gli annunci con limitazioni quando la gad_has_consent_for_cookies preferenza è 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();