Die Einbindung des Google Mobile Ads SDK in die App ist der erste Schritt zur Anzeigen schalten und Einnahmen erzielen. Nach der Integration des SDK können Sie ein Anzeigenformat auswählen (z. B. native Anzeigen oder Videoanzeigen mit Prämie) und folgen Sie der Anleitung, um sie zu implementieren.
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 enthält:
- Mindestversion des SDK von
21oder höher - Kompilieren Sie die SDK-Version von
33oder höher
- Mindestversion des SDK von
Eigene App konfigurieren
Fügen Sie in Ihrer Gradle-Einstellungsdatei den Das Maven-Repository von Google und Maven Central Repository:
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'Abhängigkeiten für das Google Mobile Ads SDK zu Ihrem Build auf App-Ebene hinzufügen Datei:
Kotlin
dependencies { implementation("com.google.android.gms:play-services-ads:23.3.0") }Groovy
dependencies { implementation 'com.google.android.gms:play-services-ads:23.3.0' }Füge deine Ad Manager App-ID hinzu, wie in den Ad Manager über die Weboberfläche,
AndroidManifest.xml-Datei. Fügen Sie dazu ein<meta-data>-Tag mitandroid:name="com.google.android.gms.ads.APPLICATION_ID". Sie finden App-ID in der Ad Manager Weboberfläche Fürandroid:value, fügen Sie Ihre eigene Ad Manager App-ID ein, in Anführungszeichen gesetzt ist.<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ächliche Ad Manager App-ID. Sie können die Beispiel-ID verwenden, wenn testen Sie einfach das SDK in einer Hello World App.
Beachten Sie auch, dass das
<meta-data>-Tag nicht genau wie in den Ergebnissen hinzugefügt wurde. bei einem Absturz mit der Meldung:Missing application ID.(Optional) Deklarieren
AD_ID-Berechtigung für vorherige Versionen, um mit Android zu funktionieren 13.Wenn Sie in Ihrer App Version 20.4.0 des Google Mobile Ads SDK oder höher ist, können Sie diesen Schritt überspringen, da das SDK die
com.google.android.gms.permission.AD_IDund kann um auf die Werbe-ID zuzugreifen, wann immer diese verfügbar ist.Für Apps, in denen Version 20.3.0 des Google Mobile Ads SDK oder und auf Android 13 ausgerichtet sind, müssen Sie den Berechtigung
com.google.android.gms.permission.AD_IDin derAndroidManifest.xml-Datei für das Google Mobile Ads SDK, um Zugriff auf die Werbe-ID:<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 zur Berechtigung „
com.google.android.gms.permission.AD_ID“, und wie Sie ihn deaktivieren, finden Sie in diesem Konsolenartikel.
Google Mobile Ads SDK initialisieren
Initialisieren Sie das Google Mobile Ads SDK, bevor Sie Anzeigen laden. Rufen Sie dazuMobileAds.initialize()
Diese Methode initialisiert das SDK und ruft einen Abschluss-Listener auf, sobald sowohl die Die Initialisierungen des Google Mobile Ads SDK und des Adapters sind abgeschlossen oder 30-sekündiges Zeitlimit Dieser Vorgang muss nur einmal durchgeführt werden, idealerweise beim Start der App.
Anzeigen können über das Google Mobile Ads SDK oder SDKs von Vermittlungspartnern vorab geladen werden
bei der Initialisierung an. Wenn Sie die Einwilligung von Nutzern in der EU
(EWR) können Sie anfragespezifische Flags festlegen, z. B.
setTagForChildDirectedTreatment()
oder
setTagForUnderAgeOfConsent(),
oder
Führen Sie andernfalls vor dem Laden der Anzeigen diese Schritte aus, bevor Sie sie initialisieren
das Google Mobile Ads SDK.
Hier ein Beispiel für den Aufruf der initialize()-Methode auf einem Hintergrund
Thread innerhalb einer Activity:
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);
new Thread(
() -> {
// Initialize the Google Mobile Ads SDK on a background thread.
MobileAds.initialize(this, initializationStatus -> {});
})
.start();
}
}
Kotlin
import com.google.android.gms.ads.MobileAds
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 the Google Mobile Ads SDK on a background thread.
MobileAds.initialize(this@MainActivity) {}
}
}
}
Anzeigenformat auswählen
Das Google Mobile Ads SDK wurde importiert und Sie können eine Anzeige implementieren. Ad Manager bietet verschiedene Anzeigenformate, können Sie diejenige auswählen, die am besten zur Nutzererfahrung Ihrer App passt.
Banner
Banneranzeigenblöcke enthalten rechteckige Werbeanzeigen, die einen Teil der Layout. Sie können nach einer bestimmten Zeit automatisch aktualisiert werden. Das bedeutet, Nutzer sehen sich regelmäßig eine neue Anzeige an, auch wenn sie nicht verändert wurden in deiner App. Dieses Anzeigenformat ist besonders einfach zu implementieren.
Interstitial
Mit Interstitial-Anzeigenblöcken werden ganzseitige Anzeigen in Ihrer App bereitgestellt. Platzieren Sie sie in einer natürlichen Unterbrechungen und Übergänge auf der Benutzeroberfläche Ihrer App, z. B. nach Abschluss eines Levels in einer Gaming-App.
Interstitial-Anzeigen implementieren
Nativ
Bei nativen Anzeigen können Sie anpassen, wie Assets wie Anzeigentitel und und Calls-to-Action in Ihren Apps präsentieren. Wenn Sie die Anzeige selbst gestalten, Erstellen Sie natürliche, unaufdringliche Anzeigenpräsentationen, die einen aussagekräftigen Nutzererfahrung.
Google Ad Manager bietet zwei Möglichkeiten zur Implementierung nativer Anzeigen: native Designs und nativen Standard-Anzeigen durch benutzerdefiniertes Rendering.
Mit nativen Designs möchten wir die Implementierung nativer Anzeigen vereinfachen. und ist eine gute Wahl, wenn Sie mit dem Format noch nicht vertraut sind. Benutzerdefiniertes Rendering wurde mit dem Sie die Freiheit bei der Erstellung Ihrer Präsentationen maximieren können.
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, zusätzliche Leben oder Punkte erhalten Sie können unterschiedliche Prämien für unterschiedliche Anzeigenblöcke festlegen und die Prämienwerte und Elemente, die der Nutzer erhalten hat.
Anzeigen mit Prämie implementieren
Interstitial mit Prämie
Interstitials mit Prämie sind ein neues Anzeigenformat, bei dem Sie bieten Prämien wie Münzen oder Extraleben für Anzeigen an, die automatisch an natürlichen App-Übergängen.
Im Gegensatz zu Anzeigen mit Prämie müssen Nutzer der Anzeige von Anzeigen mit Prämie nicht zustimmen. Interstitial.
Anstelle der Aufforderung zur Aktivierung in Anzeigen mit Prämie ist bei Interstitials mit Prämie ein Eingangsbildschirm, auf dem die Prämie angekündigt wird und Nutzer die Möglichkeit haben, die Anzeige zu deaktivieren, wenn sie das möchten.
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
Das Google Mobile Ads Repository auf GitHub veranschaulicht, wie die verschiedenen Anzeigenformate dieser API verwendet werden.