Google Mobile Ads Unity-Plug-in einrichten

Plattform auswählen: Android Neu Android iOS Unity Flutter

Mit dem Google Mobile Ads Unity-Plug-in können Unity-Entwickler Google Mobile Ads 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 mit einer Unity-App Einnahmen erzielen möchten.

Vorbereitung

  • Unity Editor 2019.4 oder höher verwenden
  • 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 23 oder höher
    • Android API-Level 35 oder höher

Das Android API-Level wird unter Project Settings > Player > Android > Other Settings > Other Settings 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

  1. Öffnen Sie die Einstellungen des Paketmanagers indem Sie im Unity-Menü die Option Edit > Project Settings > Package Manager auswählen.

  2. Fügen Sie OpenUPM als registrierte Registrierung zum Fenster „Package Manager“ hinzu:

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

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

  4. Wählen Sie im Drop-down-Menü für den Managerbereich die Option My Registries aus.

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

.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 neueste .unitypackage Version 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 jedem Feld die Ad Manager-App-ID für Android und iOS ein.

SDK initialisieren

Bevor Sie Anzeigen laden, muss Ihre App Google Mobile Ads Unity Plugin durch Aufruf von MobileAds.Initialize() initialisieren. 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.");

    // Google Mobile Ads events are raised off the Unity Main thread. If you need to
    // access UnityEngine objects after initialization,
    // use MobileAdsEventExecutor.ExecuteInUpdate(). For more information, see:
    // https://developers.google.com/admob/unity/global-settings#raise_ad_events_on_the_unity_main_thread
});
GoogleMobileAdsController.cs

Wenn Sie die Vermittlung verwenden, warten Sie, bis der Callback erfolgt ist, bevor Sie Anzeigen laden, um zu prüfen, ob alle Vermittlungsadapter initialisiert wurden.

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 Calls-to-Action in Ihren Apps anpassen können. Wenn Sie die Anzeige selbst gestalten, können Sie eine natürliche, unaufdringliche Anzeigendarstellung erstellen, die zu einer umfassenden 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