Globale Einstellungen

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

Anzeigenereignisse im Unity-Hauptthread auslösen

Das Google Mobile Ads SDK löst Ereignisse in einem anderen Thread als dem Unity-Hauptthread aus. Wenn Sie Anzeigenereignisse implementieren und mit Unity-Objekten interagieren, müssen Sie die Ereignisse des Mobile Ads SDK mit dem Unity-Hauptthread synchronisieren.

Wenn das Mobile Ads SDK dieses Threading-Problem für Sie bearbeiten soll, setzen Sie MobileAds.RaiseAdEventsOnUnityMainThread auf true. Dadurch wird das SDK gezwungen, alle Ereignisse und Callbacks im Unity-Hauptthread auszulösen.

...
using GoogleMobileAds.Api;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // When true all events raised by GoogleMobileAds will be raised
        // on the Unity main thread. The default value is false.
        MobileAds.RaiseAdEventsOnUnityMainThread = true;
    }
}

Hinweis :Ein Nebeneffekt des Auslösens von Ereignissen im Unity-Hauptthread bedeutet, dass bestimmte Ereignisse wie OnAdFullScreenContentOpened erst ausgelöst werden, wenn der Nutzer zur Anwendung zurückkehrt.

Lautstärkeregelung für Videoanzeigen

Wenn Ihre App über eigene Lautstärkeregler verfügt, z. B. benutzerdefinierte Lautstärken für Musik oder Soundeffekte, können die Einstellungen für die App-Lautstärke durch die Offenlegung der App-Lautstärke im Google Mobile Ads SDK in Videoanzeigen berücksichtigt werden. Nutzer erhalten dann Videoanzeigen mit der erwarteten Audiolautstärke.

Die Gerätelautstärke wird über die Lautstärketasten oder den Lautstärkeregler auf Betriebssystemebene 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 anzupassen.

Sie können das relative App-Volumen an das Google Mobile Ads SDK melden, indem Sie die Methode SetApplicationVolume() aufrufen. Gültige Werte für das Anzeigenvolumen reichen von 0.0 (leise) bis 1.0 (aktuelle Gerätelautstärke). Hier ein Beispiel dafür, wie das relative App-Volumen an das SDK gemeldet wird:

// Set app volume to be half of current device volume.
MobileAds.SetApplicationVolume(0.5f);

Warnung :Wenn Sie die Audiolautstärke Ihrer App verringern, werden weniger Videoanzeigen infrage kommen und dadurch möglicherweise auch der Werbeumsatz Ihrer App. Sie sollten diese Methode nur verwenden, wenn Ihre App dem Nutzer benutzerdefinierte Lautstärkeregler zur Verfügung stellt und die Lautstärke des Nutzers in der App korrekt wiedergegeben wird.

Verwenden Sie die Methode SetApplicationMuted(), um das SDK darüber zu informieren, dass das App-Volume stummgeschaltet wurde:

// Set app to be muted.
MobileAds.SetApplicationMuted(true);

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

Warnung :Wenn Sie Ihre App ignorieren, kommen dafür weniger Videoanzeigen infrage. Dies kann sich wiederum auf den Werbeumsatz Ihrer App auswirken. Sie sollten diese Methode nur verwenden, wenn Ihre App dem Nutzer eine benutzerdefinierte Stummschaltungsoption bietet und die Entscheidung zum Stummschalten des Nutzers in der App korrekt wiedergegeben wird.

Einwilligung zur Verwendung von Cookies

Wenn für Ihre App besondere Anforderungen gelten, können Sie den optionalen ApplicationPreferences-Schlüssel gad_has_consent_for_cookies auf null setzen, um die eingeschränkte Anzeigenausrichtung zu aktivieren:

// Enable limited ads (LTD)
ApplicationPreferences.SetInt("gad_has_consent_for_cookies", 0);

Android-Komprimierung

Mit dieser Unity-Veröffentlichungsoption können Sie die Reduzierung von Java-Code aktivieren. Wenn Sie die Komprimierung aktivieren, müssen Sie auch eine benutzerdefinierte Proguard-Datei erstellen, um Klassen zu behalten, auf die vom SDK verwiesen wird.

1. Benutzerdefinierte Proguard-Datei aktivieren

   Rufe Projekteinstellungen > Player > Android > Veröffentlichungseinstellungen > Build auf und wähle Folgendes aus:

   • Benutzerdefinierte Proguard-Datei

2. Öffnen Sie /Assets/Plugins/Android/proguard-user.txt und fügen Sie Folgendes hinzu:

-keep class com.google.** { public *; }