Globale Einstellungen

Die Klasse MobileAds bietet globale Einstellungen für das Google Mobile Ads SDK.

Lautstärkeregelung für Videoanzeigen

Falls Ihre App eigene Lautstärkeregler hat (z. B. eigene Lautstärken für Musik oder Soundeffekte), kann durch die Offenlegung der App-Lautstärke im Google Mobile Ads SDK die Lautstärke der App entsprechend angepasst werden. So sehen Nutzer Videoanzeigen in der erwarteten Lautstärke.

Die Gerätelautstärke wird über die Lautstärketasten oder den Lautstärkeregler des Betriebssystems gesteuert und bestimmt die Lautstärke der Audioausgabe des Geräts. Apps können die Lautstärke jedoch unabhängig von der Gerätelautstärke anpassen, um die Audioqualität zu optimieren. Für die Anzeigenformate App-Start-Anzeigen, Banner, Interstitial-Anzeigen, 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 (laut) bis 1.0 (aktuelles Gerätevolumen). Hier ist ein Beispiel dafür, wie Sie das relative App-Volumen an das SDK melden:

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

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

Mit der Methode setAppMuted() kannst du dem SDK mitteilen, dass die App-Lautstärke stummgeschaltet wurde:

MobileAds.setAppMuted(true)

MobileAds.setAppMuted(true);

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

Native Anzeigen

Eine Anleitung zum Verwalten der Stummschaltungseinstellungen findest du unter VideoOptions. Die benutzerdefinierte Lautstärkeregelung wird für native Anzeigen nicht unterstützt.

Einwilligung für Cookies

Wenn für Ihre Anwendung besondere Anforderungen gelten, können Sie den optionalen SharedPreferences gad_has_consent_for_cookies festlegen. Das SDK aktiviert die eingeschränkte Anzeigenausrichtung, wenn die Einstellung gad_has_consent_for_cookies auf null gesetzt ist.

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