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:22.6.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:

    The Google Mobile Ads SDK was initialized incorrectly.
    

    (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 Anzeigen geladen werden, muss Ihre App das Google Mobile Ads SDK initialisieren. Dazu müssen Sie MobileAds.initialize() aufrufen. Dadurch wird das SDK initialisiert und nach Abschluss der Initialisierung oder nach einem 30-sekündigen Zeitlimit wird ein Abschluss-Listener aufgerufen. Dies muss nur einmal erfolgen, idealerweise beim Start der App.

Anzeigen können beim Aufruf von MobileAds.initialize() durch das Google Mobile Ads SDK oder das SDK für Vermittlungspartner vorab geladen werden. Wenn Sie die Einwilligung von Nutzern im Europäischen Wirtschaftsraum (EWR) einholen, anfragespezifische Flags wie tagForChildDirectedTreatment oder tag_for_under_age_of_consent festlegen oder anderweitig vor dem Laden von Anzeigen Maßnahmen ergreifen müssen, sollten 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:

MainActivity-Beispiel (Auszug)

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.

Rechteckige Anzeigen, die oben oder unten auf dem Gerätebildschirm erscheinen. Banneranzeigen bleiben auf dem Bildschirm, während Nutzer mit der App interagieren, und können nach einer bestimmten Zeit automatisch aktualisiert werden. Wenn Sie noch nicht mit mobiler Werbung vertraut sind, sind sie ein guter Ausgangspunkt.

Banneranzeigen implementieren

Interstitial

Vollbildanzeigen, die die Benutzeroberfläche einer App verdecken, bis sie vom Nutzer geschlossen werden. Sie eignen sich am besten für natürliche Pausen im Ablauf der App-Ausführung, z. B. zwischen Levels eines Spiels oder kurz nach Abschluss einer Aufgabe.

Interstitial-Anzeigen implementieren

Nativ

Anpassbare Anzeigen, die zum Design Ihrer App passen. Sie entscheiden, wie und wo sie platziert werden, sodass das Layout besser zum Design Ihrer App passt.

Native Anzeigen implementieren

Verfügbar

Das sind Anzeigen, in denen Nutzer belohnt werden, wenn sie sich kurze Videos ansehen oder mit spielbaren Anzeigen und Umfragen interagieren. Wird für die Monetarisierung kostenloser Apps verwendet.

Anzeigen mit Prämie implementieren

Weitere Ressourcen

Im Google Mobile Ads-Repository auf GitHub wird die Verwendung der verschiedenen Anzeigenformate dieser API veranschaulicht.