Um Anzeigen auszuliefern und Umsätze zu generieren, müssen Sie zuerst das Google Mobile Ads SDK in eine App einbinden. Nach der Integration des SDK können Sie ein Anzeigenformat auswählen, z. B. natives Video oder Video mit Prämie, und folgen Sie der Anleitung zur Implementierung.
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:
- SDK-Mindestversion von
19
oder höher - Kompilieren Sie die SDK-Version von
33
oder höher
- SDK-Mindestversion von
Eigene App konfigurieren
Fügen Sie in der Datei
build.gradle
auf Projektebene in den Abschnittenbuildscript
undallprojects
das Maven-Repository von Google und das Maven Central Repository hinzu:buildscript { repositories { google() mavenCentral() } } allprojects { repositories { google() mavenCentral() } }
Fügen Sie der Gradle-Datei auf App-Ebene Ihres Moduls, normalerweise
app/build.gradle
, die Abhängigkeiten für das Google Mobile Ads SDK hinzu:dependencies { implementation 'com.google.android.gms:play-services-ads:23.0.0' }
Fügen Sie der Datei
AndroidManifest.xml
Ihrer App die Ad Manager Anwendungs-ID hinzu, die in derAd Manager-Weboberfläche angegeben ist. Fügen Sie dazu ein<meta-data>
-Tag mitandroid:name="com.google.android.gms.ads.APPLICATION_ID"
hinzu. Sie finden Ihre App-ID in der Ad Manager Weboberfläche. Geben Sie fürandroid:value
Ihre eigene Ad Manager Anwendungs-ID in Anführungszeichen ein.<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="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/> </application> </manifest>
In einer echten App ersetzen Sie die Beispiel-App-ID durch Ihre tatsächlicheAd Manager App-ID. Sie können die Beispiel-ID verwenden, wenn Sie das SDK in einer Hello World-App testen möchten.
Wenn Sie das
<meta-data>
-Tag nicht genau wie hier gezeigt hinzufügen, kommt es zu einem Absturz mit der folgenden Meldung: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 Version 20.4.0 oder höher des Google Mobile Ads SDK verwendet wird, können Sie diesen Schritt überspringen, da das SDK automatisch die Berechtigung
com.google.android.gms.permission.AD_ID
deklariert und jederzeit auf die Werbe-ID zugreifen kann.Bei Apps, die Version 20.3.0 des Google Mobile Ads SDK oder niedriger verwenden und auf Android 13 ausgerichtet sind, müssen Sie in der Datei
AndroidManifest.xml
die Berechtigungcom.google.android.gms.permission.AD_ID
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 zur Erklärung 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, müssen Sie das Google Mobile Ads SDK initialisieren. Rufen Sie dazuMobileAds.initialize()
auf.
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 ein Zeitlimit von 30 Sekunden eintritt. Dies muss nur einmal erfolgen, idealerweise beim Start der App.
Anzeigen können während der Initialisierung vom Google Mobile Ads SDK oder vom Vermittlungspartner-SDK vorab geladen werden. Wenn Sie die Einwilligung von Nutzern im Europäischen Wirtschaftsraum (EWR) einholen müssen, legen Sie anfragespezifische Flags wie
setTagForChildDirectedTreatment()
oder
setTagForUnderAgeOfConsent()
fest oder ergreifen Sie Maßnahmen, bevor Sie Anzeigen laden, müssen Sie dies vor der Initialisierung des Google Mobile Ads SDK tun.
Hier ein Beispiel für den Aufruf der Methode initialize()
in einer Aktivität:
Java
import com.google.android.gms.ads.MobileAds;
import com.google.android.gms.ads.initialization.InitializationStatus;
import com.google.android.gms.ads.initialization.OnInitializationCompleteListener;
public class MainActivity extends AppCompatActivity {
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
MobileAds.initialize(this, new OnInitializationCompleteListener() {
@Override
public void onInitializationComplete(InitializationStatus initializationStatus) {
}
});
}
}
Kotlin
import com.google.android.gms.ads.MobileAds
class MainActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
MobileAds.initialize(this) {}
}
}
Anzeigenformat auswählen
Das Google Mobile Ads SDK wurde importiert und Sie können eine Anzeige implementieren. Ad Manager bietet eine Reihe verschiedener Anzeigenformate, sodass Sie dasjenige auswählen können, das sich am besten für die Nutzererfahrung in Ihrer App eignet.
Banner
Banneranzeigenblöcke enthalten rechteckige Anzeigen, die einen Teil der App-Oberfläche einnehmen. Sie können nach einer festgelegten Zeit automatisch aktualisiert werden. Das bedeutet, dass Nutzer in regelmäßigen Abständen eine neue Anzeige aufrufen, auch wenn sie in Ihrer App auf demselben Bildschirm bleiben. Dieses Anzeigenformat ist auch am einfachsten zu implementieren.
Interstitial
Mit Interstitial-Anzeigenblöcken werden ganzseitige Anzeigen in Ihrer App ausgeliefert. Platzieren Sie die Anzeigenblöcke an natürlichen Unterbrechungs- oder Übergangspunkten in der App, etwa nach dem Abschluss eines Levels in einer Gaming-App.
Interstitial-Anzeigen implementieren
Nativ
Bei nativen Anzeigen können Sie anpassen, wie Assets wie Anzeigentitel und Calls-to-Action in Ihren Apps dargestellt werden. Wenn Sie die Anzeige selbst gestalten, können Sie eine natürliche, unaufdringliche Anzeigenpräsentation erstellen, die die Nutzererfahrung verbessert.
In Google Ad Manager gibt es zwei Möglichkeiten, native Anzeigen zu implementieren: native Designs und native Standardanzeigen durch benutzerdefiniertes Rendering.
Native Designs wurden entwickelt, um die Implementierung nativer Anzeigen zu vereinfachen. Sie sind besonders dann geeignet, wenn Sie mit dem Format noch nicht vertraut sind. Das benutzerdefinierte Rendering wurde entwickelt, um Ihnen beim Erstellen von Präsentationen mehr Freiheiten zu bieten.
Native Designs implementieren Native Anzeigen implementieren (benutzerdefiniertes Rendering)
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 verschiedene Prämien für verschiedene Anzeigenblöcke festlegen und die Prämienwerte und -artikel angeben, die der Nutzer erhalten hat.
Anzeigen mit Prämie implementieren
Interstitial mit Prämie
Interstitial-Anzeigen mit Prämie sind ein neues Anzeigenformat mit Anreizen, mit dem Sie Prämien wie Münzen oder Extraleben für Anzeigen anbieten können, die automatisch bei natürlichen App-Übergängen eingeblendet werden.
Im Gegensatz zu Anzeigen mit Prämie müssen Nutzer nicht zustimmen, um Interstitial-Anzeigen mit Prämie zu sehen.
Anstelle der Zustimmungsaufforderung in Anzeigen mit Prämie ist für Interstitials mit Prämie ein Eingangsbildschirm erforderlich, auf dem die Prämie angezeigt wird und der Nutzer die Möglichkeit hat, die Teilnahme zu beenden.
Interstitial-Anzeigen mit Prämie implementieren
App-Start-Anzeige
App-Start-Anzeigen sind ein Anzeigenformat, das eingeblendet wird, wenn Nutzer die App öffnen oder zu ihr zurückkehren. Die Anzeige überlagert den Ladebildschirm.
App-Start-Anzeigen implementieren
Zusätzliche Ressourcen
Im Google Mobile Ads-Repository auf GitHub wird die Verwendung der verschiedenen Anzeigenformate dieser API veranschaulicht.