Globale Einstellungen

Plattform auswählen: Android iOS Unity Android (Legacy)

Die Klasse MobileAds enthält globale Einstellungen für Google Mobile Ads SDK (Legacy).

Lautstärkeregelung für Videoanzeigen

Wenn in Ihrer App die Lautstärke separat eingestellt werden kann, z. B. für Musik oder Toneffekte , können Sie festlegenGoogle Mobile Ads SDK (Legacy), dass Videoanzeigen an die jeweils gewählte Lautstärke angepasst werden. So werden Videoanzeigen in der erwarteten Lautstärke ausgeliefert.

Die Lautstärke für die Audioausgabe von Geräten wird über die Gerätelautstärke gesteuert, die über die Lautstärketasten oder den Lautstärkeregler auf Betriebssystemebene eingestellt wird. Apps können die Lautstärkepegel jedoch unabhängig von der Gerätelautstärke anpassen, um das Audioerlebnis zu optimieren. Bei den Anzeigenformaten App-Start-Anzeigen, Banner- und Interstitial-Anzeigen sowie Anzeigen mit Prämie und Interstitial-Anzeigen mit Prämie können Sie das relative App-Volumen über die statische Methode setAppVolume() an das SDK melden. Gültige Werte für das Anzeigenvolumen reichen von 0.0 (lautlos) bis 1.0 (aktuelles Gerätevolumen). Hier sehen Sie ein Beispiel dafür, wie Sie das relative App-Volumen an das SDK melden:

Kotlin

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

Java

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

Verwenden Sie die Methode setAppMuted(), um dem SDK mitzuteilen, dass die App-Lautstärke stummgeschaltet wurde:

Kotlin

MobileAds.setAppMuted(true)

Java

MobileAds.setAppMuted(true);

Standardmäßig ist die App-Lautstärke auf 1 (die aktuelle Gerätelautstärke) eingestellt und die App ist nicht stummgeschaltet.

Hinweis :Videoanzeigen, die nicht mit stummgeschaltetem Audio ausgeliefert werden dürfen, werden nicht für Anzeigenanfragen zurückgegeben, die gestellt werden, wenn das App-Volumen als stummgeschaltet gemeldet oder auf den Wert 0 festgelegt ist. Dadurch wird möglicherweise die Auslieferung einer Teilmenge des gesamten Pools von Videoanzeigen eingeschränkt.

Native Anzeigen

Eine Anleitung zum Steuern der Stummschaltungseinstellungen finden Sie unter VideoOptions. Die benutzerdefinierte Lautstärkeregelung wird für native Anzeigen nicht unterstützt.

Einwilligung für Cookies

Wenn Ihre App spezielle Anforderungen hat, können Sie die optionale SharedPreferences gad_has_consent_for_cookies festlegen. Das SDK aktiviert eingeschränkte Anzeigen (Limited Ads, LTD), wenn die Einstellung gad_has_consent_for_cookies auf null gesetzt ist.

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