Vermittlung einrichten

Plattform auswählen: Android iOS Unity Flutter Android (Legacy)

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 dieses Anzeigenformat in Ihre App einbinden:

Neu bei der Vermittlung? Einführung in die Vermittlung

Für Bidding: Google Mobile Ads SDK (Legacy) 18.3.0 oder höher.

Google Mobile Ads SDK (Legacy) initialisieren

In der Kurzanleitung wird beschrieben, wie Sie Google Mobile Ads SDK (Legacy) initialisieren. Während dieses Initialisierungsaufrufs werden auch Vermittlungsadapter initialisiert. Es ist wichtig, mit dem Laden von Anzeigen zu warten, bis die Initialisierung abgeschlossen ist. So wird sichergestellt, dass alle Werbenetzwerke bei der ersten Anzeigenanfrage berücksichtigt werden.

Im folgenden Beispielcode wird gezeigt, wie Sie den Initialisierungsstatus der einzelnen Adapter prüfen, 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()));
  }
}

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",
    )
  }
}

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

Hier ist ein 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);

Kotlin

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

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. Diese Context wird bei der Vermittlung an andere Werbenetzwerke weitergegeben. Einige Werbenetzwerke erfordern einen restriktiveren Context vom Typ Activity und können ohne eine Activity-Instanz möglicherweise keine Anzeigen ausliefern. Wir empfehlen daher, beim Initialisieren von Anzeigenobjekten eine Activity-Instanz zu übergeben, um eine einheitliche Nutzung mit Ihren vermittelten Werbenetzwerken zu gewährleisten.

Deaktivieren Sie die Aktualisierung in allen Benutzeroberflächen von Drittanbieter-Anzeigenquellen für Banneranzeigenblöcke, die in der Vermittlung verwendet werden. 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

Im Folgenden finden Sie einige Best Practices, die Sie bei der Implementierung der nativen Vermittlung berücksichtigen sollten.

Richtlinie zur Darstellung nativer Anzeigen
Jedes Werbenetzwerk hat eigene Richtlinien. Bei der Verwendung der Vermittlung ist es wichtig, dass Ihre App weiterhin den Richtlinien des vermittelten Netzwerks entspricht, das die Anzeige bereitgestellt hat.
loadAd() anstelle von loadAds() verwenden
Mit der loadAds()-Methode werden nur Google Anzeigen ausgeliefert. Verwenden Sie für Anzeigen mit Vermittlung stattdessen loadAd().

Datenschutzgesetze von US-Bundesstaaten und DSGVO

Wenn Sie die Datenschutzgesetze von 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 Ad Manager unter „Datenschutz und Mitteilungen“ in die Liste der Werbepartner für US-Bundesstaaten oder die DSGVO aufzunehmen. Andernfalls kann es passieren, dass Partner keine Anzeigen in Ihrer App ausliefern können.

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

Weiter
Anzeigenquellen auswählen