Mit dem Google Mobile Ads Unity-Plug-in können Unity-Entwickler mobile Google-Anzeigen in Android- und iOS-Apps schalten, ohne Java- oder Objective-C-Code schreiben zu müssen. Das Plug-in bietet eine C#-Schnittstelle zum Anfordern von Anzeigen, die von C#-Scripts in Ihrem Unity-Projekt verwendet wird.
Dieser Leitfaden richtet sich an Publisher, die mit einer Unity-App Einnahmen erzielen möchten.
Vorbereitung
- Unity 2019.4 oder höher verwenden
- Für die Bereitstellung auf iOS-Geräten:
- Xcode 15.3 oder höher
- iOS 12.0 oder höher als Zielversion festlegen
- CocoaPods
- Bereitstellung für Android
- Mindest-Android-API-Level 21 oder höher
- Ausrichtung auf Android API-Level 34 oder höher
Die Android-API-Ebene wird unter Projekteinstellungen > Player > Android > Sonstige Einstellungen > Sonstige Einstellungen festgelegt.
Mobile Ads for Unity-Plug-in importieren
OpenUPM-CLI
Wenn Sie die OpenUPM-CLI installiert haben, können Sie die OpenUPM-Registrierung mit dem folgenden Befehl installieren:
openupm add com.google.ads.mobile
.unitypackage
Plug-in-Assets entfernen
Wenn Sie von .unitypackage
zu OpenUPM migrieren, müssen Sie die Assets manuell vom alten Speicherort deinstallieren. Entfernen Sie die folgenden Verzeichnisse, die aus .unitypackage
importiert wurden:
- Assets/ExternalDependencyManager
- Assets/GoogleMobileAds
- Assets/Plugins/Android/googlemobileads-unity.aar
- Assets/Plugins/Android/GoogleMobileAdsPlugin
- Assets/Plugins/iOS/GADUAdNetworkExtras
- Assets/Plugins/iOS/unity-plugin-library.a
OpenUPM
- Öffnen Sie die Einstellungen des Paketmanagers, indem Sie die Unity-Menüoption Bearbeiten > Projekteinstellungen > Paketmanager auswählen.
Fügen Sie OpenUPM dem Fenster „Package Manager“ als eingeschränkte Registry hinzu:
Name: OpenUPM URL: https://package.openupm.com Scopes: com.google
Öffnen Sie das Menü des Paketmanagers, indem Sie die Unity-Menüoption Fenster > Paketmanager auswählen.
Wählen Sie im Drop-down-Menü „Verwaltungskonto“ die Option Meine Registrierungen aus.
Wählen Sie in der Paketliste das Paket Google Mobile Ads für Unity aus und klicken Sie auf Installieren.
.unitypackage
Plug-in-Assets entfernen
Wenn Sie von .unitypackage
zu OpenUPM migrieren, müssen Sie die Assets manuell vom alten Speicherort deinstallieren. Entfernen Sie die folgenden Verzeichnisse, die aus .unitypackage
importiert wurden:
- Assets/ExternalDependencyManager
- Assets/GoogleMobileAds
- Assets/Plugins/Android/googlemobileads-unity.aar
- Assets/Plugins/Android/GoogleMobileAdsPlugin
- Assets/Plugins/iOS/GADUAdNetworkExtras
- Assets/Plugins/iOS/unity-plugin-library.a
Aus GitHub importieren
- Laden Sie die neueste
.unitypackage
-Version von GitHub herunter. - Importiere die
.unitypackage
-Datei, indem du die Unity-Menüoption Assets > Import Package > Custom Package auswählst und alle Elemente importierst.
Externe Abhängigkeiten einbeziehen
Das Google Mobile Ads Unity-Plug-in wird mit der Unity Play Services Resolver Library ausgeliefert. Diese Bibliothek ist für alle Unity-Plug-ins gedacht, die Zugriff auf Android-spezifische Bibliotheken wie AARs oder iOS-CocoaPods benötigen. Damit können Unity-Plug-ins Abhängigkeiten deklarieren, die dann automatisch aufgelöst und in Ihr Unity-Projekt kopiert werden.
So prüfen Sie, ob Ihr Projekt alle Abhängigkeiten enthält:
Android
Gehen Sie zu Projekteinstellungen > Player > Android > Veröffentlichungseinstellungen > Build und wählen Sie Folgendes aus:
- Benutzerdefinierte Haupt-Gradle-Vorlage
- Vorlage für benutzerdefinierte Gradle-Properties
Wählen Sie im Unity-Editor Assets > External Dependency Manager > Android Resolver > Resolve aus, damit die Unity External Dependency Manager-Bibliothek die deklarierten Abhängigkeiten in das Verzeichnis Assets/Plugins/Android
Ihrer Unity-App kopiert.
iOS
In Unity for iOS werden Abhängigkeiten mit CocoaPods identifiziert und verwaltet. In der CocoaPods-Dokumentation finden Sie spezifische Anforderungen oder Schritte zur Fehlerbehebung im Zusammenhang mit Ihren iOS-Abhängigkeiten.
Die Abhängigkeiten des Google Mobile Ads Unity-Plug-ins sind in Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml
aufgeführt.
AdMob App-ID festlegen
Wählen Sie im Unity-Editor das Menü Assets > Google Mobile Ads > Einstellungen aus.
Geben Sie in jedem Feld die AdMob-App-ID für Android und die
SDK initialisieren
Bevor Anzeigen geladen werden, muss Ihre App das Google Mobile Ads SDK initialisieren, indem MobileAds.Initialize()
aufgerufen wird. Dies muss nur einmal erfolgen, idealerweise bei der App-Einführung.
Hier ein Beispiel für den Aufruf von Initialize()
innerhalb der Start()
-Methode eines Scripts, 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 verwenden, warten Sie, bis der Rückruf erfolgt, bevor Sie Anzeigen laden. So wird sichergestellt, dass alle Vermittlungsadapter initialisiert sind.
Anzeigenformat auswählen
Das Google Mobile Ads SDK ist jetzt in Ihrer Unity-App enthalten, wenn Sie sie auf der Android- oder iOS-Plattform bereitstellen. Sie können jetzt eine Anzeige implementieren. AdMob bietet eine Reihe verschiedener Anzeigenformate, sodass Sie dasjenige auswählen können, das die beste Nutzererfahrung bietet.
Banner
Banneranzeigenblöcke enthalten rechteckige Werbeanzeigen, die einen Teil der App-Oberfläche einnehmen. und nach einer festgelegten Zeitspanne automatisch aktualisiert werden können. Damit sehen Nutzer an derselben Stelle regelmäßig neue Werbung, auch wenn sie nicht zu einem anderen Bereich der App wechseln. Dieses Anzeigenformat ist außerdem am einfachsten zu implementieren.
Interstitial
Mit Interstitial-Anzeigenblöcken werden ganzseitige Anzeigen in Ihrer App bereitgestellt. Die Anzeigenblöcke sollten an natürlichen Unterbrechungs- oder Übergangspunkten platziert werden, z. B. in einer Gaming-App nach Abschluss eines Levels.
Interstitial-Anzeigen implementieren
Nativ
Bei nativen Anzeigen können Sie anpassen, wie Assets wie Anzeigentitel und Calls-to-Action in Ihren Apps präsentiert werden. Wenn Sie die Anzeige selbst gestalten, können Sie natürliche, unaufdringliche Anzeigen erstellen, die die Nutzerfreundlichkeit verbessern.
Native Anzeigen implementieren
Verfügbar
Anzeigenblöcke mit Prämie geben Nutzern die Möglichkeit, Spiele zu spielen, an Umfragen teilzunehmen oder sich Videos anzusehen und im Gegenzug In-App-Prämien wie Münzen, Extraleben oder Punkte zu erhalten. Sie können je nach Anzeigenblock verschiedene Prämien festlegen und angeben, welche Prämienwerte oder -artikel die Nutzer erhalten.
Anzeigen mit Prämie implementieren
Interstitial mit Prämie
Interstitials mit Prämie sind ein neues, auf Incentives basierendes Anzeigenformat, das automatisch an natürlichen Übergangspunkten in einer App ausgeliefert wird. Sie können damit Nutzer, die sich die Werbung ansehen, mit Münzen oder Extraleben belohnen.
Anders als bei Anzeigen mit Prämie müssen Nutzer nicht zustimmen, sich Interstitials mit Prämie anzusehen.
Anstatt der Aufforderung zur Zustimmung muss ein Eingangsbildschirm eingeblendet werden, auf dem Nutzer die versprochene Prämie sehen und sich gegen das Ansehen der Anzeige entscheiden können.
Interstitial-Anzeigen mit Prämie implementieren
App-Start
„App-Start“ ist ein Anzeigenformat, das präsentiert wird, wenn ein Nutzer Ihre App öffnet oder zu ihr zurückwechselt. Die Anzeige wird als Overlay über dem Ladebildschirm eingeblendet.
App-Start-Anzeigen implementieren