Google Mobile Ads Unity-Plug-in einrichten

Mit dem Google Mobile Ads Unity-Plug-in können Unity-Entwickler mobile Google-Anzeigen in Android- und iOS-Apps ausliefern, 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.

Diese Anleitung richtet sich an Publisher, die eine Unity-App monetarisieren möchten.

Vorbereitung

  • Verwenden Sie Unity Editor 2019.4 oder höher.
    • Wir empfehlen Version 2022.2 oder höher.
  • Für die Bereitstellung auf iOS
    • Xcode 16.0 oder höher
    • iOS 13.0 oder höher
    • CocoaPods
  • Für die Bereitstellung auf Android
    • Android API-Level 24 oder höher
    • Android API-Level 35 oder höher

Das Android API-Level 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 der Verwendung eines .unitypackage zu OpenUPM migrieren, müssen Sie die Assets manuell vom alten Speicherort deinstallieren. Entfernen Sie die folgenden Verzeichnisse, die aus dem .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 mit Benutzeroberfläche

  1. Öffnen Sie die Einstellungen des Paketmanagers indem Sie die Unity-Menüoption Bearbeiten > Projekteinstellungen > Paketmanager auswählen.
  2. Fügen Sie OpenUPM als registrierte Registrierung zum Fenster „Paketmanager“ 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ü für den Managerbereich die Option Meine Registrierungen aus.

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

.unitypackage-Plug-in-Assets entfernen

Wenn Sie von der Verwendung eines .unitypackage zu OpenUPM migrieren, müssen Sie die Assets manuell vom alten Speicherort deinstallieren. Entfernen Sie die folgenden Verzeichnisse, die aus dem .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. Rufen Sie das Versions-Tag der neuesten Version ab. Das zurückgegebene Tag, ohne das v Präfix, ist die Google Mobile Ads Unity Plugin Version.

    • macOS und Linux

      curl -sS https://api.github.com/repos/googleads/googleads-mobile-unity/releases/latest | jq -r '.tag_name'
    • Windows PowerShell

      (Invoke-RestMethod -Uri "https://api.github.com/repos/googleads/googleads-mobile-unity/releases/latest").tag_name
      
  2. Ändern Sie die Datei Packages/manifest.json, um die registrierte OpenUPM-Registrierung und -Abhängigkeit mit der Version hinzuzufügen, die Sie mit dem vorherigen Befehl erhalten haben:

    {
      "scopedRegistries": [
        {
          "name": "google",
          "url": "https://package.openupm.com",
          "scopes": [
            "com.google"
          ]
        }
      ],
      "dependencies": {
        "com.google.ads.mobile": "11.6.0"
      }
    }
    

.unitypackage-Plug-in-Assets entfernen

Wenn Sie von der Verwendung eines .unitypackage zu OpenUPM migrieren, müssen Sie die Assets manuell vom alten Speicherort deinstallieren. Entfernen Sie die folgenden Verzeichnisse, die aus dem .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 .unitypackage Version von GitHub herunter.
  2. Importieren Sie die .unitypackage-Datei, indem Sie die Unity-Menüoption Assets > Paket importieren > Benutzerdefiniertes Paket auswählen und alle Elemente importieren.

Optional: External Dependency Manager deaktivieren

Wenn Sie Android- und iOS-Bibliotheken mit Ihren eigenen Build-Tools verwalten, können Sie das Paket com.unity.external-dependency-manager deaktivieren:

Wählen Sie im Unity-Editor Fenster > Paketmanager aus und entfernen Sie das Paket External Dependency Manager (com.unity.external-dependency-manager). Wenn Sie dieses Paket entfernen, wird die Option External Dependency Manager aktivieren unter Assets > Google Mobile Ads > Einstellungen deaktiviert.

Legacy-Version des External Dependency Manager installieren

Wenn Ihr Projekt Unity 2022.2 oder eine frühere Version verwendet, können Sie das Legacy-Paket com.google.external-dependency-manager von Google installieren, nachdem Sie das Unity-Paket deaktiviert haben:

  • Laden Sie die neueste .unitypackage-Datei von der Seite External Dependency Manager for Unity releases herunter und wählen Sie Assets > Paket importieren > Benutzerdefiniertes Paket aus.
  • Führen Sie den folgenden OpenUPM-CLI-Befehl aus:

    openupm add com.google.external-dependency-manager

