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 schalten und Einnahmen erzielen zu können. Nachdem Sie das SDK eingebunden haben, können Sie ein Anzeigenformat auswählen (z. B. native oder Videoanzeigen mit Prämie) und der Anleitung zur Implementierung folgen.

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

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 in die Gradle-Datei Ihres Moduls (normalerweise app/build.gradle) ein:
```
dependencies {
  implementation 'com.google.android.gms:play-services-ads:21.5.0'
}
```
Fügen Sie die Ad Manager App-ID (identifiziert in derAd Manager-UI) in die Datei AndroidManifest.xml der Anwendung ein. 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 Ad Manager Benutzeroberfläche. Geben Sie für android:value Ihre eigene Ad Manager App-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 Ad Manager 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 das <meta-data>-Tag nicht wie oben gezeigt hinzugefügt wird, kommt es zu einem Absturz mit der Meldung:
```
The Google Mobile Ads SDK was initialized incorrectly.
```
(Optional) Deklarieren Sie die AD_ID-Berechtigung für vorherige Versionen, um Android 13 zu verwenden.

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

Bei Apps, die Version 20.3.0 des Google Mobile Ads SDKs oder niedriger verwenden und auf Android 13 ausgerichtet sind, musst du 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 von com.google.android.gms.permission.AD_ID-Berechtigungen, einschließlich ihrer Deaktivierung, findest du in diesem Play Console-Artikel.

Google Mobile Ads SDK initialisieren

Bevor Sie Anzeigen laden, muss Ihre App das Google Mobile Ads SDK initialisieren. Dazu wird MobileAds.initialize() aufgerufen. Damit wird das SDK initialisiert und ein Abschluss-Listener nach Abschluss der Initialisierung (oder nach einem 30-Sekunden-Zeitlimit) aufgerufen. Dies muss nur einmal geschehen, idealerweise beim Start der Anwendung.

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 der Nutzer im Europäischen Wirtschaftsraum (EWR) einholen möchten, anfragespezifische Flags (z. B. tagForChildDirectedTreatment oder tag_for_under_age_of_consent) setzen oder anderweitig Maßnahmen ergreifen möchten, bevor Sie Anzeigen laden, müssen Sie das tun, bevor Sie das Google Mobile Ads SDK initialisieren.

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 wird, bevor Sie die Anzeigen laden, damit alle Vermittlungsadapter initialisiert werden.

Anzeigenformat auswählen

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

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, ist das ein guter Ausgangspunkt.

Banneranzeigen implementieren

Interstitial

Vollbildanzeigen, die die Benutzeroberfläche einer App verdecken, bis sie vom Nutzer geschlossen werden Sie werden am besten bei natürlichen Pausen während der Ausführung einer App eingesetzt, z. B. zwischen Levels eines Spiels 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 zum Design Ihrer App.

In Google Ad Manager gibt es zwei Möglichkeiten, native Anzeigen zu implementieren: native Designs und benutzerdefiniertes Rendering.

Native Designs wurden so gestaltet, dass die Implementierung nativer Anzeigen so einfach wie möglich ist. Wenn Sie mit dem Format noch nicht vertraut sind, ist es die richtige Wahl. Das benutzerdefinierte Rendering wurde entwickelt, um die Freiheit beim Erstellen von Präsentationen zu maximieren.

Native Anzeigen implementieren

Native Designs implementieren

Verfügbar

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

Anzeigen mit Prämie implementieren

Weitere Informationen

Das Google Mobile Ads-Repository auf GitHub zeigt, wie die verschiedenen Anzeigenformate für diese API verwendet werden.