Google Mobile Ads Unity-Plug-in einrichten

Plattform auswählen: Android iOS Unity Flutter Android (Legacy)

Mit dem Google Mobile Ads Unity-Plug-in können Unity-Entwickler Google-Mobilanzeigen 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#-Scripts in Ihrem Unity-Projekt verwendet wird.

Dieser Leitfaden 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.
  • So stellen Sie die App für iOS bereit:
    • Xcode 16.0 oder höher
    • Auf iOS 13.0 oder höher ausgerichtet sein
    • CocoaPods
  • Bereitstellung für Android
    • Mindest-API-Level für Android 24 oder höher
    • Android-API-Level 35 oder höher anstreben

Die Android-API-Ebene wird unter Project Settings > Player > Android > Other Settings > Other Settings (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 .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 Paketmanager-Einstellungen, indem Sie im Unity-Menü Bearbeiten > Projekteinstellungen > Paketmanager auswählen.

  2. Fügen Sie OpenUPM als Bereichsregistrierung zum Package Manager-Fenster hinzu:

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

  3. Öffnen Sie das Paketmanager-Menü, indem Sie im Unity-Menü Window > Package Manager (Fenster > Paketmanager) auswählen.

  4. Wählen Sie im Drop-down-Menü für den Verwaltungskontobereich Meine Registrierungen aus.

  5. Wählen Sie das Paket Google Mobile Ads for Unity aus der Paketliste aus und klicken Sie auf Install (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 .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. Das Versionstag des letzten Releases abrufen Das zurückgegebene Tag ohne das Präfix v 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 OpenUPM-Registrierung und ‑Abhängigkeit mit dem Bereich hinzuzufügen. Verwenden Sie dazu die Version aus dem vorherigen Befehl:

    {
  "scopedRegistries": [
    {
      "name": "google",
      "url": "https://package.openupm.com",
      "scopes": [
        "com.google"
      ]
    }
  ],
  "dependencies": {
    "com.google.ads.mobile": "11.5.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 .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 das .unitypackage-Release von GitHub herunter.
  2. Importieren Sie die .unitypackage-Datei, indem Sie im Unity-Menü Assets > Import package > Custom Package auswählen und alle Elemente importieren.

Ad Manager-App-ID festlegen

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

Geben Sie in jedes Feld Ihre Ad Manager-App-ID für Android und iOS ein.

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

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 Haupt-Thread interagieren

Google Mobile Ads Unity Plugin löst Anzeigenereignisse in einem Hintergrundthread aus. Wenn Anzeigen-Callbacks mit Unity-Objekten wie UnityEngine interagieren, müssen Sie diese Vorgänge explizit für den Unity-Hauptthread planen. Verwenden Sie dazu die Methode MobileAdsEventExecutor.ExecuteInUpdate. 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 für die 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 für die beste Nutzerfreundlichkeit sorgt.

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 die Darstellung von Assets wie Anzeigentiteln und Calls-to-Action in Ihren Apps anpassen. Wenn Sie die Anzeige selbst gestalten, können Sie eine natürliche, unaufdringliche Darstellung erstellen, die zu einer positiven Nutzererfahrung beiträgt.

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 der Nutzer erhalten hat.

Anzeigen mit Prämie implementieren