GMA Next-Gen SDK einrichten

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

Die Einbindung von GMA Next-Gen SDK in eine App ist der erste Schritt, um Anzeigen auszuliefern und Einnahmen zu erzielen. Nachdem Sie das SDK eingebunden haben, können Sie ein Anzeigenformat auswählen (z. B. nativ oder Video mit Prämie) und die Schritte zur Implementierung ausführen.

Hinweis

Führen Sie die Schritte in den folgenden Abschnitten aus, um Ihre App vorzubereiten.

Voraussetzungen für Apps

  • Achten Sie darauf, dass die Build-Datei Ihrer App die folgenden Werte verwendet:

    • Mindest-SDK-Version 24 oder höher
    • Kompilierungs-SDK-Version 35 oder höher
  • Verwenden Sie für Kotlin-Apps mindestens die Kotlin-Version 1.9.

Eigene App konfigurieren

  1. Fügen Sie in der Gradle-Einstellungsdatei das Maven-Repository von Google und Maven Central Repository ein:

    Kotlin

    pluginManagement {
  repositories {
    google()
    mavenCentral()
    gradlePluginPortal()
  }
}

dependencyResolutionManagement {
  repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
  repositories {
    google()
    mavenCentral()
  }
}

rootProject.name = "My Application"
include(":app")

    Groovy

    pluginManagement {
  repositories {
    google()
    mavenCentral()
    gradlePluginPortal()
  }
}

dependencyResolutionManagement {
  repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
  repositories {
    google()
    mavenCentral()
  }
}

rootProject.name = "My Application"
include ':app'

  2. Fügen Sie der Build-Datei auf App-Ebene die Abhängigkeiten für GMA Next-Gen SDK hinzu:

    Kotlin

    dependencies {
  implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0")
}

    Groovy

    dependencies {
  implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0'
}

  3. Klicken Sie auf Jetzt synchronisieren. Weitere Informationen zur Synchronisierung finden Sie unter Projekte mit Gradle-Dateien synchronisieren.

GMA Next-Gen SDK initialisieren

Rufen Sie MobileAds.initialize() auf, um GMA Next-Gen SDK zu initialisieren. Dies muss in einem Hintergrundthread aufgerufen werden. Andernfalls kann ein ANR-Fehler (App antwortet nicht) auftreten.

Kotlin

import com.google.android.libraries.ads.mobile.sdk.MobileAds
import com.google.android.libraries.ads.mobile.sdk.initialization.InitializationConfig
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.launch

class MainActivity : AppCompatActivity() {
  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)

    val backgroundScope = CoroutineScope(Dispatchers.IO)
    backgroundScope.launch {
      // Initialize GMA Next-Gen SDK on a background thread.
      MobileAds.initialize(
        this@MainActivity,
        // Sample Ad Manager app ID: ca-app-pub-3940256099942544~3347511713
        InitializationConfig.Builder("SAMPLE_APP_ID").build()
      ) {
        // Adapter initialization is complete.
      }
      // SDK initialization is complete. If you don't want to wait for bidding adapters to finish
      // initializing, start loading ads now.
    }
  }
}

Java

import com.google.android.libraries.ads.mobile.sdk.MobileAds;
import com.google.android.libraries.ads.mobile.sdk.initialization.InitializationConfig;

public class MainActivity extends AppCompatActivity {
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    new Thread(
            () -> {
              // Initialize GMA Next-Gen SDK on a background thread.
              MobileAds.initialize(
                  this,
                  // Sample Ad Manager app ID: ca-app-pub-3940256099942544~3347511713
                  new InitializationConfig.Builder("SAMPLE_APP_ID")
                      .build(),
                  initializationStatus -> {
                    // Adapter initialization is complete.
                  });
              // SDK initialization is complete. If you don't want to wait for bidding adapters to
              // finish initializing, start loading ads now.
            })
        .start();
  }
}

Diese Methode initialisiert das SDK und ruft einen Abschluss-Listener auf, sobald die Initialisierung des GMA Next-Gen SDK und des Adapters abgeschlossen ist oder nach einer 30-sekündigen Zeitüberschreitung. Dies muss nur einmal erfolgen, idealerweise beim Start der App.

Wenn Sie die Vermittlung verwenden, warten Sie, bis der Abschluss-Handler aufgerufen wird, bevor Sie Anzeigen laden. So wird sichergestellt, dass alle Vermittlungsadapter initialisiert werden.

Anzeigen können beim Initialisieren von GMA Next-Gen SDK oder von SDKs von Vermittlungspartnern vorab geladen werden. Wenn Sie die Einwilligung von Nutzern im Europäischen Wirtschaftsraum (EWR), im Vereinigten Königreich oder in der Schweiz einholen müssen, legen Sie anfragespezifische Flags wie RequestConfiguration.TagForChildDirectedTreatment oder RequestConfiguration.TagForUnderAgeOfConsent, oder ergreifen Sie andere Maßnahmen, bevor Sie Anzeigen laden. Achten Sie darauf, dass Sie dies vor der Initialisierung von GMA Next-Gen SDKtun.

Anzeigenformat auswählen

GMA Next-Gen SDK wurde jetzt importiert und Sie können eine Anzeige implementieren. In Ad Manager stehen verschiedene Anzeigenformate zur Auswahl. Sie können das Format auswählen, das am besten zur Nutzererfahrung Ihrer App passt.

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

Bei nativen Anzeigen können Sie die Darstellung von Assets wie Überschriften und Call-to-Action-Elementen in Ihren Apps anpassen. Wenn Sie die Anzeige selbst gestalten, können Sie eine natürliche, unaufdringliche Präsentation erstellen, die die Nutzererfahrung verbessert.

In Google Ad Manager gibt es zwei Möglichkeiten, native Anzeigen zu implementieren: native Designs und standardmäßige native Anzeigen durch benutzerdefiniertes Rendering.

Native Designs wurden entwickelt, um die Implementierung nativer Anzeigen zu vereinfachen. Sie sind eine gute Wahl, wenn Sie noch keine Erfahrung mit diesem Format haben. Benutzerdefiniertes Rendering bietet Ihnen maximale Freiheit bei der Gestaltung Ihrer Präsentationen.

Native Designs implementieren Native Anzeigen implementieren (benutzerdefiniertes Rendering)

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 der Nutzer erhält.

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 Opt-in-Aufforderung bei Anzeigen mit Prämie erfordern Interstitials mit Prämie einen Eingangsbildschirm, auf dem die Prämie angekündigt wird und Nutzer die Möglichkeit haben, sich abzumelden, wenn sie dies wünschen.

Interstitial-Anzeigen mit Prämie implementieren

App-Start

App-Start-Anzeigen sind ein Anzeigenformat, das eingeblendet wird, wenn Nutzer Ihre App öffnen oder zu ihr zurückwechseln. Die Anzeige wird als Overlay über dem Ladebildschirm eingeblendet.

App-Start-Anzeigen implementieren

Bild im Bild (Beta)

Bild im Bild

Bei Bild-im-Bild-Anzeigen wird eine Anzeige in einem schwebenden Fenster präsentiert, das über dem Inhalt auf dem Bildschirm angezeigt wird. Mit diesem Format können Nutzer mit Ihrer App interagieren, während die Anzeige sichtbar bleibt.

Bild-im-Bild-Anzeigen implementieren