Mediation

In diesem Leitfaden erfahren Sie, wie Sie einen Vermittlungsadapter in Ihre Flutter-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

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.

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  
  MobileAds.instance.initialize()
    .then((initializationStatus) {
      initializationStatus.adapterStatuses.forEach((key, value) {
        debugPrint('Adapter status for $key: ${value.description}');
      });
  });
  
  runApp(MyApp());
}

Gradle-Einstellungen aktualisieren (nur Android)

Fügen Sie der Datei settings.gradle die folgenden Zeilen hinzu, damit Sie die Android-APIs des Plug-ins verwenden können:

def flutterSdkPath = {
    def properties = new Properties()
    file("local.properties").withInputStream { properties.load(it) }
    def flutterSdkPath = properties.getProperty("flutter.sdk")
    assert flutterSdkPath != null, "flutter.sdk not set in local.properties"
    return flutterSdkPath
}()

includeBuild("$flutterSdkPath/packages/flutter_tools/gradle")

Abhängigkeiten für Partnernetzwerke hinzufügen

Die Vermittlungsadapter und ihre Abhängigkeiten müssen Ihren Android- und iOS-Projekten hinzugefügt werden. Sie können hinzugefügt werden, indem Sie die Datei build.gradle auf App-Ebene unter Android und Podfile unter iOS aktualisieren. Google bietet Open-Source-Adapter auf GitHub für Android und iOS an.

In der Dokumentation für die einzelnen Partnernetzwerke finden Sie detaillierte Anleitungen zum Hinzufügen des jeweiligen Adapters in Ihrer App: Android und iOS.

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

Im folgenden Beispielcode wird gezeigt, wie Sie den Klassennamen des Werbenetzwerks für eine Banneranzeige protokollieren:

final bannerAd = AdManagerBannerAd(
      size: [AdSize.banner],
      adUnitId: '<your-ad-unit>',
      listener: AdManagerBannerAdListener(
        onAdLoaded: (ad) {
          debugPrint('$ad loaded: ${ad.responseInfo?.mediationAdapterClassName}');
        },
      ),
      request: AdManagerAdRequest(),
    );

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.

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