Mit Ihrem Feedback können Sie die Google Mobile Ads SDK-Roadmap mitgestalten. Nehmen Sie an der jährlichen Umfrage zum Google Mobile Ads SDK für 2023 teil, die bis zum 5. Mai 2023 endet.

Jetzt starten

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

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 schalten und Einnahmen erzielen zu können. Sobald die Integration abgeschlossen ist, kannst du ein Anzeigenformat auswählen (z. B. native oder Anzeigen mit Prämie), um detaillierte Implementierungsschritte zu erhalten.

Vorbereitung

Mobile Ads Unity-Plug-in herunterladen

Mit dem Unity-Plug-in für Google Mobile Ads können Unity-Entwickler ganz einfach Google Mobile Ads 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 wird.

Über die folgenden Links können Sie das Unity-Paket für das Plug-in herunterladen oder 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 Datei GoogleMobileAdsPlugin.unitypackage, die Sie heruntergeladen haben.

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 wird mit der Unity Play Services Resolver-Bibliothek bereitgestellt. Diese Bibliothek ist für die Verwendung durch alle Unity-Plug-ins vorgesehen, die Zugriff auf Android-spezifische Bibliotheken benötigen (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, damit 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 Abhängigkeiten von Unity kopiert die deklarierten Abhängigkeiten in das Verzeichnis Assets/Plugins/Android Ihrer Unity-Anwendung.

aufgeführt.

iOS

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

  • Wenn Sie Unity 5.6 und 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-Standardprojekt enthalten.

AdMob-App-ID festlegen

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

Geben Sie in jedem Feld Ihre Android- und iOS-App-ID ein.

Anzeigenereignisse im Unity-Hauptthread auslösen

Das Google Mobile Ads SDK löst manchmal Ereignisse in einem anderen Thread als dem Uny-Hauptthread aus. Das kann zu Problemen bei der Interaktion mit Unity-Objekten über Ereignisse 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 des Mobile Ads SDK mit dem Unity-Hauptthread zu synchronisieren.

Wenn Sie möchten, dass das Mobile Ads SDK diese Threading-Bedenken übernimmt, 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 du Anzeigen lädst, muss deine App das Mobile Ads SDK durch Aufrufen von MobileAds.Initialize() initialisieren. Dies muss nur einmal geschehen, idealerweise beim Start der Anwendung.

Hier ein Beispiel für den Aufruf von Initialize() in 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 mit dem Laden der Anzeigen, bis der Callback erfolgt. Dadurch wird sichergestellt, dass alle Vermittlungsadapter initialisiert werden.

Anzeigenformat auswählen

Das Mobile Ads SDK ist jetzt in der Unity-App enthalten, wenn es auf der Android- oder iOS-Plattform bereitgestellt wird. Sie können jetzt eine Anzeige implementieren. AdMob bietet verschiedene Anzeigenformate, damit Sie das für Ihre Anforderungen am besten geeignete Format auswählen können.

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 mobiler Werbung vertraut sind, ist das ein guter Ausgangspunkt.

Banner implementieren

Interstitial

Interstitials sind Vollbildanzeigen, die die Benutzeroberfläche einer App verdecken, bis sie vom Nutzer geschlossen werden. Sie werden am besten bei natürlichen Pausen während der Ausführung einer App eingesetzt, z. B. zwischen Levels eines Spiels oder kurz nach Erledigung einer Aufgabe.

Interstitial-Anzeigen implementieren

Nativ

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

Native Anzeigen implementieren

Verfügbar

Videoanzeigen mit Prämie sind Vollbildvideoanzeigen, die Nutzer gegen Bezahlung für In-App-Prämien ansehen können.

Anzeigen mit Prämie implementieren

Autorisierung für App-Tracking-Transparenz anfordern

Wenn Sie die ATT-Autorisierungsanfrage (App Tracking Transparency) für den Zugriff auf den IDFA anzeigen möchten, verwenden Sie das Werbepaket für iOS 14 von Unity.

Schlüssel derselben App

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

Mit dem Google Mobile Ads SDK wird derselbe App-Schlüssel eingeführt. Damit können mithilfe der von der App erfassten Daten relevantere und personalisierte Anzeigen ausgeliefert werden.

Derselbe App-Schlüssel 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);
    }