Google Mobile Ads SDK einrichten (Legacy)

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

Die Einbindung von Google Mobile Ads SDK (Legacy) 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. native Anzeigen oder Videoanzeigen mit Prämie) und die entsprechenden Schritte zur Implementierung ausführen.

Hinweis

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

Voraussetzungen für Apps

  • Die Build-Datei Ihrer App muss die folgenden Werte verwenden:

    • Mindest-SDK-Version 24 oder höher
    • SDK-Version für die Kompilierung 35 oder höher

App in Ihrem AdMob-Konto einrichten

Registrieren Sie Ihre App als AdMob-App. Führen Sie dazu die folgenden Schritte aus:

  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. Dadurch wird eine AdMob-App mit einer eindeutigen AdMob-App ID erstellt, die später in dieser Anleitung benötigt wird.

Eigene App konfigurieren

  1. Fügen Sie in der Datei mit den Gradle-Einstellungen 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 Google Mobile Ads SDK (Legacy) hinzu:

    Kotlin

    dependencies {
  implementation("com.google.android.gms:play-services-ads:25.5.0")
}

    Groovy

    dependencies {
  implementation 'com.google.android.gms:play-services-ads:25.5.0'
}

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

  4. Fügen Sie der Datei AndroidManifest.xml Ihrer App Ihre AdMob-App-ID hinzu, wie sie in der AdMob-Weboberfläche angegeben ist, . Fügen Sie dazu ein <meta-data>-Tag mit android:name="com.google.android.gms.ads.APPLICATION_ID" hinzu. Ihre App-ID finden Sie in der AdMob-Weboberfläche. Geben Sie neben android:value Ihre eigene AdMob-App-ID ein, umgeben von Anführungszeichen.

    <manifest>
  <application>
    <!-- Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713 -->
    <meta-data
        android:name="com.google.android.gms.ads.APPLICATION_ID"
        android:value="SAMPLE_APP_ID"/>
  </application>
</manifest>

    Ersetzen Sie SAMPLE_APP_ID durch Ihre AdMob-App-ID. Verwenden Sie beim Testen die im vorherigen Beispiel gezeigte Beispiel-App-ID.

    Wenn Sie das <meta-data>-Tag nicht genau wie gezeigt hinzufügen, kommt es zu einem Absturz mit der folgenden Meldung:

    Missing application ID.

    (Optional) Berechtigung AD_ID für frühere Versionen deklarieren, damit sie mit Android 13 funktionieren

    Wenn Ihre App Google Mobile Ads SDK (Legacy) Version 20.4.0 oder höher verwendet, können Sie diesen Schritt überspringen, da das SDK die com.google.android.gms.permission.AD_ID Berechtigung automatisch deklariert und auf die Werbe-ID zugreifen kann, sobald sie verfügbar ist.

    Bei Apps, die das Google Mobile Ads SDK (Legacy) in Version 20.3.0 oder niedriger verwenden und auf Android 13 ausgerichtet sind, müssen Sie die com.google.android.gms.permission.AD_ID Berechtigung in der AndroidManifest.xml Datei hinzufügen, damit das Google Mobile Ads SDK (Legacy) auf die Werbe-ID zugreifen kann:

    <manifest>
 <application>
   <meta-data
       android:name="com.google.android.gms.ads.APPLICATION_ID"
       android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>

   <!-- For apps targeting Android 13 or higher & GMA SDK version 20.3.0 or lower -->
   <uses-permission android:name="com.google.android.gms.permission.AD_ID"/>

 </application>
</manifest>

    Weitere Informationen zum Deklarieren der com.google.android.gms.permission.AD_ID Berechtigung und zur Deaktivierung finden Sie in diesem Play Console-Artikel.

Google Mobile Ads SDK (Legacy) initialisieren

Initialisieren Sie Google Mobile Ads SDK (Legacy) vor dem Laden von Anzeigen mit dem Aufruf von MobileAds.initialize().

Diese Methode initialisiert das SDK und ruft einen Abschluss-Listener auf, sobald die Initialisierung von Google Mobile Ads SDK (Legacy) und des Adapters abgeschlossen ist oder nach einer Zeitüberschreitung von 30 Sekunden. Dies muss nur einmal erfolgen, idealerweise beim Start der App.

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

Anzeigen können beim Initialisieren von Google Mobile Ads SDK (Legacy) 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 setTagForChildDirectedTreatment() oder setTagForUnderAgeOfConsent(), oder ergreifen Sie andere Maßnahmen, bevor Sie Anzeigen laden. Achten Sie darauf, dass Sie dies vor der Initialisierung von Google Mobile Ads SDK (Legacy) tun.

Hier sehen Sie ein Beispiel dafür, wie Sie die Methode initialize() in einem Hintergrundthread innerhalb einer Aktivität aufrufen:

Java

new Thread(
        () -> {
          // Initialize the Google Mobile Ads SDK on a background thread.
          MobileAds.initialize(this, initializationStatus -> {});
        })
    .start();

Kotlin

CoroutineScope(Dispatchers.IO).launch {
  // Initialize the Google Mobile Ads SDK on a background thread.
  MobileAds.initialize(this@MainActivity) {}
}

Anzeigenformat auswählen

Google Mobile Ads SDK (Legacy) wurde jetzt importiert und Sie können eine Anzeige implementieren. AdMob bietet eine Reihe verschiedener Anzeigenformate, sodass Sie das Format auswählen können, 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.

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

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

Zusätzliche Ressourcen

Im Google Mobile Ads-Repository auf GitHub wird gezeigt, wie Sie die verschiedenen Anzeigenformate verwenden, die diese API bietet.