Jetzt loslegen

Mit dem Unity-Plug-in für Google Mobile Ads können Unity-Entwickler mobile Google-Anzeigen schalten in Android- und iOS-Apps ausführen, 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 eine Unity-App monetarisieren 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-API-Level von Android 21 oder höher
  • Ausrichtung auf Android API-Level 31 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-Asset 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 Paketmanager-Einstellungen. indem Sie die Menüoption „Unity“ Bearbeiten > Projekteinstellungen > Paketmanager.

2. Fügen Sie OpenUPM dem Paketmanager-Fenster als Bereichsregistrierung hinzu:

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

3. Öffnen Sie das Paketmanager-Menü, indem Sie die Unity-Datei Fenster > Paketmanager.

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

   

5. Wählen Sie das Paket Google Mobile Ads for Unity aus der Paketliste aus. und wähle Installieren aus.

.unitypackage Plug-in-Asset 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. Aktuelle Version von .unitypackage herunterladen von GitHub veröffentlicht.
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 zusammen mit den Unity Play-Diensten bereitgestellt Resolver-Bibliothek. Diese Bibliothek ist für die Verwendung mit jedem Unity-Plug-in vorgesehen, das Zugriff auf Android-spezifische wie AAE oder iOS CocoaPods. Unity-Plug-ins können jetzt um Abhängigkeiten zu deklarieren, die dann automatisch aufgelöst und in Ihr Unity-Projekt.

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

Führen Sie die folgenden Schritte aus, um sicherzustellen, dass Ihr Projekt alle Abhängigkeiten enthält:

Android

Gehen Sie zu Project Settings > Player > Android > Veröffentlichungseinstellungen > Erstellen und wählen Sie eine der folgenden Optionen aus:

• Benutzerdefinierte Gradle-Hauptvorlage
• Benutzerdefinierte Vorlage für Gradle-Eigenschaften

Wählen Sie im Unity-Editor Assets > Externer Abhängigkeitsmanager > Android-Geräte Resolver > Beheben, um die Unity External Dependency Manager-Bibliothek zu haben Deklarierte Abhängigkeiten in das Verzeichnis Assets/Plugins/Android kopieren Ihrer Unity-App.

iOS

In Unity for iOS werden Abhängigkeiten mit CocoaPods identifiziert und verwaltet. In der CocoaPods-Dokumentation finden Sie Anforderungen oder Schritte zur Fehlerbehebung für Ihr iOS-Gerät Abhängigkeiten.

Die Abhängigkeiten des Google Mobile Ads Unity-Plug-ins sind unter Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml

App-ID Ad Manager festlegen

Wählen Sie im Unity-Editor Assets > Google Mobile Anzeigen > Einstellungen aus.

Geben Sie Ihre Android- und iOS- Ad Manager-App-ID in die einzelnen Felder 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.

Achtung: Anzeigen können vom Google Mobile Ads SDK oder vom Vermittlungspartner vorab geladen werden. SDKs nach dem Aufruf von MobileAds.Initialize(). 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. Tun Sie dies vor dem Google Mobile Ads SDK initialisieren

Hier ein Beispiel für den Aufruf von Initialize() innerhalb der Start()-Methode eines Skripts, das an 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 Callback 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 bei der Bereitstellung auf Android- oder iOS-Plattform. Sie können jetzt eine Anzeige implementieren. AdMob verschiedene Anzeigenformate, sodass Sie das Format auswählen können, das für eine optimale User Experience.

Banner

Banneranzeigenblöcke enthalten rechteckige Werbeanzeigen, die einen Teil der Layout. 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. Platzieren Sie sie in einer natürlichen Unterbrechungen und Übergänge auf der Benutzeroberfläche Ihrer App, z. B. nach Abschluss eines Levels in einer Gaming-App.

Interstitial-Anzeigen implementieren

Nativ

Bei nativen Anzeigen können Sie anpassen, wie Assets wie Anzeigentitel und Call-to-Action in Ihren Apps präsentiert. Wenn Sie die Anzeige selbst gestalten, Erstellen Sie natürliche, unaufdringliche Anzeigenpräsentationen, die einen aussagekräftigen Nutzererfahrung.

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