Erste Schritte

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

App in Ihrem AdMob-Konto einrichten

So registrieren Sie Ihre App als AdMob-App:

  1. Melden Sie sich in einem AdMob-Konto an oder registrieren Sie sich.

  2. Registrieren Sie Ihre App bei AdMob. In diesem Schritt wird eine AdMob-App mit einer eindeutigen AdMob-App-ID erstellt, die weiter unten in diesem Leitfaden benötigt wird.

Eigene App konfigurieren

  1. Fügen Sie in der Datei build.gradle auf Projektebene in den Abschnitten buildscript und allprojects das Maven-Repository von Google und das Maven Central Repository hinzu:

    buildscript {
        repositories {
            google()
            mavenCentral()
        }
    }
    
    allprojects {
        repositories {
            google()
            mavenCentral()
        }
    }
    
  2. 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'
    }
    
  3. Fügen Sie der Datei AndroidManifest.xml Ihrer App die AdMob Anwendungs-ID hinzu, die in derAdMob-Weboberfläche angegeben ist. 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 AdMob Weboberfläche. Geben Sie für android:value Ihre eigene AdMob Anwendungs-ID in Anführungszeichen ein.

    <manifest>
      <application>
        <!-- Sample AdMob 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ächlicheAdMob 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 Berechtigung com.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 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 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. AdMob bietet eine Reihe verschiedener Anzeigenformate, sodass Sie dasjenige auswählen können, das sich am besten für die Nutzererfahrung in Ihrer App eignet.

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.

Banneranzeigen 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.

Native Anzeigen implementieren

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.