Globale Einstellungen

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

Anzeigenereignisse im Unity-Hauptthread erfassen

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 Mobile Ads SDK-Ereignisse mit dem Unity-Hauptthread synchronisieren.

Wenn das Mobile Ads SDK diese Problembehandlung für Sie übernehmen soll, setzen Sie MobileAds.RaiseAdEventsOnUnityMainThread auf true. Dadurch wird das SDK gezwungen, alle Ereignisse und Rückrufe im Unity-Hauptthread zu starten.

...
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 :Wenn Ereignisse im Unity-Hauptthread ausgelöst werden, werden bestimmte Ereignisse wie OnAdFullScreenContentOpened erst ausgelöst, wenn der Nutzer zur App zurückkehrt.

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 festlegen, dass Videoanzeigen an die jeweils gewählte Lautstärke angepasst werden. So sehen Nutzer Videoanzeigen in der erwarteten Lautstärke.

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

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

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

Warnung :Wenn Sie die Lautstärke der Audioinhalte in Ihrer App verringern, sinkt die Eignung für Videoanzeigen und möglicherweise auch der Werbeumsatz Ihrer App. Sie sollten diese Methode nur verwenden, wenn Ihre App benutzerdefinierte Lautstärkeregler bietet und die Lautstärke des Nutzers in der App korrekt widergespiegelt wird.

Wenn du das SDK darüber informieren möchtest, dass die App-Lautstärke stummgeschaltet wurde, verwende die Methode SetApplicationMuted():

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

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

Warnung :Wenn Sie die Audiowiedergabe Ihrer App stummschalten, können keine Videoanzeigen ausgeliefert werden und die Werbeeinnahmen Ihrer App sinken möglicherweise. Sie sollten diese Methode nur verwenden, wenn Ihre App eine benutzerdefinierte Stummschaltungssteuerung bietet und die Stummschaltungsentscheidung des Nutzers in der App korrekt berücksichtigt wird.

Einwilligung für Cookies

Wenn Ihre App spezielle Anforderungen hat, können Sie den optionalen Schlüssel ApplicationPreferences auf null setzen, um eingeschränkte Anzeigen zu aktivieren:gad_has_consent_for_cookies

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

Android-Minimierung

Mit dieser Unity-Veröffentlichungsoption können Sie die Minimierung von Java-Code aktivieren. Wenn Sie die Minimierung 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

   Gehe zu Projekteinstellungen > Player > Android > Einstellungen für die Veröffentlichung > Build 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 *; }

Absturzberichte deaktivieren

Das Google Mobile Ads SDK erfasst Absturzberichte zu Debug- und Analysezwecken. Sie können diese Absturzberichte mit dem folgenden Code deaktivieren. In den folgenden Abschnitten wird beschrieben, wie Sie die Absturzberichte auf Android- und iOS-Geräten deaktivieren.

Android

Fügen Sie das <meta-data>-Tag mit DISABLE_CRASH_REPORTING = true in der AndroidManifest.xml-Datei Ihrer App hinzu:

<manifest>
   <application>
       <meta-data
           android:name="com.google.android.gms.ads.flag.DISABLE_CRASH_REPORTING"
           android:value="true" />
   </application>
</manifest>

iOS

Rufen Sie die Methode DisableSDKCrashReporting auf, um Absturzberichte auf iOS-Geräten zu deaktivieren:

void Awake() {
  MobileAds.DisableSDKCrashReporting();
}