Jetzt starten

In diesem Leitfaden erfahren Sie, wie Sie einen Vermittlungsadapter mit Ihrem Android-App

Vorbereitung

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

Sie sind neu bei der Vermittlung? Gelesen Einführung in die Vermittlung

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

Mobile Ads SDK initialisieren

In der Kurzanleitung erfahren Sie, wie Sie das Mobile Ads SDK initialisieren. Während dieses Initialisierungsaufrufs werden auch Vermittlungsadapter initialisiert. Es ist wichtig, zu warten, bis die Initialisierung abgeschlossen ist, bevor laden Sie Anzeigen, um eine vollständige Beteiligung aller Kunden-Netzwerke im für die erste Anzeigenanfrage.

Der folgende Beispielcode zeigt, wie Sie die Initialisierung jedes Adapters überprüfen können. bevor eine Anzeigenanfrage gesendet wird.

Java

import com.google.android.gms.ads.MobileAds;
import com.google.android.gms.ads.initialization.AdapterStatus;
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);

        new Thread(
                () ->
                    // Initialize the Google Mobile Ads SDK on a background thread.
                    MobileAds.initialize(
                        this,
                        initializationStatus -> {
                          Map<String, AdapterStatus> statusMap =
                              initializationStatus.getAdapterStatusMap();
                          for (String adapterClass : statusMap.keySet()) {
                            AdapterStatus status = statusMap.get(adapterClass);
                            Log.d(
                                "MyApp",
                                String.format(
                                    "Adapter name: %s, Description: %s, Latency: %d",
                                    adapterClass, status.getDescription(), status.getLatency()));
                          }
                          // Start loading ads here...
                        }))
            .start();
    }
}

Kotlin

import com.google.android.gms.ads.MobileAds
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.launch

class MainActivity : AppCompatActivity() {
  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)

    val backgroundScope = CoroutineScope(Dispatchers.IO)
    backgroundScope.launch {
      // Initialize the Google Mobile Ads SDK on a background thread.
      MobileAds.initialize(this@MainActivity) { initializationStatus ->
        val statusMap =
          initializationStatus.adapterStatusMap
        for (adapterClass in statusMap.keys) {
          val status = statusMap[adapterClass]
          Log.d(
            "MyApp", String.format(
              "Adapter name: %s, Description: %s, Latency: %d",
              adapterClass, status!!.description, status.latency
            )
          )
        }
        // Start loading ads here...
      }
    }
  }
}

Überprüfen, mit welcher Adapterklasse für das Werbenetzwerk die Anzeige geladen wurde

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

Java

public void onAdLoaded() {
  Log.d("Banner adapter class name: " + ad.getResponseInfo().getMediationAdapterClassName());
}

Kotlin

override fun onAdLoaded() {
  Log.d("Banner adapter class name:" + ad.responseInfo.mediationAdapterClassName)
}

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

Anzeigenobjekt mit einer Activity-Instanz initialisieren

Im Konstruktor eines neuen Anzeigenobjekts (z. B. AdManagerAdView), müssen Sie ein Objekt des Typs Context Dieser Context wird bei Verwendung der Vermittlung an andere Werbenetzwerke übergeben. Einige Werbenetzwerke erfordern eine restriktivere Context vom Typ Activity und können ohne Activity-Instanz möglicherweise keine Anzeigen ausliefern. Dementsprechend wird wir empfehlen, beim Initialisieren von Anzeigenobjekten eine Activity-Instanz zu übergeben um eine konsistente Nutzererfahrung mit Ihren vermittelten Werbenetzwerken zu gewährleisten.

Banneranzeigen mit Vermittlung verwenden

Deaktivieren Sie die Aktualisierung in allen Benutzeroberflächen von Drittanbieter-Anzeigenquellen für Banneranzeigen in der Vermittlung verwendete Einheiten. Dadurch wird verhindert, da auch Ad Manager eine Aktualisierung auslöst, basierend auf der Aktualisierungsrate Ihres Banneranzeigenblocks.

Native Anzeigen mit Vermittlung verwenden

Im Folgenden finden Sie einige Best Practices für die Implementierung nativer Anzeigen. Vermittlung.

Richtlinie zur Darstellung nativer Anzeigen
Für jedes Werbenetzwerk gelten eigene Richtlinien. Bei der Vermittlung ist es wichtig, dass Ihre App weiterhin den Richtlinien der vermittelten 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 Bestimmungen der Datenschutz für Staaten oder die Datenschutz-Grundverordnung Verordnung (DSGVO), befolgen Sie die Schritte in Verordnungen von US-Bundesstaaten Einstellungen oder DSGVO Einstellungen, um Ihre Vermittlungspartner in Ad Manager Messaging- Liste der US-Bundesstaaten oder der DSGVO-Werbepartner. Andernfalls können Partner keine Anzeigen in Ihrer App ausliefern.

Weitere Informationen zum Aktivieren der eingeschränkten Datenverarbeitung eingeschränkter Datenverarbeitung und Einholung der DSGVO Einwilligung mit der Google User Messaging Platform (UMP) SDK.