Jetzt starten

Die Einbindung des Google Mobile Ads SDK in eine App ist der erste Schritt, um Anzeigen präsentieren und Einnahmen erzielen zu können. Sobald Sie das SDK eingebunden haben, können Sie ein Anzeigenformat auswählen (z. B. native oder Videoanzeigen mit Prämie) und der Anleitung folgen, um es zu implementieren.

Hinweis

Führen Sie die Schritte in den folgenden Abschnitten aus, um Ihre App vorzubereiten.

Voraussetzungen für Apps

  • Android Studio 3.2 oder höher verwenden
  • Achten Sie darauf, dass die Build-Datei Ihrer App die folgenden Werte enthält:

    • minSdkVersion von 19 oder höher
    • compileSdkVersion von 28 oder höher

App in Ihrem AdMob-Konto einrichten

So registrieren Sie Ihre App als AdMob-App:

  1. Melden Sie sich in AdMob an oder registrieren Sie sich für eins.

  2. Registrieren Sie Ihre App bei AdMob. In diesem Schritt wird eine AdMob-App mit einer eindeutigen AdMob App-ID erstellt, die Sie später in dieser Anleitung benötigen.

Eigene Anwendung konfigurieren

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

    buildscript {
        repositories {
            google()
            mavenCentral()
        }
    }
    
    allprojects {
        repositories {
            google()
            mavenCentral()
        }
    }
    
  2. Fügen Sie die Abhängigkeiten für das Google Mobile Ads SDK in die Gradle-Datei Ihres Moduls ein (in der Regel app/build.gradle):

    dependencies {
      implementation 'com.google.android.gms:play-services-ads:22.1.0'
    }
    
  3. Fügen Sie die AdMob App-ID (in derAdMob-UI identifiziert) der Datei AndroidManifest.xml Ihrer Anwendung hinzu. Füge dazu ein <meta-data>-Tag mit android:name="com.google.android.gms.ads.APPLICATION_ID" hinzu. Ihre App-ID finden Sie auf der AdMob -UI. Fügen 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>
    

    Verwenden Sie in einer echten App Ihre tatsächliche AdMob App-ID, nicht die oben aufgeführte. Wenn Sie das SDK in einer Hello World-App nur testen möchten, können Sie die oben gezeigte Beispiel-App-ID verwenden.

    Wenn das <meta-data>-Tag nicht wie oben gezeigt hinzugefügt wird, stürzt die Nachricht ab:

    The Google Mobile Ads SDK was initialized incorrectly.
    

    (Optional) Deklarieren Sie die Berechtigung AD_ID für frühere Versionen, um mit Android 13 zu arbeiten.

    Wenn Ihre App das Google Mobile Ads SDK 20.4.0 oder höher verwendet, können Sie diesen Schritt überspringen, da das SDK automatisch die Berechtigung com.google.android.gms.permission.AD_ID deklariert und den Zugriff auf die Werbe-ID ermöglicht, sobald sie verfügbar ist.

    Bei Apps mit Version 20.3.0 (oder höher) des Google Mobile Ads SDKs, die auf Android 13 ausgerichtet sind, musst du die Berechtigung com.google.android.gms.permission.AD_ID in die Datei AndroidManifest.xml aufnehmen, 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 zu Berechtigungen com.google.android.gms.permission.AD_ID und zum Deaktivieren dieser Berechtigung finden Sie in diesem Play Console-Artikel.

Google Mobile Ads SDK initialisieren

Bevor die Anzeigen geladen werden, bitten Sie Ihre App, das Google Mobile Ads SDK zu initialisieren. Dazu wird MobileAds.initialize() aufgerufen. Dadurch wird ein Abschluss-Listener aufgerufen, sobald die Initialisierung abgeschlossen ist (oder nach einer 30-sekündigen Zeitüberschreitung). Dies ist nur einmal erforderlich, idealerweise beim Start der App.

Anzeigen können vom Google Mobile Ads SDK oder den SDKs der Vermittlungspartner vorab geladen werden, wenn MobileAds.initialize() aufgerufen wird. Wenn Sie die Einwilligung von Nutzern im Europäischen Wirtschaftsraum (EWR),tagForChildDirectedTreatmenttag_for_under_age_of_consent

Hier ein Beispiel für den Aufruf der Methode initialize() in einer Aktivität:

Beispiel für MainActivity (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) {}
    }
}

Wenn Sie die Vermittlung nutzen, warten Sie, bis der Abschluss-Handler aufgerufen wurde, bevor Sie die Anzeigen laden. So sorgen Sie dafür, dass alle Vermittlungsadapter initialisiert werden.

Anzeigenformat auswählen

Das Google Mobile Ads SDK ist jetzt importiert und Sie können eine Anzeige implementieren. AdMob Sie haben die Wahl zwischen verschiedenen Anzeigenformaten. Sie können also das Format auswählen, das sich am besten für die Nutzererfahrung Ihrer App eignet.

Rechteckige Anzeigen, die oben oder unten auf dem Bildschirm des Geräts 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 mobilen Anzeigen vertraut sind, ist das jetzt der erste Schritt.

Banneranzeigen implementieren

Interstitial

Vollbildanzeigen, die die Benutzeroberfläche einer App abdecken, bis sie vom Nutzer geschlossen werden Sie eignen sich am besten für natürliche Pausen während der Ausführung einer App, z. B. zwischen Leveln eines Spiels oder kurz nach dem Abschluss einer Aufgabe.

Interstitial-Anzeigen implementieren

Nativ

Anpassbare Anzeigen, die zum Design Ihrer App passen. Sie entscheiden, wie und wo sie platziert werden. So haben Sie die Möglichkeit, das Layout optimal auf Ihre App abzustimmen.

Native Anzeigen implementieren

Verfügbar

Anzeigen, in denen Nutzer für das Ansehen von kurzen Videos und die Interaktion mit spielbaren Anzeigen und Umfragen belohnt werden Werden zur Monetarisierung kostenloser Spiele verwendet

Anzeigen mit Prämie implementieren

Weitere Ressourcen

Das Google Mobile Ads-Repository auf GitHub zeigt, wie die verschiedenen Anzeigenformate der API verwendet werden.