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
- Unity 2019 oder höher verwenden
- Für die Bereitstellung unter iOS
- Xcode 13.2.1 oder höher
- Ausrichtung auf iOS 10.0 oder höher
- CocoaPods
- Für die Bereitstellung unter Android
- Google Play-Dienste 18.1.0 oder höher
- Ziel-API-Level 16 oder höher
- Empfohlen: Erstellen Sie ein AdMob-Konto und registrieren Sie eine Android- und/oder iOS-App.
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.
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.
Banner
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.
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); }