Diese Seite wurde von der Cloud Translation API übersetzt.

Jetzt starten

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 eingebunden haben, können Sie ein Anzeigenformat auswählen (z. B. native 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 in der Build-Datei Ihrer App die folgenden Werte verwendet werden:
- Mindest-SDK-Version 21 oder höher
- Kompilieren Sie das SDK mit der Version 34 oder höher.

Eigene Anwendung konfigurieren

Fügen Sie in der Gradle-Einstellungendatei 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 Builddatei auf App-Ebene die Abhängigkeiten für das Google Mobile Ads SDK hinzu:

Kotlin

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

Groovy

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

Fügen Sie der Datei AndroidManifest.xml Ihrer App Ihre Ad Manager-App-ID hinzu, die in der Ad Manager-Weboberfläche angezeigt wird. Fügen Sie dazu ein <meta-data>-Tag mit android:name="com.google.android.gms.ads.APPLICATION_ID" hinzu. Sie finden Ihre App-ID in der Ad Manager-Weboberfläche. Geben Sie neben android:value Ihre eigene Ad Manager-App-ID ein, umgeben von Anführungszeichen.
```
<manifest>
  <application>
    
    <meta-data
        android:name="com.google.android.gms.ads.APPLICATION_ID"
        android:value="
/<network_code>~<application_id>"/>
  </application>
</manifest>
```
Ersetzen Sie in einer echten App die Beispiel-App-ID durch Ihre tatsächliche Ad Manager-App-ID. Sie können die Beispiel-ID verwenden, wenn Sie das SDK nur in einer „Hello World“-App testen.

Hinweis: Wenn das <meta-data>-Tag nicht genau wie gezeigt hinzugefügt wird, kommt es zu einem Absturz mit der 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 die Version 20.4.0 oder höher des Google Mobile Ads SDK verwendet wird, können Sie diesen Schritt überspringen, da die Berechtigung com.google.android.gms.permission.AD_ID vom SDK automatisch deklariert wird und das SDK jederzeit auf die Werbe-ID zugreifen kann.

Bei Apps, die die Version 20.3.0 des Google Mobile Ads SDK oder eine niedrigere Version verwenden und auf Android 13 ausgerichtet sind, müssen Sie die Berechtigung com.google.android.gms.permission.AD_ID in der Datei AndroidManifest.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"/>

   
   <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

Initialisieren Sie das Google Mobile Ads SDK, bevor Sie Anzeigen laden. Rufen Sie dazu MobileAds.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 nach einer 30-sekündigen Zeitüberschreitung). Dies muss nur einmal erfolgen, idealerweise beim Starten der App.

Anzeigen können vom Google Mobile Ads SDK oder vom SDK des Vermittlungspartners bei der Initialisierung vorab geladen werden. Wenn Sie die Einwilligung von Nutzern im Europäischen Wirtschaftsraum (EWR) einholen müssen, setzen Sie alle anfragespezifischen Flags, z. B. setTagForChildDirectedTreatment() oder setTagForUnderAgeOfConsent(). Wenn Sie anderweitig Maßnahmen vor dem Laden von Anzeigen ergreifen müssen, tun Sie dies vor der Initialisierung des Google Mobile Ads SDKs.

Hier ein Beispiel für den Aufruf der Methode initialize() in einem Hintergrund-Thread innerhalb 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);

    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 jetzt importiert und Sie können eine Anzeige implementieren. In Ad Manager stehen verschiedene Anzeigenformate zur Verfügung, sodass Sie das Format auswählen können, das am besten zur Nutzerfreundlichkeit Ihrer App passt.

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.

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 anpassen, wie Assets wie Anzeigentitel und Calls-to-Action in Ihren Apps präsentiert werden. Wenn Sie die Anzeige selbst gestalten, können Sie natürliche, unaufdringliche Anzeigen erstellen, die die Nutzerfreundlichkeit verbessern.

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 mit dem Format noch nicht vertraut sind. Das benutzerdefinierte Rendering wurde entwickelt, um Ihnen beim Erstellen 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 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

„App-Start“ ist ein Anzeigenformat, das präsentiert wird, 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 Sie die verschiedenen Anzeigenformate dieser API verwenden.

Jetzt starten

Hinweis

Voraussetzungen für Apps

Eigene Anwendung konfigurieren

Kotlin

Groovy

Kotlin

Groovy

Optional: Deklarieren Sie die Berechtigung AD_ID für frühere Versionen, 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

Zusätzliche Ressourcen

Optional: Deklarieren Sie die Berechtigung `AD_ID` für frühere Versionen, damit sie mit Android 13 funktionieren.