Google Mobile Ads SDK einrichten (Legacy)

Plattform auswählen: Android iOS Unity Flutter Android (Legacy)

Die Einbindung von Google Mobile Ads SDK (Legacy) in eine App ist der erste Schritt, um Anzeigen zu präsentieren und Einnahmen zu erzielen. Nachdem Sie das SDK integriert haben, können Sie ein Anzeigenformat auswählen (z. B. nativ oder Videoanzeige 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:

    • SDK-Mindestversion 24 oder höher
    • SDK-Version kompilieren: 35 oder höher

Eigene App konfigurieren

  1. 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'

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

    Kotlin

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

    Groovy

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

  3. Klicken Sie auf Jetzt synchronisieren. Weitere Informationen zur Synchronisierung finden Sie unter Projekte mit Gradle-Dateien synchronisieren.

  4. Fügen Sie der Datei AndroidManifest.xml Ihrer App Ihre Ad Manager-App-ID hinzu, wie sie in der Ad Manager-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 Ad Manager-Weboberfläche. Geben Sie neben android: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="SAMPLE_APP_ID"/>
  </application>
</manifest>

    Ersetzen Sie SAMPLE_APP_ID durch Ihre Ad Manager-App-ID. Verwenden Sie beim Testen die Beispiel-App-ID aus dem vorherigen Beispiel.

    Wenn Sie das Tag <meta-data> nicht genau wie 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 Ihre App die Google Mobile Ads SDK (Legacy)-Version 20.4.0 oder höher verwendet, 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, wenn sie verfügbar ist.

    Bei Apps, die die Google Mobile Ads SDK (Legacy)-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 Datei AndroidManifest.xml hinzufügen, damit Google Mobile Ads SDK (Legacy) 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 zu Berechtigungen com.google.android.gms.permission.AD_ID und zur Deaktivierung finden Sie in diesem Play Console-Artikel.

Google Mobile Ads SDK (Legacy) initialisieren

Bevor Sie Anzeigen laden, müssen Sie Google Mobile Ads SDK (Legacy) initialisieren, indem Sie MobileAds.initialize() aufrufen.

Mit dieser Methode wird das SDK initialisiert und ein Abschluss-Listener aufgerufen, sobald die Initialisierung von Google Mobile Ads SDK (Legacy) und des Adapters abgeschlossen ist oder nach einer Zeitüberschreitung von 30 Sekunden. Dies muss nur einmal erfolgen, idealerweise beim Start der App.

Wenn Sie die Vermittlung verwenden, warten Sie, bis der Completion-Handler aufgerufen wurde, bevor Sie Anzeigen laden. So wird sichergestellt, dass alle Vermittlungsadapter initialisiert werden.

Anzeigen können bei der Initialisierung durch Google Mobile Ads SDK (Legacy) oder SDKs von Vermittlungspartnern vorab geladen werden. Wenn Sie die Einwilligung von Nutzern im Europäischen Wirtschaftsraum (EWR), im Vereinigten Königreich oder in der Schweiz einholen, anfragespezifische Flags wie setTagForChildDirectedTreatment() oder setTagForUnderAgeOfConsent() festlegen oder andere Maßnahmen ergreifen müssen, bevor Anzeigen geladen werden, sollten Sie dies vor der Initialisierung von Google Mobile Ads SDK (Legacy) tun.

Hier ist ein Beispiel dafür, wie die Methode initialize() in einem Hintergrundthread innerhalb einer Aktivität aufgerufen wird:

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

Google Mobile Ads SDK (Legacy) wurde importiert und Sie können jetzt eine Anzeige implementieren. Ad Manager bietet verschiedene 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. 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 die Darstellung von Assets wie Überschriften und Calls-to-Action in Ihren Apps anpassen. Wenn Sie die Anzeige selbst gestalten, können Sie eine natürliche, unaufdringliche Anzeigenpräsentation erstellen, die zu einer positiven Nutzererfahrung beitragen kann.

In Google Ad Manager gibt es zwei Möglichkeiten, native Anzeigen zu implementieren: natives Design 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 bei der Erstellung Ihrer Präsentationen größtmögliche Freiheit zu bieten.

Natives Design 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 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 Opt-in-Aufforderung bei Anzeigen mit Prämie erfordern Interstitials mit Prämie einen Eingangsbildschirm, auf dem die Prämie angekündigt wird und Nutzer die Möglichkeit haben, sich abzumelden, wenn sie dies wünschen.

Interstitial-Anzeigen mit Prämie implementieren

App-Start-Anzeige

App-Start-Anzeigen sind 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 die verschiedenen Anzeigenformate verwendet werden, die diese API bietet.