Diese Seite wurde von der Cloud Translation API übersetzt.

Jetzt starten

Die Integration des Google Mobile Ads SDK in eine App ist der erste Schritt, um Anzeigen auszuliefern und Umsätze zu erzielen. Nachdem Sie das SDK integriert haben, können Sie ein Anzeigenformat (z. B. natives Video oder Video 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
Achten Sie darauf, dass die Build-Datei Ihrer App die folgenden Werte enthält:
- Ein minSdkVersion von 19 oder höher
- Ein compileSdkVersion von 28 oder höher

App in Ihrem AdMob-Konto einrichten

So registrieren Sie Ihre App als AdMob-App:

Melden Sie sich in einem AdMob-Konto an oder registrieren Sie sich dafür.
Registrieren Sie Ihre App bei AdMob. In diesem Schritt wird eine AdMob-App mit einer eindeutigen AdMob-App-ID erstellt, die später in dieser Anleitung benötigt wird.

Eigene App konfigurieren

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()
    }
}

Fügen Sie die Abhängigkeiten für das Google Mobile Ads SDK der Gradle-Datei Ihres Moduls, normalerweise app/build.gradle, hinzu:
```
dependencies {
  implementation 'com.google.android.gms:play-services-ads:21.1.0'
}
```
Fügen Sie die AdMob App-ID, die Sie in derAdMob-UI finden, in die AndroidManifest.xml-Datei Ihrer App ein. Füge dazu ein <meta-data>-Tag mit android:name="com.google.android.gms.ads.APPLICATION_ID" hinzu. Sie finden die App-ID in der AdMob -UI. Geben Sie für android:value Ihre eigene AdMob Anwendungs-ID in Anführungszeichen ein.
```
<manifest>
    <application>
        
        <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 nur mit dem SDK in einer Hello World-App experimentieren möchten, können Sie die oben gezeigte Beispiel-App-ID verwenden.

Wenn Sie das Tag <meta-data> nicht wie oben gezeigt hinzufügen, stürzt die Nachricht ab:
```
The Google Mobile Ads SDK was initialized incorrectly.
```
Optional: Deklarieren Sie die Berechtigung AD_ID für vorherige Versionen, damit sie mit Android 13 funktionieren.

Wenn in Ihrer App das Google Mobile Ads SDK Version 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 und Zugriff auf die Werbe-ID hat, sobald diese verfügbar ist.

Für Apps, die Version 20.3.0 oder niedriger des Google Mobile Ads SDK 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 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 von com.google.android.gms.permission.AD_ID, einschließlich einer Deaktivierung, finden Sie in diesem Artikel in der Play Console.

Google Mobile Ads SDK initialisieren

Bevor Sie Anzeigen laden, müssen Sie in Ihrer App das Google Mobile Ads SDK initialisieren. Dazu rufen Sie MobileAds.initialize() auf, wodurch das SDK initialisiert und ein Abschluss-Listener nach Abschluss der Initialisierung oder nach einem 30-sekündigen Zeitlimit zurückgerufen wird. Dies muss nur einmal geschehen, idealerweise beim Start der App.

Die Anzeigen können über das Google Mobile Ads SDK oder die Vermittlungspartner-SDKs vorab geladen werden, wenn MobileAds.initialize() aufgerufen wird. Wenn Sie die Einwilligung von Nutzern im Europäischen Wirtschaftsraum (EWR) einholen, anfragenspezifische Flags (z. B. tagForChildDirectedTreatment oder tag_for_under_age_of_consent) festlegen oder anderweitig vor dem Laden von Anzeigen Maßnahmen ergreifen müssen, sollten Sie das unbedingt vor der Initialisierung des Google Mobile Ads SDK tun.

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, sollten Sie warten, bis der Abschluss-Handler aufgerufen wurde, bevor die Anzeigen geladen werden. So wird sichergestellt, dass alle Vermittlungsadapter initialisiert werden.

Anzeigenformat auswählen

Das Google Mobile Ads SDK wurde importiert und Sie können nun eine Anzeige implementieren.AdMob Sie haben die Wahl zwischen verschiedenen Anzeigenformaten, damit Sie das für Ihre App am besten geeignete auswählen können.

Rechteckige Anzeigen, die oben oder unten auf dem Bildschirm 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 keine Erfahrung mit mobiler Werbung haben, ist 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 Levels oder kurz nachdem eine Aufgabe abgeschlossen ist.

Interstitial-Anzeigen implementieren

Nativ

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

Native Anzeigen implementieren

Verfügbar

Anzeigen, in denen Nutzer für das Ansehen kurzer Videos und die Interaktion mit spielbaren Anzeigen und Umfragen belohnt werden. Wird zur Monetarisierung kostenloser Apps verwendet.

Anzeigen mit Prämie implementieren

Weitere Informationen

Im Google Mobile Ads-Repository auf GitHub wird gezeigt, wie die verschiedenen Anzeigenformate verwendet werden, die in dieser API verfügbar sind.