In diesem Leitfaden erfahren Sie, wie Sie mit dem Google Mobile Ads SDK von Liftoff Monetize mit Vermittlung, die sowohl Bidding als auch abfolgebasierte Integrationen. Darin wird beschrieben, wie Sie Liftoff Monetize zur Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und das Vungle SDK und den Adapter in eineFlutter App einbinden.
Unterstützte Integrationen und Anzeigenformate
Integration | |
---|---|
Gebote | |
Wasserfall | |
Formate | |
App öffnen | 1 3. |
Banner | 2 |
Interstitial | |
Verfügbar | |
Interstitial mit Prämie | 2 |
1 Die Gebotsintegration für dieses Format befindet sich in der geschlossenen Betaphase.
2 Gebote Die Integration für dieses Format befindet sich in der offenen Betaphase.
3 Wasserfall Die Integration für dieses Format befindet sich in der geschlossenen Betaphase.
Voraussetzungen
- Neuestes Google Mobile Ads SDK
- Flutter 3.7.0 oder höher
- Bereitstellung auf Android-Geräten
- Android API-Level 21 oder höher
- Auf iOS-Geräten bereitstellen
- iOS-Bereitstellungsziel von 12.0 oder höher
- Ein funktionierendes Flutter Projekt, das konfiguriert wurde mit Google Mobile Ads SDK. Weitere Informationen finden Sie unter Erste Schritte.
- Vermittlung abschließen Startleitfaden
Schritt 1: Konfigurationen in der Benutzeroberfläche von Liftoff Monetize einrichten
Schritt 2: Liftoff „Monetarisierung der Nachfrage“ AdMob in der Benutzeroberfläche einrichten
Vermittlungseinstellungen für Anzeigenblöcke konfigurieren
Android
Eine Anleitung finden Sie in Schritt 2 der Anleitung für Android.
iOS
Eine Anleitung dazu finden Sie in Schritt 2 der Anleitung für iOS.
Zur Liste der Werbepartner zur DSGVO und zu Verordnungen von US-Bundesstaaten hinzufügen Liftoff
Folgen Sie den Schritten unter DSGVO-Einstellungen und Einstellungen zu Bestimmungen von US-Bundesstaaten um Liftoff in die Liste der Werbepartner gemäß DSGVO und US-Bundesstaaten auf der AdMob Benutzeroberfläche aufzunehmen.
Schritt 3: Vungle SDK und Liftoff Monetize Adapter importieren
Integration über pub.dev
Fügen Sie die folgende Abhängigkeit mit den neuesten Versionen des
Liftoff Monetize SDK und Adapter im
pubspec.yaml
-Datei:
dependencies:
gma_mediation_liftoffmonetize: ^1.0.0
Manuelle Integration
Neueste Version des Google Mobile Ads Mediation-Plug-ins für herunterladen
Liftoff Monetize,
entpacken Sie die heruntergeladene Datei und fügen Sie den extrahierten Plug-in-Ordner hinzu.
in Ihr Flutter-Projekt hochladen. Verweisen Sie dann auf das Plug-in in der
pubspec.yaml
-Datei durch Hinzufügen der folgenden Abhängigkeit:
dependencies:
gma_mediation_liftoffmonetize:
path: path/to/local/package
Schritt 4: Datenschutzeinstellungen für das Liftoff Monetize SDK implementieren
Einwilligung der Nutzer in der EU und DSGVO
Gemäß der Google-Einwilligung der Nutzer in der EU den Richtlinien entsprechen, müssen Sie sicherstellen, dass bestimmte Personen Einwilligungen von Nutzern im Europäischen Wirtschaftsraum (EWR) bezüglich die Verwendung von Gerätekennungen und personenbezogenen Daten. Diese Richtlinie entspricht den der EU-Datenschutzrichtlinie für elektronische Kommunikation und der EU-Datenschutz-Grundverordnung Verordnung (DSGVO) aufgeführt. Beim Einholen der Einwilligung müssen Sie jedes Werbenetzwerk angeben in Ihrer Vermittlungskette, die personenbezogene Daten erheben, erhalten oder nutzen, Informationen zur Nutzung der einzelnen Werbenetzwerke enthalten. Google kann derzeit nicht automatisch an solche Werbenetzwerke übergeben wird.
Das Google Mobile Ads-Vermittlungs-Plug-in für Liftoff Monetize umfasst Folgendes:
GmaMediationLiftoffmonetize.setGDPRStatus()
-Methode. Der folgende Beispielcode
zeigt, wie Einwilligungsinformationen an das Vungle SDK übergeben werden. Wenn Sie
diese Methode aufrufen, wird empfohlen, diese vor dem Anfordern von Anzeigen über
das Google Mobile Ads SDK.
import 'package:gma_mediation_liftoffmonetize/gma_mediation_liftoffmonetize.dart';
// ...
GmaMediationLiftoffmonetize.setGDPRStatus(true, "1.0.0");
Siehe Implementierungsanleitung für die DSGVO-Empfehlungen für Android und iOS für weitere Informationen sowie die Werte, die in der Methode bereitgestellt werden können.
Datenschutzgesetze von US-Bundesstaaten
USA Datenschutzgesetze von Bundesstaaten müssen Sie den Nutzern das Angebot des Angebots ihrer "personenbezogenen Daten" (wie das Gesetz definiert der vorliegenden Nutzungsbedingungen), wobei die Widerspruchsmöglichkeit über die deutlich sichtbare „Do Not Sell My Personal“- Informationen“ auf den Link „Verkauf“ die Startseite der Party. Die USA Datenschutz für Staaten Leitfaden zur Einhaltung gesetzlicher Vorschriften die Möglichkeit, eingeschränkte Datenverarbeitung für die Anzeigenbereitstellung durch Google, aber Google kann diese Einstellung nicht auf jede Anzeige anwenden Netzwerk in Ihrer Vermittlungskette. Daher müssen Sie jedes Werbenetzwerk in Ihrer Vermittlungskette identifizieren, das am Verkauf personenbezogener Daten beteiligt sein könnte, und die Anleitungen dieser Netzwerke befolgen, um die Einhaltung der Anforderungen sicherzustellen.
Das Google Mobile Ads-Vermittlungs-Plug-in für Liftoff Monetize umfasst Folgendes:
GmaMediationLiftoffmonetize.setCCPAStatus()
-Methode. Der folgende Beispielcode
zeigt, wie Einwilligungsinformationen an das Vungle SDK übergeben werden. Wenn Sie
diese Methode aufrufen, wird empfohlen, diese vor dem Anfordern von Anzeigen über
das Google Mobile Ads SDK.
import 'package:gma_mediation_liftoffmonetize/gma_mediation_liftoffmonetize.dart';
// ...
GmaMediationLiftoffmonetize.setCCPAStatus(true);
Weitere Informationen und die Werte, die in der Methode angegeben werden können, finden Sie in den empfohlenen Implementierungsanleitungen für den CCPA für Android und iOS.
Schritt 5: Erforderlichen Code hinzufügen
Android
Für die Monetarisierungs-Integration von Liftoff ist kein zusätzlicher Code erforderlich.
iOS
SKAdNetwork-Integration
Folge Liftoff Monetize
Dokumentation
um die SKAdNetwork-IDs zur Info.plist
-Datei Ihres Projekts hinzuzufügen.
Schritt 6: Implementierung testen
Testanzeigen aktivieren
Registrieren Sie Ihr Testgerät für AdMob und aktivieren Sie den Testmodus in der Liftoff Monetize Benutzeroberfläche.
Testanzeigen überprüfen
Wenn Sie prüfen möchten, ob Sie Testanzeigen vonLiftoff Monetizeerhalten, aktivieren Sie im Anzeigenprüftool mithilfe der Liftoff Monetize (Bidding) and Liftoff Monetize (Waterfall) Anzeigenquellen den Test für eine einzelne Anzeigenquelle.
Fehlercodes
Wenn der Adapter keine Anzeige von Liftoff Monetize erhält, können Publisher
Überprüfen Sie den zugrunde liegenden Fehler der Anzeigenantwort mithilfe von
ResponseInfo
in den folgenden Klassen:
Android
Format | Klassenname |
---|---|
App-Start-Anzeigen (Bidding) | com.google.ads.mediation.vungle.VungleMediationAdapter |
App-Start (Abfolge) | com.google.ads.mediation.vungle.VungleMediationAdapter |
Banner (Gebote) | com.google.ads.mediation.vungle.VungleMediationAdapter |
Banner (Wasserfall) | com.vungle.mediation.VungleInterstitialAdapter |
Interstitial (Gebote) | com.google.ads.mediation.vungle.VungleMediationAdapter |
Interstitial (Wasserfall) | com.vungle.mediation.VungleInterstitialAdapter |
Mit Prämie (Gebote) | com.google.ads.mediation.vungle.VungleMediationAdapter |
Mit Prämie (Abfolge) | com.vungle.mediation.VungleAdapter |
Interstitial mit Prämie (Gebote) | com.google.ads.mediation.vungle.VungleMediationAdapter |
Interstitial mit Prämie (Wasserfall) | com.google.ads.mediation.vungle.VungleMediationAdapter |
iOS
Format | Klassenname |
---|---|
App-Start (Gebotsfunktion) | GADMediationAdapterVungle |
App-Start (Wasserfall) | GADMediationAdapterVungle |
Banner (Gebote) | GADMediationAdapterVungle |
Banner (Wasserfall) | GADMAdapterVungleInterstitial |
Interstitial (Gebote) | GADMediationAdapterVungle |
Interstitial (Wasserfall) | GADMAdapterVungleInterstitial |
Mit Prämie (Gebote) | GADMediationAdapterVungle |
Mit Prämie (Abfolge) | GADMAdapterVungleRewardBasedVideoAd |
Interstitial mit Prämie (Gebote) | GADMediationAdapterVungle |
Interstitial mit Prämie (Wasserfall) | GADMediationAdapterVungle |
Hier sind die Codes und zugehörigen Nachrichten, die vom Liftoff Monetize ausgegeben werden. Adapter, wenn eine Anzeige nicht geladen werden kann:
Android
Fehlercode | Grund |
---|---|
101 | Ungültige Serverparameter (z. B. App-ID oder Placement-ID) |
102 | Die angeforderte Bannergröße ist keiner gültigen Liftoff-Monetarisieren-Anzeige zugeordnet. Größe. |
103 | Für Liftoff Monetize ist ein Activity -Kontext erforderlich
Anzeigen. |
104 | Mit dem Vungle SDK können nicht mehrere Anzeigen für dasselbe Placement geladen werden ID. |
105 | Das Vungle SDK konnte nicht initialisiert werden. |
106 | Das Vungle SDK hat einen erfolgreichen Lade-Callback zurückgegeben, aber Banners.getBanner() oder Vungle.getNativeAd() haben null zurückgegeben. |
107 | Das Vungle SDK ist zur Wiedergabe der Anzeige nicht bereit. |
108 | Das Vungle SDK hat ein ungültiges Gebotstoken zurückgegeben. |
iOS
Fehlercode | Grund |
---|---|
101 | Ungültige Serverparameter (z. B. App-ID oder Placement-ID) |
102 | Für diese Netzwerkkonfiguration wurde bereits eine Anzeige geladen. Vungle-SDK Für dieselbe Placement-ID kann keine zweite Anzeige geladen werden. |
103 | Die angeforderte Anzeigengröße entspricht nicht einer von Liftoff Monetize unterstützten Bannergröße. |
104 | Das Vungle SDK konnte die Banneranzeige nicht rendern. |
105 | Das Vungle SDK unterstützt jeweils nur das Laden einer Banneranzeige, Placement-ID |
106 | Das Vungle SDK hat einen Callback mit dem Hinweis gesendet, dass die Anzeige nicht wiedergegeben werden kann. |
107 | Das Vungle SDK ist zur Wiedergabe der Anzeige nicht bereit. |
Informationen zu Fehlern, die vom Vungle SDK stammen, finden Sie unter Error Codes: Vungle SDK for iOS and Android (Fehlercodes: Vungle SDK for iOS und Android).
Änderungsprotokoll für den Liftoff Monetize Flutter-Vermittlungsadapter
Version 1.0.0
- Erste Version
- Kompatibilität mit der Android-Adapterversion 7.3.1.0 von Liftoff Monetize bestätigt
- Geprüfte Kompatibilität mit LiftoffMonetize iOS-Adapterversion 7.3.2.0
- Erstellt und getestet mit dem Google Mobile Ads Flutter-Plug-in Version 5.1.0.