Los gehts

In diesem Leitfaden erfahren Sie, wie Sie einen Vermittlungsadapter in Ihre Android-App einbinden.

Vorbereitung

Bevor Sie die Vermittlung für ein Anzeigenformat einbinden können, müssen Sie das Anzeigenformat in Ihre App einbinden:

Sie nutzen die Vermittlungsfunktion zum ersten Mal? Einführung in die Vermittlung

Für Gebote: Google Mobile Ads SDK 18.3.0 oder höher.

Google Mobile Ads SDK initialisieren

Im Schnellstartleitfaden erfahren Sie, wie Sie das Google Mobile Ads SDK initialisieren. Während dieses Initialisierungsaufrufs werden auch Vermittlungsadapter initialisiert. Es ist wichtig, dass Sie mit dem Laden von Anzeigen warten, bis die Initialisierung abgeschlossen ist. So können Sie sicherstellen, dass jedes Anzeigen-Netzwerk an der ersten Anzeigenanfrage beteiligt ist.

Im folgenden Beispielcode sehen Sie, wie Sie den Initialisierungsstatus der einzelnen Adapter prüfen können, bevor Sie eine Anzeigenanfrage senden.

Java

public void initialize(Context context) {
  new Thread(
          () ->
              // Initialize the Google Mobile Ads SDK on a background thread.
              MobileAds.initialize(context, this::logAdapterStatus))
      .start();
}

private void logAdapterStatus(InitializationStatus initializationStatus) {
  // Check each adapter's initialization status.
  Map<String, AdapterStatus> statusMap = initializationStatus.getAdapterStatusMap();
  for (Map.Entry<String, AdapterStatus> entry : statusMap.entrySet()) {
    String adapterClass = entry.getKey();
    AdapterStatus status = entry.getValue();
    Log.d(
        TAG,
        String.format(
            "Adapter name: %s, Description: %s, Latency: %d",
            adapterClass, status.getDescription(), status.getLatency()));
  }
}
MediationSnippets.java

Kotlin

fun initialize(context: Context) {
  CoroutineScope(Dispatchers.IO).launch {
    // Initialize the Google Mobile Ads SDK on a background thread.
    MobileAds.initialize(context, ::logAdapterStatus)
  }
}

private fun logAdapterStatus(initializationStatus: InitializationStatus) {
  // Check each adapter's initialization status.
  for ((adapterClass, status) in initializationStatus.adapterStatusMap) {
    Log.d(
      TAG,
      "Adapter: $adapterClass, Status: ${status.description}, Latency: ${status.latency}ms",
    )
  }
}

MediationSnippets.kt

Prüfen, welche Adapterklasse des Werbenetzwerks die Anzeige geladen hat

Hier ist Beispielcode, mit dem der Klassenname des Werbenetzwerks für eine Banneranzeige protokolliert wird:

Java

ResponseInfo responseInfo = ad.getResponseInfo();
String adapterClassName = null;
if (responseInfo != null) {
  adapterClassName = responseInfo.getMediationAdapterClassName();
}
Log.d(TAG, "Adapter class name: " + adapterClassName);
ResponseInfoSnippets.java

Kotlin

Log.d(TAG, "Adapter class name:" + ad.responseInfo?.mediationAdapterClassName)
ResponseInfoSnippets.kt

Weitere Informationen zu dieser Methode finden Sie in der ResponseInfo-Dokumentation zu getMediationAdapterClassName().

Anzeigenobjekt mit einer Activity-Instanz initialisieren

Im Konstruktor für ein neues Anzeigenobjekt (z. B. AdManagerAdView) müssen Sie ein Objekt vom Typ Context übergeben. Dieser Context wird bei der Vermittlung an andere Werbenetzwerke weitergegeben. Für einige Werbenetzwerke ist eine restriktivere Context vom Typ Activity erforderlich. Ohne eine Activity-Instanz können möglicherweise keine Anzeigen ausgeliefert werden. Wir empfehlen daher, beim Initialisieren von Anzeigenobjekten eine Activity-Instanz zu übergeben, um eine einheitliche Nutzerfreundlichkeit mit Ihren vermittelten Anzeigennetzwerken zu gewährleisten.

Banneranzeigen mit Vermittlung verwenden

Achten Sie darauf, dass die Aktualisierung in allen Benutzeroberflächen von Drittanbieter-Anzeigenquellen für Banneranzeigenblöcke, die in der Vermittlung verwendet werden, deaktiviert ist. So wird eine doppelte Aktualisierung verhindert, da Ad Manager auch eine Aktualisierung basierend auf der Aktualisierungsrate Ihres Banneranzeigenblocks auslöst.

Native Anzeigen mit Vermittlung verwenden

Hier sind einige Best Practices, die Sie bei der Implementierung der nativen Vermittlung berücksichtigen sollten.

Richtlinie zur Darstellung nativer Anzeigen
Jedes Werbenetzwerk hat eigene Richtlinien. Wenn Sie die Vermittlung verwenden, muss Ihre App weiterhin die Richtlinien des vermittelten Netzwerks einhalten, das die Anzeige bereitgestellt hat.
loadAd() anstelle von loadAds() verwenden
Mit der Methode
loadAds() werden nur Google-Anzeigen ausgeliefert. Verwenden Sie für vermittelte Anzeigen stattdessen loadAd().

Datenschutzgesetze von US-Bundesstaaten und DSGVO

Wenn Sie die Datenschutzgesetze der US-Bundesstaaten oder die EU-Datenschutz-Grundverordnung (DSGVO) einhalten müssen, folgen Sie der Anleitung unter Einstellungen für Verordnungen von US-Bundesstaaten oder DSGVO-Einstellungen, um Ihre Vermittlungspartner in der Liste der Anzeigenpartner für US-Bundesstaaten oder die DSGVO unter „Datenschutz und Mitteilungen“ in Ad Manager hinzuzufügen. Andernfalls können Partner möglicherweise keine Anzeigen in Ihrer App ausliefern.

Weitere Informationen zum Aktivieren der eingeschränkten Datenverarbeitung und zum Einholen der Einwilligung gemäß DSGVO mit dem Google User Messaging Platform SDK (UMP SDK)

Weiter
Netzwerke auswählen