Globale Einstellungen

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

Lautstärkeregelung für Videoanzeigen

Wenn Ihre App über eigene Lautstärkeregler verfügt (z. B. eine benutzerdefinierte Lautstärkeregelung für Musik oder Soundeffekte) und durch Angabe der App-Lautstärke für das Google Mobile Ads SDK können Videoanzeigen den Lautstärkeeinstellungen der App entsprechen. So wird sichergestellt, dass Nutzer Videoanzeigen mit der erwarteten Audiolautstärke sehen.

Die Gerätelautstärke, die über die Lautstärketasten oder den Lautstärkeregler auf Betriebssystemebene gesteuert wird, bestimmt die Lautstärke für die Audioausgabe des Geräts. Apps können die Lautstärke jedoch unabhängig von der Gerätelautstärke anpassen, um das Audioerlebnis anzupassen. Bei App-Start-, Banner-, Interstitial-, Interstitial-Anzeigen mit Prämie und Interstitial-Anzeigen mit Prämie können Sie das relative App-Volumen über die statische setAppVolume()-Methode an das SDK melden. Gültige Werte für die Anzeigenlautstärke reichen von 0.0 (Lautlos) bis 1.0 (aktuelle Gerätelautstärke). Hier ist ein Beispiel dafür, wie das relative App-Volumen an das SDK gemeldet wird:

Java

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_my);
    
    MobileAds.initialize(this);
    
    // Set app volume to be half of current device volume.
    MobileAds.setAppVolume(0.5f);
    ...
}

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)
    
    MobileAds.initialize(this)
    
    // Set app volume to be half of current device volume.
    MobileAds.setAppVolume(0.5f)
    ...
}

Wenn Sie das SDK darüber informieren möchten, dass das App-Volume stummgeschaltet wurde, verwenden Sie die Methode setAppMuted():

Java

MobileAds.setAppMuted(true);

Kotlin

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 können, werden nicht bei Anzeigenanfragen zurückgegeben, wenn die App-Lautstärke als stummgeschaltet gemeldet oder auf einen Wert von 0 festgelegt ist. Dadurch wird möglicherweise ein Teil des gesamten Videoanzeigenpools von der Auslieferung ausgeschlossen.

Native Anzeigen

Eine Anleitung zum Festlegen der Einstellungen zum Stummschalten finden Sie unter VideoOptions. Die benutzerdefinierte Lautstärkeregelung wird derzeit für native Anzeigen nicht unterstützt.

Einwilligung zur Verwendung von Cookies

Wenn Ihre App besondere Anforderungen hat, können Sie den optionalen SharedPreferences gad_has_consent_for_cookies festlegen. Das SDK aktiviert die Option Eingeschränkte Anzeigenausrichtung wenn die gad_has_consent_for_cookies-Einstellung auf null gesetzt ist.

Java

Context activity = getActivity();
SharedPreferences sharedPreferences =
  PreferenceManager.getDefaultSharedPreferences(activity);
sharedPreferences.edit().putInt("gad_has_consent_for_cookies", 0).apply();

Kotlin

val sharedPrefs = PreferenceManager.getDefaultSharedPreferences(context)
sharedPrefs.edit().putInt("gad_has_consent_for_cookies", 0).apply()