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

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

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, dass Sie warten, bis die Initialisierung abgeschlossen ist, bevor Sie Anzeigen laden. So wird sichergestellt, dass alle Werbenetzwerke an der ersten Anzeigenanfrage teilnehmen.

Im folgenden Beispielcode wird gezeigt, wie Sie den Initialisierungsstatus jedes Adapters 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 flutterProjectRoot = rootProject.projectDir.parentFile.toPath()
def plugins = new Properties()
def pluginsFile = new File(flutterProjectRoot.toFile(), '.flutter-plugins')
if (pluginsFile.exists()) {
    pluginsFile.withInputStream { stream -> plugins.load(stream) }
}

plugins.each { name, path ->
    def pluginDirectory = flutterProjectRoot.resolve(path).resolve('android').toFile()
    include ":$name"
    project(":$name").projectDir = pluginDirectory
}

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 sie hinzufügen, indem Sie die Datei build.gradle auf Android-Geräten und Podfile auf iOS-Geräten auf App-Ebene aktualisieren. Google stellt auf GitHub Open-Source-Adapter sowohl für Android als auch für iOS bereit.

In den Dokumentationen Android und iOS für die einzelnen Partnernetzwerke findest du eine detaillierte Anleitung dazu, wie du den Adapter in deine App einbindest.

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

Im folgenden Codebeispiel wird gezeigt, wie der Name der Anzeigenetzwerkklasse für eine Banneranzeige protokolliert wird:

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

Deaktivieren Sie die Aktualisierung in allen UIs von Drittanbieter-Anzeigenquellen für Banneranzeigenblöcke, die bei der Vermittlung verwendet werden. So wird verhindert, dass eine Aktualisierung doppelt ausgeführt wird, 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 für die Implementierung der nativen Vermittlung.

Richtlinie zur Präsentation nativer Anzeigen
Jedes Werbenetzwerk hat eigene Richtlinien. Bei der Vermittlung ist es wichtig, dass Ihre App weiterhin den Richtlinien des vermittelten Werbenetzwerks entspricht, das die Anzeige bereitgestellt hat.

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

Weitere Informationen zum Aktivieren der eingeschränkten Datenverarbeitung und zum Einholen der DSGVO-Einwilligung mit dem UMP SDK
Weiter
Netzwerke auswählen