Jetzt loslegen

Dieser Leitfaden richtet sich an Publisher, die eine Unity-App monetarisieren möchten.

Das Einbinden des Google Mobile Ads Unity-Plug-ins in eine App ist der erste Schritt, um AdMob-Anzeigen präsentieren und Einnahmen erzielen zu können. Sobald die Integration abgeschlossen ist, können Sie ein Anzeigenformat auswählen (z. B. native oder Videoanzeigen mit Prämie), um detaillierte Implementierungsschritte zu erhalten.

Voraussetzungen

Mobile Ads Unity-Plug-in herunterladen

Mit dem Google Unity-Plug-in für mobile Anzeigen können Unity-Entwickler ganz einfach Google Mobile-Anzeigen in Android- und iOS-Apps bereitstellen, ohne Java- oder Objective-C-Code schreiben zu müssen. Das Plug-in bietet eine C#-Schnittstelle zum Anfordern von Anzeigen, die von C#-Skripts in Ihrem Unity-Projekt verwendet werden.

Über die Links unten können Sie das Unity-Paket für das Plug-in herunterladen oder sich den Code auf GitHub ansehen.

Plug-in herunterladen QUELLE ANSEHEN

Mobile Ads Unity-Plug-in importieren

Öffnen Sie Ihr Projekt im Unity-Editor. Wählen Sie Assets > Import Package > Custom Package aus und suchen Sie die heruntergeladene Datei GoogleMobileAdsPlugin.unitypackage.

Achten Sie darauf, dass alle Dateien ausgewählt sind, und klicken Sie auf Importieren.

Mobile Ads SDK einbinden

Das Google Mobile Ads Unity-Plug-in ist in der Unity Play Services Resolver-Bibliothek enthalten. Diese Bibliothek ist für alle Unity-Plug-ins vorgesehen, die Zugriff auf Android-spezifische Bibliotheken (z.B. AAE) oder iOS-CocoaPods. Es bietet Unity-Plug-ins die Möglichkeit, Abhängigkeiten zu deklarieren, die dann automatisch aufgelöst und in Ihr Unity-Projekt kopiert werden.

Führen Sie die folgenden Schritte aus, um sicherzustellen, dass Ihr Projekt das Mobile Ads SDK enthält.

Android

Wählen Sie im Unity-Editor Assets > External Dependency Manager > Android Resolver > Resolve aus. Die Bibliothek für externe Unity-Abhängigkeitsmanager kopiert die deklarierten Abhängigkeiten in das Verzeichnis Assets/Plugins/Android Ihrer Unity-Anwendung.

iOS

Es sind keine zusätzlichen Schritte erforderlich, um das Mobile Ads SDK in das Unity-Projekt aufzunehmen.

  • Wenn Sie Unity 5.6 oder höher verwenden, wird ein xcworkspace erstellt, der die erforderlichen Abhängigkeitsbibliotheken enthält. Verwenden Sie das generierte xcworkspace anstelle des Xcode-Standardprojekts.
  • Wenn Sie ältere Versionen von Unity verwenden, sind die Abhängigkeiten im Xcode-Projekt enthalten.

AdMob-App-ID festlegen

Wählen Sie im Unity-Editor im Menü Assets > Google Mobile Ads > Settings (Assets > Google Mobile Ads > Settings) aus.

Geben Sie Ihre Android- und iOS-App-ID für AdMob ein.

Anzeigenereignisse im Unity-Hauptthread auslösen

Das Google Mobile Ads SDK löst manchmal Ereignisse in einem anderen Thread als dem Unity-Hauptthread aus. Das kann zu Problemen bei der Interaktion mit Unity-Objekten aus Ereignissen führen, die vom Google Mobile Ads SDK gesendet werden. Zur Umgehung des Problems müssen Sie möglicherweise Code hinzufügen, um die Ereignisse im Mobile Ads SDK mit dem Unity-Hauptthread zu synchronisieren.

