Liftoff Monetize in die Vermittlung einbinden

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

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.

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 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

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

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.