GMA Next-Gen SDK einrichten

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

Die Einbindung des GMA Next-Gen SDK in eine App ist der erste Schritt, um Anzeigen zu präsentieren und Einnahmen zu erzielen. Nachdem Sie das SDK integriert haben, können Sie ein Anzeigenformat auswählen (z. B. nativ oder Videoanzeige 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 die App

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

  • SDK-Mindestversion: 24 oder höher
  • SDK-Version kompilieren: 35 oder höher

• Verwenden Sie für Kotlin-Apps mindestens die Kotlin-Version 1.9.

App in Ihrem AdMob-Konto einrichten

So registrieren Sie Ihre App als AdMob-App:

1. Melden Sie sich in Ihrem AdMob-Konto an oder registrieren Sie sich für ein AdMob-Konto.

2. Registrieren Sie Ihre App bei AdMob. In diesem Schritt wird eine AdMob-App mit einer eindeutigen AdMob-App-ID erstellt, die später in diesem Leitfaden benötigt wird.

Eigene App konfigurieren

1. Fügen Sie in der Gradle-Einstellungsdatei das Maven-Repository von Google und das 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.6.0")
   }

   Groovy

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

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

GMA Next-Gen SDK initialisieren

Wichtig: Sie müssen GMA Next-Gen SDK initialisieren, bevor Sie Anzeigen laden und mit anderen MobileAds-Methoden interagieren, sofern in der API-Referenzdokumentation nicht ausdrücklich anders angegeben (siehe getVersion()). Andernfalls wird möglicherweise ein UninitializedPropertyAccessException ausgelöst.

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

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 AdMob 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 AdMob 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();
  }
}

Mit dieser Methode wird das SDK initialisiert und ein Abschluss-Listener aufgerufen, sobald sowohl die GMA Next-Gen SDK- als auch die Adapterinitialisierung abgeschlossen ist oder nach einer 30-sekündigen Zeitüberschreitung. Dies muss nur einmal erfolgen, idealerweise beim Start der App.

Wenn Sie AdMob Mediation verwenden, warten Sie, bis der Completion-Handler aufgerufen wird, bevor Sie Anzeigen laden. So wird sichergestellt, dass alle Vermittlungsadapter initialisiert werden.

Hinweis: Für das Google User Messaging Platform (UMP) SDK ist die App-ID in der AndroidManifest.xml-Datei Ihrer App erforderlich. Weitere Informationen finden Sie unter Anwendungs-ID hinzufügen.

Anzeigen können bei der Initialisierung durch GMA Next-Gen SDK oder 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, anfragespezifische Flags wie RequestConfiguration.TagForChildDirectedTreatment oder RequestConfiguration.TagForUnderAgeOfConsent festlegen oder andere Maßnahmen ergreifen müssen, bevor Anzeigen geladen werden, sollten Sie dies vor der Initialisierung von GMA Next-Gen SDK tun.

Wählen Sie ein Anzeigenformat aus.

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

Banner

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 Überschriften und Calls-to-Action in Ihren Apps anpassen. Wenn Sie die Anzeige selbst gestalten, können Sie eine natürliche, unaufdringliche Anzeigenpräsentation erstellen, die zu einer positiven Nutzererfahrung beitragen kann.

Native Anzeigen implementieren

Verfügbar

Mit Anzeigenblöcken für Anzeigen 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 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 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-Anzeige

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

Bild im Bild (Beta)

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

Bild-im-Bild-Anzeigen implementieren