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. Sie erfahren, wie Sie „Liftoff Monetize“ Vermittlungskonfiguration und das Integrieren des Vungle SDK und des Adapters in eine Flutter App.
Unterstützte Integrationen und Anzeigenformate
Integration | |
---|---|
Gebote | |
Wasserfall | |
Formate | |
App öffnen | 1 3. |
Banner | 2 |
Interstitial | |
Verfügbar | |
Interstitial mit Prämie | 2 |
1 Gebote Die Integration 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
- Auf Android-Geräten bereitstellen
<ph type="x-smartling-placeholder">
- </ph>
- Android API-Level 21 oder höher
- Auf iOS-Geräten bereitstellen
<ph type="x-smartling-placeholder">
- </ph>
- 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 Weitere Informationen
- Vermittlung abschließen Startleitfaden
Schritt 1: Konfigurationen in der Benutzeroberfläche von Liftoff Monetize einrichten
Registrieren Sie sich oder melden Sie sich in Ihrem Liftoff Monet-Konto an.
Fügen Sie Ihre App dem Dashboard von Liftoff Monetize hinzu, indem Sie auf die Schaltfläche Anwendung hinzufügen klicken.
Füllen Sie das Formular aus und geben Sie alle erforderlichen Informationen ein.
Android
iOS
Nachdem die App erstellt wurde, wählen Sie sie im Liftoff Monetize Applications-Dashboard aus.
Android
iOS
Notieren Sie sich die App-ID.
Android
iOS
Neue Placements hinzufügen
Wenn Sie ein neues Placement für die Vermittlung erstellen möchten, AdMobrufen Sie das Dashboard „Liftoff Monetize Placements“ auf, klicken Sie auf die Schaltfläche Placement hinzufügen und wählen Sie Ihre App aus der Drop-down-Liste aus.
Details zum Hinzufügen neuer Placements finden Sie unten:
App öffnen
Wählen Sie Interstitial aus und geben Sie einen Placement-Namen ein. Wählen Sie dann für Überspringbar die Option Ja aus und füllen Sie den Rest des Formulars aus. [Nur Bidding] Stellen Sie unter Monetarisierung den Schieberegler für In-App-Gebote auf Aktiviert. Klicken Sie unten auf der Seite auf Weiter, um das Placement zu erstellen.
Banner
Wählen Sie Banner aus, geben Sie einen Placement-Namen ein und füllen Sie das Formular aus. [Nur Bidding] Stellen Sie unter Monetarisierung den Schieberegler für In-App-Gebote auf Aktiviert. Klicken Sie unten auf der Seite auf die Schaltfläche Weiter, um das Placement zu erstellen.
Banner 300 x 250
Wählen Sie MREC aus, geben Sie einen Placement-Namen ein und füllen Sie den Rest des Formulars aus. [Nur Bidding] Stellen Sie unter Monetarisierung den Schieberegler für In-App-Gebote auf Aktiviert. Klicken Sie unten auf der Seite auf die Schaltfläche Weiter, um das Placement zu erstellen.
Interstitial
Wählen Sie Interstitial aus, geben Sie einen Placement-Namen ein und füllen Sie den Rest des Formulars aus. [Nur Bidding] Stellen Sie unter Monetarisierung den Schieberegler für In-App-Gebote auf Aktiviert. Klicken Sie unten auf der Seite auf die Schaltfläche Weiter, um das Placement zu erstellen.
Verfügbar
Wählen Sie Mit Prämie aus, geben Sie einen Placement-Namen ein und füllen Sie den Rest des Formulars aus. [Nur Bidding] Stellen Sie unter Monetarisierung den Schieberegler für In-App-Gebote auf Aktiviert. Klicken Sie unten auf der Seite auf die Schaltfläche Weiter, um das Placement zu erstellen.
Interstitial mit Prämie
Wählen Sie Mit Prämie aus. Geben Sie einen Placement-Namen ein, aktivieren Sie Überspringbar und füllen Sie den Rest des Formulars aus. [Nur Bidding] Stellen Sie unter Monetarisierung den Schieberegler für In-App-Gebote auf Aktiviert. Klicken Sie unten auf der Seite auf die Schaltfläche Weiter, um das Placement zu erstellen.
Nativ
Wählen Sie Nativ aus, geben Sie einen Placement-Namen ein und füllen Sie den Rest des Formulars aus. [Nur Bidding] Stellen Sie unter Monetarisierung den Schieberegler für In-App-Gebote auf Aktiviert. Klicken Sie unten auf der Seite auf die Schaltfläche Weiter, um das Placement zu erstellen.
Notieren Sie sich die Referenz-ID und klicken Sie auf Klingt gut.
App öffnen
Banner
Banner 300 x 250
Interstitial
Verfügbar
Interstitial mit Prämie
Nativ
Schlüssel für die Reporting API finden
Gebote
Dieser Schritt ist für die Verknüpfung von Geboten nicht erforderlich.
Wasserfall
Neben der App-ID und der Referenz-ID benötigen Sie auch Ihren Reporting API-Schlüssel von Liftoff Monetize für dieAdMob Anzeigenblock-ID. Rufen Sie das Dashboard „Liftoff Monetize Reports“ auf und klicken Sie auf die Schaltfläche Reporting API Key, um Ihren Reporting API-Schlüssel aufzurufen.
Testmodus aktivieren
Um Testanzeigen zu aktivieren, rufen Sie das Liftoff Monetize-Dashboard auf und gehen Sie zu Anwendungen.
Wählen Sie im Bereich Placement-Referenz-ID der App die App aus, für die Sie Testanzeigen aktivieren möchten. Wählen Sie zum Aktivieren von Testanzeigen im Bereich Status von Testmodus die Option Nur Testanzeigen anzeigen aus.
Android
iOS
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
Laden Sie die aktuelle Version des Google Mobile Ads Mediation-Plug-ins für
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 wird die Einwilligungsentscheidung des Nutzers automatisch an diese Netzwerke übergeben.
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");
Anleitungen zur Umsetzung der DSGVO finden Sie hier: 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 dieser Nutzungsbedingungen), wobei die Widerspruchsmöglichkeit über einen gut sichtbaren "Do Not Sell My Personal"-Artikel 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, Vermittlungskette, die am Verkauf von persönlichen und folgen den Leitlinien der einzelnen Netzwerke, um sicherzustellen, Compliance.
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 finden Sie in der vom CCPA empfohlenen Implementierungsanleitung für Android und iOS für weitere Informationen und die Werte, die in der Methode angegeben werden können.
Schritt 5: Erforderlichen Code hinzufügen
Android
Es ist kein zusätzlicher Code für die Liftoff Monetize-Integration 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:
iOS
Format | Klassenname |
---|---|
Banner | GADMAdapterVungleInterstitial |
Interstitial | GADMAdapterVungleInterstitial |
Verfügbar | GADMAdapterVungleRewardBasedVideoAd |
Hier sind die Codes und die dazugehörigen Nachrichten, die vom Liftoff Monetize ausgegeben werden. Adapter, wenn eine Anzeige nicht geladen werden kann:
iOS
Fehlercode | Grund |
---|---|
1-100 | Das Vungle SDK hat einen Fehler zurückgegeben. Siehe Code . |
101 | Die in der AdMob UI konfigurierten Serverparameter für Liftoff Monetize fehlen oder sind ungültig. |
102 | Für diese Netzwerkkonfiguration wurde bereits eine Anzeige geladen. Das Vungle SDK kann keine zweite Anzeige für dieselbe Placement-ID laden. |
103 | Die angeforderte Anzeigengröße stimmt nicht mit einer von Liftoff Monetize unterstützten Bannergröße überein. |
104 | Das Vungle SDK konnte die Banneranzeige nicht rendern. |
105 | Das Vungle SDK unterstützt unabhängig von der Placement-ID jeweils nur das Laden einer Banneranzeige. |
106 | Das Vungle SDK hat einen Callback mit dem Hinweis gesendet, dass die Anzeige nicht wiedergegeben werden kann. |
Liftoff Monetize Flutter Mediation Adapter – Änderungsprotokoll
Version 1.0.0
- Erste Version
- Die Kompatibilität mit dem Android-Adapter von Liftoff Monetize Version 7.3.1.0 wurde bestätigt
- Die Kompatibilität mit LiftoffMonetize iOS-Adapterversion 7.3.2.0 wurde bestätigt.
- Erstellt und getestet mit dem Google Mobile Ads Flutter-Plug-in Version 5.1.0.