In diesem Leitfaden erfahren Sie, wie Sie das Google Mobile Ads SDK verwenden, um Anzeigen aus Liftoff Monetize mithilfe der Vermittlung zu laden und einzublenden. Dabei werden sowohl Gebots- als auch abfolgebasierte Integrationen behandelt. Sie erfahren, wie Sie Liftoff Monetize der 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 Die Gebotsintegration für dieses Format befindet sich in der offenen Betaphase.
3 Die Wasserfall-Integration für dieses Format befindet sich in der geschlossenen Betaphase.
Voraussetzungen
- Das aktuelle Google Mobile Ads SDK
- Flutter 3.7.0 oder höher
- Für die Bereitstellung unter Android
- Android API-Level 21 oder höher
- Für die Bereitstellung unter iOS
- iOS-Bereitstellungsziel 12.0 oder höher
- Ein funktionierendes Flutter Projekt, das mit dem Google Mobile Ads SDK konfiguriert wurde Weitere Informationen finden Sie unter Erste Schritte.
- Arbeiten Sie den Startleitfaden zur Vermittlung ab.
Schritt 1: Konfigurationen in der Liftoff Monetize-Benutzeroberfläche 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 Monetize-Nachfrage in der AdMob 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.
Liftoff zur Liste der Werbepartner gemäß DSGVO und Bestimmungen von US-Bundesstaaten hinzufügen
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 den Liftoff Monetize-Adapter importieren
Integration über pub.dev
Fügen Sie die folgende Abhängigkeit mit den neuesten Versionen desLiftoff Monetize SDK und des Adapters in die Datei pubspec.yaml
des Pakets ein:
dependencies:
gma_mediation_liftoffmonetize: ^1.0.0
Manuelle Integration
Laden Sie die neueste Version des Google Mobile Ads-Vermittlungs-Plug-ins für Liftoff Monetize herunter, extrahieren Sie die heruntergeladene Datei und fügen Sie den extrahierten Plug-in-Ordner (und seinen Inhalt) dem Flutter-Projekt hinzu. Verweisen Sie dann in der Datei pubspec.yaml
auf das Plug-in. Fügen Sie dazu die folgende Abhängigkeit hinzu:
dependencies:
gma_mediation_liftoffmonetize:
path: path/to/local/package
Schritt 4: Datenschutzeinstellungen im Liftoff Monetize SDK implementieren
EU-Einwilligung und DSGVO
Gemäß der Richtlinie zur Einwilligung der Nutzer in der EU von Google müssen Sie dafür sorgen, dass Nutzern im Europäischen Wirtschaftsraum (EWR) bestimmte Informationen zur Verwendung von Gerätekennungen und personenbezogenen Daten offengelegt und deren Einwilligung von diesen eingeholt wird. Die Richtlinie entspricht den Anforderungen der EU-Datenschutzrichtlinie für elektronische Kommunikation und der EU-Datenschutz-Grundverordnung (DSGVO). Wenn Sie die Einwilligung einholen, müssen Sie jedes Werbenetzwerk in Ihrer Vermittlungskette angeben, das personenbezogene Daten erheben, empfangen oder nutzen kann, und Informationen zur Nutzung der einzelnen Werbenetzwerke angeben. Google ist derzeit nicht in der Lage, die Einwilligungsentscheidung des Nutzers automatisch an diese Netzwerke weiterzugeben.
Das Vermittlungs-Plug-in von Google Mobile Ads für Liftoff Monetize enthält die Methode GmaMediationLiftoffmonetize.setGDPRStatus()
. Der folgende Beispielcode zeigt, wie Einwilligungsinformationen an das Vungle SDK übergeben werden. Wenn Sie diese Methode aufrufen, sollte sie vor der Anzeigenanfrage über das Google Mobile Ads SDK aufgerufen werden.
import 'package:gma_mediation_liftoffmonetize/gma_mediation_liftoffmonetize.dart';
// ...
GmaMediationLiftoffmonetize.setGDPRStatus(true, "1.0.0");
Weitere Informationen und die Werte, die in der Methode angegeben werden können, finden Sie in der gemäß der DSGVO empfohlenen Implementierungsanleitung für Android und iOS.
Datenschutzgesetze von US-Bundesstaaten
Datenschutzgesetze von US-Bundesstaaten schreiben Nutzern das Recht, dem „Verkauf“ ihrer „personenbezogenen Daten“ zu widersprechen (laut gesetzlicher Definition dieser Begriffe). Dazu muss auf der Startseite des „Verkäufers“ ein deutlich sichtbarer Link mit dem Text „Do Not Sell My Personal Information“ (Meine personenbezogenen Daten dürfen nicht verkauft werden) vorhanden sein. Im Leitfaden zur Einhaltung der Datenschutzgesetze von US-Bundesstaaten können Sie die eingeschränkte Datenverarbeitung für die Anzeigenbereitstellung durch Google aktivieren. Google kann diese Einstellung jedoch nicht auf jedes Werbenetzwerk in der Vermittlungskette anwenden. Daher müssen Sie jedes Werbenetzwerk in Ihrer Vermittlungskette angeben, das möglicherweise am Verkauf personenbezogener Daten beteiligt ist, und die Anleitungen der einzelnen Werbenetzwerke befolgen, um die Compliance sicherzustellen.
Das Vermittlungs-Plug-in von Google Mobile Ads für Liftoff Monetize enthält die Methode GmaMediationLiftoffmonetize.setCCPAStatus()
. Der folgende Beispielcode zeigt, wie Einwilligungsinformationen an das Vungle SDK übergeben werden. Wenn Sie diese Methode aufrufen, sollte sie vor der Anzeigenanfrage über das Google Mobile Ads SDK aufgerufen werden.
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 der vom CCPA empfohlenen Implementierungsanleitung für Android und iOS.
Schritt 5: Erforderlichen Code hinzufügen
Android
Für die Integration von Liftoff Monetize ist kein zusätzlicher Code erforderlich.
iOS
SKAdNetwork-Integration
Folgen Sie der Dokumentation zu Liftoff Monetize, um die SKAdNetwork-IDs in die Datei Info.plist
Ihres Projekts einzufü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 empfangen kann, können Publisher den zugrunde liegenden Fehler aus der Anzeigenantwort mit ResponseInfo
in den folgenden Klassen prüfen:
iOS
Format | Klassenname |
---|---|
Banner | GADMAdapterVungleInterstitial |
Interstitial | GADMAdapterVungleInterstitial |
Verfügbar | GADMAdapterVunglePrämienbasierte Videoanzeige |
Im Folgenden finden Sie die Codes und Begleitmitteilungen, die vom Adapter „Liftoff Monetize“ ausgegeben werden, wenn eine Anzeige nicht geladen werden kann:
iOS
Fehlercode | Grund |
---|---|
1-100 | Das Vungle SDK hat einen Fehler zurückgegeben. Weitere Informationen finden Sie unter Code. |
101 | Die in der AdMob Benutzeroberfläche konfigurierten Parameter des Liftoff Monetize-Servers 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 der Liftoff Monetisierung unterstützten Bannergröße überein. |
104 | Die Banneranzeige konnte vom Vungle SDK nicht gerendert werden. |
105 | Das Vungle SDK unterstützt unabhängig von der Placement-ID nur jeweils eine Banneranzeige. |
106 | Das Vungle SDK hat einen Callback gesendet, dass die Anzeige nicht wiedergegeben werden kann. |
Änderungsprotokoll für den Liftoff Monetize Flutter-Vermittlungsadapter
Version 1.0.0
- Erste Version
- Verifizierte Kompatibilität mit der Version 7.3.1.0 des Liftoff Monetize Android-Adapters
- Bestätigte Kompatibilität mit der Version 7.3.2.0 des LiftoffMonetize iOS-Adapters
- Das Google Mobile Ads Flutter-Plug-in wurde mit Version 5.1.0 entwickelt und getestet.