Globale Einstellungen

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

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

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

Sie können Anzeigenereignisse entweder manuell oder automatisch mit dem Unity-Hauptthread synchronisieren. Im letzteren Fall übernimmt das Google Mobile Ads SDK die Synchronisierung.

Empfohlen: Anzeigenereignisse manuell synchronisieren

Wenn Sie Anzeigenereignisse manuell synchronisieren möchten, verwenden Sie die Methode ExecuteInUpdate im Hauptthread. Sie müssen die Methode ExecuteInUpdate verwenden, wenn Sie mit UnityEngine-Objekten interagieren und die Property RaiseAdEventsOnUnityMainThread deaktiviert ist.

Im folgenden Beispiel wird ein Hintergrundthread protokolliert und eine Aktion ausgeführt, um mit UnityEngine-Objekten zu interagieren:

rewardedAd.OnAdPaid += (AdValue value) =>
{
    // Log the ad value immediately.
    // Place all time-sensitive code outside of ExecuteInUpdate().
    UnityEngine.Debug.Log($"Received ad value of {value.Value} {value.CurrencyCode}.");

    MobileAdsEventExecutor.ExecuteInUpdate(() =>
    {
        // Interact with UnityEngine objects here.
        // This method is delayed, don't put time sensitive code here.
    });
};

Wichtig :Die Unity-Update()-Schleife verzögert den gesamten Code, der sich in der ExecuteInUpdate-Methode befindet. Sie müssen den gesamten zeitkritischen Code, z. B. Telemetrie oder Werbeeinnahmen auf Impressionsebene, außerhalb der ExecuteInUpdate-Methode platzieren.

Synchronisierung bei Anzeigenereignissen automatisieren

Damit das Google Mobile Ads SDK Anzeigenereignisse synchronisieren kann, müssen Sie die MobileAds.RaiseAdEventsOnUnityMainThread-Property auf true festlegen:

...
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;
    }
}

Warnung :Wenn Sie MobileAds.RaiseAdEventsOnUnityMainThread auf einen true-Wert festlegen, werden Anzeigenereignisse, die ausgelöst werden, während Ihr Spiel pausiert oder im Hintergrund ausgeführt wird, verzögert, bis der Nutzer zum Spiel zurückkehrt. Wenn der Nutzer die App in dieser Zeit schließt, werden diese verzögerten Anzeigenereignisse vollständig verworfen. Bei Publishern, die MobileAds.RaiseAdEventsOnUnityMainThread auf true festlegen, kann es zu Abweichungen von bis zu 30 % bei Berichten zu Werbeeinnahmen auf Impressionsebene kommen. Empfehlung:Synchronisieren Sie einzelne Anzeigenereignisse manuell.

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 werden Nutzern Videoanzeigen in der erwarteten Lautstärke präsentiert.

Die Lautstärke des Geräts, 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 jedoch unabhängig voneinander die Lautstärkepegel relativ zur Gerätelautstärke anpassen, um das Audioerlebnis zu optimieren.

Sie können die relative App-Lautstärke an das Google Mobile Ads SDK melden, indem Sie die Methode SetApplicationVolume() aufrufen, bevor Sie die Anzeige laden. 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 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 Ihrer App verringern, können weniger Videoanzeigen ausgeliefert werden. Das kann sich auf die Werbeeinnahmen Ihrer App auswirken. 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 richtig wiedergegeben wird.

Rufen Sie die Methode SetApplicationMuted() auf, bevor Sie die Anzeige laden, um dem SDK mitzuteilen, dass die Lautstärke der App stummgeschaltet wurde:

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

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

Warnung :Wenn Sie Ihre App stummschalten, kann dies die Eignung für Videoanzeigen und die Werbeeinnahmen Ihrer App verringern. Sie sollten diese Methode nur verwenden, wenn Ihre App dem Nutzer eine benutzerdefinierte Stummschaltungssteuerung bietet und die Entscheidung des Nutzers zur Stummschaltung in der App richtig wiedergegeben wird.

Einwilligung für Cookies

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

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

Android-Minifizierung

Mit dieser Unity-Veröffentlichungsoption können Sie die Java-Code-Minimierung aktivieren. Wenn Sie die Minimierung aktivieren, müssen Sie auch eine benutzerdefinierte ProGuard-Datei erstellen, um Klassen beizubehalten, auf die vom SDK verwiesen wird.

1. Benutzerdefinierte ProGuard-Datei aktivieren

   Gehen Sie zu Projekteinstellungen > Player > Android > Veröffentlichungseinstellungen > Build und wählen Sie 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 Debugging- und Analysezwecken. Sie können diese Absturzberichte mit dem folgenden Code deaktivieren. In den folgenden Abschnitten wird beschrieben, wie Sie die Absturzberichterstattung unter Android und iOS deaktivieren.

Android

Fügen Sie der Datei AndroidManifest.xml Ihrer App das <meta-data>-Tag mit DISABLE_CRASH_REPORTING auf true gesetzt 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 unter iOS zu deaktivieren:

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

Unity-Plug-in-Version abrufen

Führen Sie den folgenden Befehl aus, um die Unity SDK-Version abzurufen:

// Get the unity SDK version.
Debug.Log("Unity SDK Version: " + MobileAds.GetVersion());

Plattformversion abrufen

Das Google Mobile Ads SDK für Unity ist von den Android- und iOS-Plattform-SDKs abhängig. Führen Sie den folgenden Befehl aus, um die Version des Plattform-SDK abzurufen:

// Get the underlying platform SDK version.
Debug.Log("Platform SDK Version: " + MobileAds.GetPlatformVersion());