Wenn das Mobile Ads SDK dieses Threading-Problem für Sie übernehmen soll, legen Sie MobileAds.RaiseAdEventsOnUnityMainThread auf true fest. Dadurch wird erzwungen, dass das Mobile Ads SDK alle Ereignisse und Callbacks im Unity-Hauptthread auslöst.

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

Mobile Ads SDK initialisieren

Bevor Sie Anzeigen laden, müssen Sie das Mobile Ads SDK durch Ihre App initialisieren. Rufen Sie dazu MobileAds.Initialize() auf. Dies muss nur einmal ausgeführt werden, idealerweise beim Start der App.

Hier ein Beispiel für den Aufruf von Initialize() innerhalb der Methode Start() eines Skripts, das an eine GameObject angehängt ist:

...
using GoogleMobileAds.Api;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize(initStatus => { });
    }
}

Wenn Sie die Vermittlung nutzen, warten Sie, bis der Callback ausgelöst wird, bevor Sie die Anzeigen laden, damit alle Vermittlungsadapter initialisiert werden.

Anzeigenformat auswählen

Das Mobile Ads SDK ist jetzt in Ihrer Unity-App enthalten, wenn es auf der Android- oder iOS-Plattform bereitgestellt wird. Sie können jetzt eine Anzeige implementieren. AdMob bietet verschiedene Anzeigenformate. Wählen Sie einfach das Anzeigenformat aus, das Ihren Anforderungen am besten entspricht.

Banneranzeigen sind rechteckige Bild- oder Textanzeigen, die einen Platz im Layout einer App einnehmen. Sie bleiben auf dem Bildschirm, während Nutzer mit der App interagieren, und können nach einer bestimmten Zeit automatisch aktualisiert werden. Wenn Sie noch nicht mit mobilen Anzeigen vertraut sind, ist das jetzt der erste Schritt.

Ein Banner implementieren

Interstitial

Interstitials sind Vollbildanzeigen, die die Benutzeroberfläche einer App überdecken, bis sie vom Nutzer geschlossen werden. Sie eignen sich am besten für natürliche Pausen während der Ausführung einer App, z. B. zwischen Levels eines Spiels oder kurz nach dem Ausführen einer Aufgabe.

Interstitials implementieren

Nativ

Native Anzeigen sind ein komponentenbasiertes Anzeigenformat, mit dem Sie anpassen können, wie Assets wie Anzeigentitel und Calls-to-Action in ihren Apps dargestellt werden. Wenn Sie Schriftarten, Farben und andere Details für sich selbst auswählen, können Sie natürliche, unaufdringliche Werbeanzeigen erstellen und so die Nutzererfahrung optimieren.

Native Anzeigen implementieren

Verfügbar

Videoanzeigen mit Prämie sind Vollbildvideoanzeigen, die sich Nutzer kostenlos ansehen können, um In-App-Prämien zu erhalten.

Anzeigen mit Prämie implementieren

Transparenzautorisierung für das App-Tracking anfordern

Mit dem Paket mit iOS 14-Werbeunterstützung von Unity können Sie die ATT-Autorisierungsanfrage (App Tracking Transparency) für den Zugriff auf den IDFA aufrufen.

App-interner Schlüssel (SameAppKey)

Voraussetzungen: Google Mobile Ads Unity-Plug-in 6.1.0 oder höher

Das Google Mobile Ads SDK führt den App-internen Schlüssel (SameAppKey) ein, mit dem Sie mithilfe der Daten, die vom Nutzer verwendet werden, relevantere und personalisierte Anzeigen ausliefern können.

Der SameAppKey ist standardmäßig aktiviert, kann aber mit der folgenden API deaktiviert werden:

public void Start()
    {
        RequestConfiguration requestConfiguration =
            new RequestConfiguration.Builder()
            .SetSameAppKeyEnabled(true).build();
        MobileAds.SetRequestConfiguration(requestConfiguration);

        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize(HandleInitCompleteAction);
    }