Jetzt loslegen

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

• Verwenden Sie Unity 2019.4 oder höher.
• 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 auf Android-Geräten
  • 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 > Weitere Einstellungen > Weitere 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

1. Öffnen Sie die Einstellungen des Paketmanagers, indem Sie die Unity-Menüoption Bearbeiten > Projekteinstellungen > Paketmanager auswählen.

2. Fügen Sie OpenUPM dem Fenster „Package Manager“ als eingeschränkte Registry hinzu:

   Name: OpenUPM
   URL: https://package.openupm.com
   Scopes: com.google
   

3. Öffnen Sie das Menü des Paketmanagers, indem Sie die Unity-Menüoption Fenster > Paketmanager auswählen.

4. Wählen Sie im Drop-down-Menü „Verwaltungskonto“ die Option Meine Registrierungen aus.

   

5. 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

1. Laden Sie die neueste .unitypackage-Version von GitHub herunter.
2. 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.

Wichtig:Verwenden Sie das neueste Google Mobile Ads SDK, damit Sie Zugriff auf alle Funktionen zur Einhaltung der Datenschutzanforderungen haben.

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.

Ad Manager App-ID festlegen

Wählen Sie im Unity-Editor das Menü Assets > Google Mobile Ads > Einstellungen aus.

Geben Sie in jedem Feld die Ad Manager-App-ID für iOS ein.

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.

Warnung :Anzeigen können vom Google Mobile Ads SDK oder den SDKs von Vermittlungspartnern beim Aufrufen von MobileAds.Initialize() vorab geladen werden. Wenn Sie die Einwilligung von Nutzern im Europäischen Wirtschaftsraum (EWR) einholen müssen, setzen Sie anfragespezifische Flags wie tagForChildDirectedTreatment oder tag_for_under_age_of_consent oder ergreifen Sie anderweitige Maßnahmen, bevor Anzeigen geladen werden. Führen Sie diese Schritte aus, bevor Sie das Google Mobile Ads SDK initialisieren.

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.

Banneranzeigen 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

Blöcke für Anzeigen 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