Jetzt starten

Das Einbinden des Google Mobile Ads SDK in eine App ist der erste Schritt zum Anzeigen und Generieren von Umsatz. Sobald du das SDK eingebunden hast, kannst du ein Anzeigenformat wie für native Anzeigen oder Videos mit Prämie auswählen 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
  • Die Build-Datei Ihrer App muss folgende Werte enthalten:

    • Ein minSdkVersion von 16 oder mehr
    • Ein compileSdkVersion von 28 oder mehr

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 ein AdMob-Konto.

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

Eigene App konfigurieren

  1. Füge in der Datei build.gradle auf Projektebene sowohl das Google-Repository Maven als auch das Maven-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 der Gradle-Datei auf Modulebene hinzu (in der Regel app/build.gradle):

    dependencies {
      implementation 'com.google.android.gms:play-services-ads:21.0.0'
    }
    
  3. Füge die App-ID AdMob (in derAdMob-UI angegeben) in die Datei AndroidManifest.xml der App ein. Füge dazu ein <meta-data>-Tag mit android:name="com.google.android.gms.ads.APPLICATION_ID" hinzu. Sie finden Ihre App-ID in der AdMob -UI. Geben Sie für android:value Ihre eigene AdMob App-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 ID. Wenn Sie nur mit dem SDK in einer Hello World-App experimentieren möchten, können Sie die oben gezeigte Beispiel-App-ID verwenden.

    Beachten Sie auch, dass das Hinzufügen des <meta-data>-Tags wie oben dargestellt zu einem Absturz mit der folgenden Nachricht führt:

    The Google Mobile Ads SDK was initialized incorrectly.
    

    Optional: Deklarieren Sie die AD_ID-Berechtigung für frühere Versionen, um mit Android 13 zu funktionieren.

    Wenn in Ihrer App das Google Mobile Ads SDK 20.4.0 oder höher verwendet wird, können Sie diesen Schritt überspringen, da das SDK automatisch die Berechtigung com.google.android.gms.permission.AD_ID deklariert. Sie kann dann auf die Werbe-ID zugreifen, sobald sie verfügbar ist.

    Bei Apps, die für das Google Mobile Ads SDK 20.3.0 oder eine ältere Version verwenden und auf Android 13 ausgerichtet sind, musst du 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 Berechtigungserklärung com.google.android.gms.permission.AD_ID, einschließlich der Deaktivierung, findest du in diesem Artikel der Play Console.

Google Mobile Ads SDK initialisieren

Bevor die Anzeigen geladen werden, bitten Sie Ihre App, das Google Mobile Ads SDK zu initialisieren. Aufrufen Sie dazu MobileAds.initialize(). Das SDK initialisiert wird und ruft einen Listener (abgeschlossen) auf, wenn die Initialisierung abgeschlossen ist (oder nach 30 Sekunden). Dies muss nur einmal geschehen, idealerweise beim Start der Anwendung.

Anzeigen können über das Google Mobile Ads SDK oder die SDKs der Vermittlungspartner vorab geladen werden, wenn MobileAds.initialize() aufgerufen wird. Wenn Sie die Einwilligung von Nutzern im Europäischen Wirtschaftsraum (EWR) einholen müssen, legen Sie eine anfragespezifische Einstellung wie „tagForChildDirectedTreatment“ oder „tag_for_under_age_of_consent“ fest oder führen Sie eine andere Aktion aus, bevor Sie Anzeigen laden. Initialisieren Sie dazu das Google Mobile Ads SDK.

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

Beispiel für Hauptaktivität (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 werden alle Vermittlungsadapter initialisiert.

Anzeigenformat auswählen

Das Google Mobile Ads SDK wurde importiert und Sie können jetzt eine Anzeige implementieren. AdMob Sie haben die Wahl zwischen verschiedenen Anzeigenformaten. So können Sie das Format auswählen, das am besten zu Ihrer App passt.

Rechteckige Anzeigen, die oben oder unten auf dem Gerätebildschirm erscheinen Banneranzeigen bleiben auf dem Bildschirm, während Nutzer mit der App interagieren. Sie können nach einer bestimmten Zeit automatisch aktualisiert werden. Wenn Sie noch keine Erfahrung mit mobiler Werbung haben, 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 einer App, etwa zwischen Leveln 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, damit das Layout besser zu Ihrer App passt.

Native Anzeigen implementieren

Verfügbar

Anzeigen, die Nutzer für das Ansehen von kurzen Videos und die Interaktion mit spielbaren Anzeigen und Umfragen belohnen. Wird für die Monetarisierung kostenloser Apps verwendet.

Anzeigen mit Prämie implementieren

Weitere Informationen

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