Jetzt loslegen

Mit dem Google Mobile Ads Unity-Plug-in können Unity-Entwickler mobile Google-Anzeigen 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 werden.

Dieser Leitfaden richtet sich an Publisher, die eine Unity-App monetarisieren möchten.

Voraussetzungen

  • Unity 2019.4 oder höher verwenden
  • So stellen Sie die App für iOS bereit:
    • Xcode 15.3 oder höher
    • Ausrichtung auf iOS 12.0 oder höher
    • CocoaPods
  • So stellen Sie sie unter Android bereit:
    • Mindestens Android API-Level 21 oder höher
    • Ziel-API-Level 31 oder höher

Das Android-API-Level wird unter Projekteinstellungen > Player > Android > Andere 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-Registry mit dem folgenden Befehl installieren:

openupm add com.google.ads.mobile

.unitypackage Plug-in-Asset entfernen

Wenn Sie von einer .unitypackage zu OpenUPM migrieren, müssen Sie die Assets vom alten Speicherort manuell 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 Unity-Menüoption Bearbeiten > Projekteinstellungen > Paketmanager auswählen.

  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-Menüoption Fenster > Paketmanager auswählen.

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

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

.unitypackage Plug-in-Asset entfernen

Wenn Sie von einer .unitypackage zu OpenUPM migrieren, müssen Sie die Assets vom alten Speicherort manuell 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. Importieren Sie die Datei .unitypackage, indem Sie die Unity-Menüoption Assets > Paket importieren > Benutzerdefiniertes Paket auswählen und alle Elemente importieren.

Externe Abhängigkeiten einbeziehen

Das Google Mobile Ads Unity-Plug-in wird mit der Unity Play Services-Resolver-Bibliothek bereitgestellt. Diese Bibliothek ist für die Verwendung mit jedem Unity-Plug-in vorgesehen, das Zugriff auf Android-spezifische Bibliotheken wie AARs oder iOS CocoaPods benötigt. Unity-Plug-ins können Abhängigkeiten deklarieren, die dann automatisch aufgelöst und in Ihr Unity-Projekt kopiert werden.

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

Android

Rufe Project Settings > Player > Android > Publishing Settings > Build (Projekteinstellungen > Player > Android > Veröffentlichungseinstellungen > Build) auf und wähle Folgendes aus:

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

Wählen Sie im Unity-Editor Assets > External Dependency Manager > Android Resolver > Resolve (Assets > Externer Abhängigkeitsmanager > 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

Unity for iOS verwendet CocoaPods zur Identifizierung und Verwaltung von Abhängigkeiten. Informationen zu spezifischen Anforderungen oder Schritten zur Fehlerbehebung im Zusammenhang mit deinen iOS-Abhängigkeiten findest du in der CocoaPods-Dokumentation.

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

App-ID AdMob festlegen

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

Geben Sie in jedes Feld Ihre AdMob-App-ID ein.

SDK initialisieren

Bitten Sie Ihre App, das Google Mobile Ads SDK zu initialisieren, bevor Anzeigen geladen werden. Rufen Sie dazu MobileAds.Initialize() auf. Dieser Vorgang muss nur einmal durchgeführt werden, idealerweise beim Start der App.

Hier ein Beispiel für den Aufruf von Initialize() in der Methode Start() eines Skripts, das an ein 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 stellen Sie sicher, dass alle Vermittlungsadapter initialisiert wurden.

Anzeigenformat auswählen

Das Google Mobile Ads SDK ist jetzt in Ihrer Unity-App bei der Bereitstellung auf der Android- oder iOS-Plattform enthalten. Jetzt können Sie eine Anzeige implementieren. AdMob bietet verschiedene Anzeigenformate, sodass Sie dasjenige auswählen können, das für die Nutzer am besten geeignet ist.

Banneranzeigenblöcke enthalten rechteckige Anzeigen, die einen Teil der App-Oberfläche einnehmen. Sie können nach einer bestimmten Zeit automatisch aktualisiert werden. Das bedeutet, dass Nutzer in regelmäßigen Abständen eine neue Anzeige sehen, auch wenn sie auf demselben Bildschirm in Ihrer App zu sehen sind. Dieses Anzeigenformat ist am einfachsten zu implementieren.

Banneranzeigen implementieren

Interstitial

Mit Interstitial-Anzeigenblöcken werden ganzseitige Anzeigen in Ihrer App bereitgestellt. Platzieren Sie sie an natürlichen Unterbrechungs- oder Übergangspunkten in der Benutzeroberfläche Ihrer App, beispielsweise nach Abschluss eines Levels in einer Gaming-App.

Interstitial-Anzeigen implementieren

Ich bin Muttersprachler

Bei nativen Anzeigen können Sie die Darstellung von Assets wie Anzeigentiteln und Calls-to-Action in Ihren Apps anpassen. Indem Sie die Anzeige selbst gestalten, können Sie eine natürliche, unaufdringliche Anzeigenpräsentation erstellen, die die Nutzererfahrung verbessert.

Native Anzeigen implementieren

Verfügbar

Mit Anzeigenblöcken mit Prämie können Nutzer Spiele spielen, an Umfragen teilnehmen oder sich Videos ansehen, um In-App-Prämien wie Münzen, Extraleben oder Punkte zu erhalten. Sie können verschiedene Prämien für verschiedene Anzeigenblöcke festlegen und angeben, welche Prämienwerte und Artikel der Nutzer erhalten hat.

Anzeigen mit Prämie implementieren

Interstitial mit Prämie

Interstitial-Anzeigen mit Prämie sind ein neues Anzeigenformat, bei dem Sie Nutzern Anreize wie Münzen oder Extraleben bieten können.

Im Gegensatz zu Anzeigen mit Prämie müssen Nutzer der Wiedergabe von Interstitials mit Prämie nicht zustimmen.

Anstelle der Aufforderung zur Aktivierung in Anzeigen mit Prämie ist bei Interstitials mit Prämie ein Eingangsbildschirm erforderlich, auf dem die Prämie angekündigt wird und Nutzer die Möglichkeit haben, die Anzeige zu deaktivieren, wenn sie das möchten.

Interstitial-Anzeigen mit Prämie implementieren

App-Start-Anzeige

App-Start-Anzeigen sind ein Anzeigenformat, das eingeblendet wird, wenn Nutzer die App öffnen oder zu ihr zurückkehren. Die Anzeige überlagert den Ladebildschirm.

App-Start-Anzeigen implementieren