Native Abhängigkeiten manuell konfigurieren

Wenn Sie kein External Dependency Manager-Paket verwenden, fügen Sie die erforderlichen Bibliotheken aus den Dateien Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml und Assets/GoogleMobileAds/Editor/GoogleUmpDependencies.xml zu Ihren Build-Dateien hinzu:

  • Wählen Sie unter Android Bearbeiten > Projekteinstellungen > Player > Android > Veröffentlichungseinstellungen > Build aus und aktivieren Sie Benutzerdefinierte Gradle-Hauptvorlage. Fügen Sie die erforderlichen Bibliotheken aus den Dateien GoogleMobileAdsDependencies.xml und GoogleUmpDependencies.xml dem Block dependencies in der Datei Assets/Plugins/Android/mainTemplate.gradle hinzu:

    implementation 'com.google.android.gms:play-services-ads:25.5.0'
    implementation 'com.google.android.ump:user-messaging-platform:4.0.0'
    

    Fügen Sie außerdem die Pakete androidx.constraintlayout:constraintlayout, androidx.lifecycle:lifecycle-process und androidx.fragment:fragment mit den Versionen in der Datei GoogleMobileAdsDependencies.xml hinzu.

  • Exportieren Sie unter iOS Ihr Xcode-Projekt. Fügen Sie die erforderlichen Pods aus den Dateien GoogleMobileAdsDependencies.xml und GoogleUmpDependencies.xml der Datei Podfile in Ihrem exportierten Projektordner hinzu:

    pod 'Google-Mobile-Ads-SDK'
    pod 'GoogleUserMessagingPlatform'
    

    Führen Sie dann den folgenden Befehl in Ihrem exportierten iOS-Projektordner aus:

    pod install --repo-update

AdMob-App-ID festlegen

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

Geben Sie in jedem Feld Ihre Android- und iOS AdMob-App-ID ein.

Google Mobile Ads Unity Plugin speichert diese Einstellungen als Text in der Assets/GoogleMobileAds/Resources/GoogleMobileAdsSettings.asset Konfigurationsdatei.

SDK initialisieren

Bevor Sie Anzeigen laden, muss Ihre App Google Mobile Ads Unity Plugin initialisieren, indem sie MobileAds.Initialize() aufruft. Dies muss nur einmal erfolgen, idealerweise beim Start der App.

Hier ein Beispiel für den Aufruf von MobileAds.Initialize():

MobileAds.Initialize((InitializationStatus initstatus) =>
{
    if (initstatus == null)
    {
        Debug.LogError("Google Mobile Ads initialization failed.");
        return;
    }

    Debug.Log("Google Mobile Ads initialization complete.");

    MobileAdsEventExecutor.ExecuteInUpdate(() =>
    {
        // Interact with UnityEngine objects on the main thread here.
    });
});

Mit Unity-Objekten im Hauptthread interagieren

Google Mobile Ads Unity Plugin löst Anzeigenereignisse in einem Hintergrundthread aus. Wenn Anzeigen-Callbacks mit Unity-Objekten wie UnityEngine interagieren, planen Sie diese Arbeit explizit im Unity-Hauptthread mit der Methode MobileAdsEventExecutor.ExecuteInUpdate ein. Weitere Informationen zur Implementierung finden Sie unter Anzeigenereignisse im Unity-Hauptthread auslösen.

Anzeigenformat auswählen

Google Mobile Ads Unity Plugin 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 das Format auswählen können, das die beste Nutzererfahrung bietet.

Banneranzeigenblöcke enthalten rechteckige Werbeanzeigen, die einen Teil der App-Oberfläche einnehmen. Sie können nach einer festgelegten Zeitspanne automatisch aktualisiert werden. 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

Native Anzeigen sind Anzeigen, bei denen Sie die Darstellung von Assets wie Überschriften und Call-to-Action-Elementen in Ihren Apps anpassen können. Wenn Sie die Anzeige selbst gestalten, können Sie eine natürliche, unaufdringliche Anzeigenpräsentation erstellen, die zu einer umfassenden Nutzererfahrung beiträgt.

Native Anzeigen implementieren

Verfügbar

Mit Anzeigenblöcken mit Prämie können Nutzer Spiele spielen, an Umfragen teilnehmen oder Videos ansehen, um In‑App-Prämien wie Münzen, zusätzliche Leben 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-Anzeigen sind 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