Um Anzeigen in Ihrer App zu präsentieren und damit Umsätze zu erzielen, müssen Sie als Erstes das Google Mobile Ads SDK in die App einbinden. Nachdem Sie das SDK integriert haben, können Sie ein Anzeigenformat (z. B. nativ oder Videoanzeige mit Prämie) auswählen 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 in der Build-Datei Ihrer App die folgenden Werte verwendet werden:
- Mindestens SDK-Version
23
erforderlich - Kompilieren Sie die SDK-Version von
34
oder höher.
- Mindestens SDK-Version
Eigene App konfigurieren
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'
Fügen Sie der Build-Datei auf App-Ebene die Abhängigkeiten für das Google Mobile Ads SDK hinzu:
Kotlin
dependencies { implementation("com.google.android.gms:play-services-ads:24.4.0") }
Groovy
dependencies { implementation 'com.google.android.gms:play-services-ads:24.4.0' }
Klicken Sie auf Jetzt synchronisieren. Weitere Informationen zur Synchronisierung finden Sie unter Projekte mit Gradle-Dateien synchronisieren.
Fügen Sie die Ad Manager-App-ID, die in der Ad Manager-Weboberfläche angezeigt wird, der Datei
AndroidManifest.xml
Ihrer App hinzu. Fügen Sie dazu ein<meta-data>
-Tag mitandroid:name="com.google.android.gms.ads.APPLICATION_ID"
hinzu. Ihre App-ID finden Sie in der Ad Manager-Weboberfläche. Geben Sie nebenandroid:value
Ihre eigene Ad Manager-App-ID ein, umgeben von Anführungszeichen.<manifest> <application> <!-- Sample Ad Manager app ID: ca-app-pub-3940256099942544~3347511713 --> <meta-data android:name="com.google.android.gms.ads.APPLICATION_ID" android:value=" /<network_code>~<application_id>"/> </application> </manifest>
Ersetzen Sie /<network_code>~<application_id> durch Ihre Ad Manager-App-ID. Verwenden Sie beim Testen die Beispiel-App-ID aus dem vorherigen Beispiel.
Wenn Sie das
<meta-data>
-Tag nicht genau wie gezeigt hinzufügen, stürzt die App ab und es wird die folgende Meldung angezeigt:Missing application ID.
Optional: Deklarieren Sie die Berechtigung
AD_ID
für frühere Versionen, damit sie mit Android 13 funktionieren.Wenn in Ihrer App das Google Mobile Ads SDK in Version 20.4.0 oder höher verwendet wird, können Sie diesen Schritt überspringen, da das SDK die Berechtigung
com.google.android.gms.permission.AD_ID
automatisch deklariert und auf die Werbe-ID zugreifen kann, sofern sie verfügbar ist.Für Apps, die das Google Mobile Ads SDK in der Version 20.3.0 oder niedriger verwenden und auf Android 13 ausgerichtet sind, müssen Sie die Berechtigung
com.google.android.gms.permission.AD_ID
in der DateiAndroidManifest.xml
hinzufügen, damit das 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"/> <!-- 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 Berechtigung
com.google.android.gms.permission.AD_ID
und zur Deaktivierung finden Sie in diesem Play Console-Artikel.
Google Mobile Ads SDK initialisieren
Bevor Sie Anzeigen laden, initialisieren Sie das Google Mobile Ads SDK mit dem Aufruf vonMobileAds.initialize()
.
Mit dieser Methode wird das SDK initialisiert und ein Abschluss-Listener aufgerufen, 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 Starten der App.
Anzeigen können bei der Initialisierung 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, legen Sie alle anfragespezifischen Flags wie setTagForChildDirectedTreatment()
oder setTagForUnderAgeOfConsent()
fest oder ergreifen Sie andere Maßnahmen, bevor Sie Anzeigen laden. Achten Sie darauf, dass dies vor der Initialisierung des Google Mobile Ads SDK erfolgt.
Hier ist ein Beispiel für den Aufruf der Methode initialize()
in einem Hintergrundthread innerhalb einer Aktivität:
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@MyActivity) {}
}
Anzeigenformat auswählen
Das Google Mobile Ads SDK wurde importiert und Sie können jetzt eine Anzeige implementieren. Ad Manager bietet eine Reihe verschiedener Anzeigenformate, sodass Sie das auswählen können, das am besten zur Nutzerfreundlichkeit 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.
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 Anzeigentiteln und Calls-to-Action in Ihren Apps anpassen. Wenn Sie die Anzeige selbst gestalten, können Sie eine natürliche, unaufdringliche Darstellung erstellen, die zu einer positiven Nutzererfahrung beiträgt.
In Google Ad Manager gibt es zwei Möglichkeiten, native Anzeigen zu implementieren: native Designs und standardmäßige native Anzeigen über benutzerdefiniertes Rendering.
Native Designs wurden entwickelt, um die Implementierung nativer Anzeigen zu vereinfachen. Sie sind eine gute Wahl, wenn Sie noch nicht mit dem Format vertraut sind. Das benutzerdefinierte Rendern wurde entwickelt, um Ihnen bei der Erstellung Ihrer Präsentationen maximale Freiheit zu bieten.
Native Designs implementieren Native Anzeigen implementieren (benutzerdefiniertes Rendering)
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
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
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.