Google Mobile Ads SDK einrichten

Die Einbindung von Google Mobile Ads 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. native Anzeigen oder Videoanzeigen 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 23 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. Gehen Sie dazu so vor:

Melden Sie sich in einem AdMob-Konto an oder registrieren Sie sich für ein AdMob-Konto.
Registrieren Sie Ihre App bei AdMob. Bei diesem Schritt wird eine AdMob-App mit einer eindeutigen AdMob-App ID erstellt, die später in dieser Anleitung benötigt wird.

Eigene App konfigurieren

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'

Fügen Sie der Build-Datei auf App-Ebene die Abhängigkeiten für Google Mobile Ads SDK hinzu:

Kotlin

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

Groovy

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

Klicken Sie auf Jetzt synchronisieren. Weitere Informationen zur Synchronisierung finden Sie unter Projekte mit Gradle-Dateien synchronisieren.
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>
    
    <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 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 Google Mobile Ads SDK 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 in der AndroidManifest.xml hinzufügen, damit Google Mobile Ads SDK 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"/>

   
   <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 initialisieren

Initialisieren Sie Google Mobile Ads SDK vor dem Laden von Anzeigen, indem Sie MobileAds.initialize() aufrufen.

Diese Methode initialisiert das SDK und ruft einen Abschluss-Listener auf, sobald die Initialisierung des Google Mobile Ads 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 AdMob-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 vom Google Mobile Ads SDK oder von SDKs von Vermittlungspartnern vorab geladen werden. Wenn Sie die Einwilligung von Nutzern im Europäischen Wirtschaftsraum (EWR) einholen müssen, anfragespezifische Flags festlegen möchten, z. B. setTagForChildDirectedTreatment() oder setTagForUnderAgeOfConsent(), oder andere Maßnahmen vor dem Laden von Anzeigen ergreifen möchten, tun Sie dies, bevor Sie Google Mobile Ads SDKinitialisieren.

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

Java

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

Kotlin

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

Anzeigenformat auswählen

Google Mobile Ads SDK 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

Native Anzeigen sind Anzeigen, bei denen Sie die Darstellung von Assets wie Überschriften und Call-to-Action-Elementen in Ihren Apps anpassen können. Wenn Sie die Anzeige selbst gestalten, können Sie eine natürliche, unaufdringliche Anzeigenpräsentation 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 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 Aufforderung zur Zustimmung muss ein Eingangsbildschirm eingeblendet werden, auf dem Nutzer die versprochene Prämie sehen und sich gegen das Ansehen der Anzeige entscheiden können.

Interstitial-Anzeigen mit Prämie implementieren

App-Start-Anzeige

App-Start-Anzeigen werden präsentiert, wenn ein Nutzer Ihre App öffnet oder zu ihr zurückwechselt. 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 die verschiedenen Anzeigenformate verwendet werden, die diese API bietet.

Google Mobile Ads SDK einrichten Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Hinweis

Voraussetzungen für Apps

App in Ihrem AdMob-Konto einrichten

Eigene App konfigurieren

Kotlin

Groovy

Kotlin

Groovy

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

Google Mobile Ads SDK initialisieren

Java

Kotlin

Anzeigenformat auswählen

Banner

Interstitial

Nativ

Verfügbar

Interstitial mit Prämie

App-Start-Anzeige

Zusätzliche Ressourcen

Google Mobile Ads SDK einrichten

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