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:
- Banneranzeigen
- Interstitial-Anzeigen
- Native Anzeigen
- Anzeigen mit Prämie
- Interstitial-Anzeigen mit Prämie
Neu bei der Vermittlung? Einführung in die Vermittlung
Google Mobile Ads Flutter Plugin initialisieren
In der Kurzanleitung wird beschrieben, wie Sie Google Mobile Ads Flutter Plugin 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.
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 auf GitHub Open-Source-Adapter für Android und iOS an.
In der Dokumentation zu Android und iOS für die einzelnen Partnernetzwerke finden Sie eine detaillierte Anleitung zum Hinzufügen des Adapters in Ihrer App.
Prüfen, welche Adapterklasse des Werbenetzwerks die Anzeige geladen hat
Im folgenden Beispielcode wird gezeigt, wie der Klassenname des Werbenetzwerks 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 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.
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.