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 eineUnity App einbinden.

Unterstützte Integrationen und Anzeigenformate

Integration
Gebote 1.
Wasserfall
Formate
App öffnen
Banner
Interstitial
Verfügbar
Interstitial mit Prämie 2

1 Integration von Bidding befindet sich in der offenen Betaphase.

2 Mit Prämie Bei der Einrichtung von Interstitials ist Unterstützung erforderlich. Ihr Konto kontaktieren Manager bei Liftoff Monetize oder monetize@liftoff.io.

Voraussetzungen

  • Neuestes Google Mobile Ads SDK
  • Unity 4 oder höher
  • (Für Gebote): Google Mobile Ads Mediation-Plug-in für Liftoff Monetize 3.8.2 oder höher (aktuelle Version empfohlen)
  • 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 Unity 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, Ad Managerrufen 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:

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.

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 dieAd Manager 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“ Ad Manager 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 Ad Manager Benutzeroberfläche aufzunehmen.

Schritt 3: Vungle SDK und Liftoff Monetize Adapter importieren

Neueste Version des Google Mobile Ads-Vermittlungs-Plug-ins für Liftoff herunterladen Monetarisieren Sie Ihre Inhalte über den Download-Link in der Änderungsprotokoll und extrahieren Sie den GoogleMobileAdsVungleMediation.unitypackage aus der ZIP-Datei.

Wählen Sie im Unity-Projekteditor Assets > Paket importieren > Benutzerdefiniertes Paket und suchen Sie die Datei GoogleMobileAdsVungleMediation.unitypackage. die Sie heruntergeladen haben. Achten Sie darauf, dass alle Dateien ausgewählt sind, und klicken Sie auf Importieren.

Wählen Sie dann Assets > Play-Dienste-Resolver > Android-Resolver > „Auflösung erzwingen“. Die Unity Play Services Resolver-Bibliothek führt Abhängigkeiten von Grund auf neu auflösen und die deklarierten Abhängigkeiten in den Assets/Plugins/Android-Verzeichnis Ihrer Unity-App.

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 enthält Methoden zum Übergeben von Einwilligungsinformationen an das Vungle SDK. Im folgenden Codebeispiel wird gezeigt, wie Sie Einwilligungsinformationen an das Vungle SDK übergeben. Wenn Sie diese Option wählen, sollten Sie dies nachholen, bevor Sie Anzeigen über das Google Mobile Ads SDK.

using GoogleMobileAds.Mediation.LiftoffMonetize.Api;
// ...

LiftoffMonetize.SetGDPRStatus(true, "v1.0.0");
#if UNITY_IPHONE
LiftoffMonetize.SetGDPRMessageVersion("v1.0.0");
#endif

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 Mediation-Plug-in für Liftoff Monetize umfasst Methoden zur Einwilligungsinformationen an das Vungle SDK übergeben. Der folgende Beispielcode zeigt, Einwilligungsinformationen an das Vungle SDK übergeben. Wenn Sie diese Methode aufrufen, sollten Sie dies vor dem Anfordern von Anzeigen über das Google Mobile Ads SDK tun.

using GoogleMobileAds.Mediation.LiftoffMonetize.Api;
// ...

LiftoffMonetize.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 Ad Manager 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).

Liftoff Monetize Unity Mediation-Plug-in – Änderungsprotokoll

Version 5.2.1

Version 5.2.0

Version 5.1.1

Version 5.1.0

  • Es wurde ein NullPointerException behoben, der beim Export als Android-Projekt zu einem Build-Fehler führte.
  • Die Privacy APIs wurden aktualisiert:
    • Die Methoden UpdateConsentStatus() und UpdateCCPAStatus() wurden entfernt.
    • Die VungleConsentStatus- und VungleCCPAStatus-Enumerationen wurden entfernt.
    • Die Methode SetGDPRStatus(bool) wurde auf SetGDPRStatus(bool, String) aktualisiert.
  • Die folgenden Methoden wurden aus der Klasse LiftoffMonetizeMediationExtras entfernt:
    • SetAllPlacements(String[])
    • SetSoundEnabled(bool)
  • Unterstützt die Android-Adapterversion 7.3.1.0 von Liftoff Monetize.
  • Unterstützt die Version 7.3.1.0 des Liftoff Monetize iOS-Adapters.
  • Erstellt und getestet mit der Version 9.1.0 des Google Mobile Ads Unity-Plug-ins.

Version 5.0.0

Version 4.0.0

  • Das Unity-Vermittlungs-Plug-in wurde von Vungle in Liftoff Monetize umbenannt.
  • Adapterinhalt wurde nach GoogleMobileAds/Mediation/LiftoffMonetize/ verschoben.
  • Adapter-Namespace zur Verwendung von GoogleMobileAds.Mediation.LiftoffMonetize überarbeitet.
  • Der Klasse LiftoffMonetize wurden die folgenden Methoden hinzugefügt:
    • SetGDPRStatus(bool)
    • SetGDPRMessageVersion(String)
    • SetCCPAStatus(bool)
  • Unterstützt die Android-Adapterversion 6.12.1.1 von Liftoff Monetize.
  • Unterstützt die iOS-Adapterversion 7.0.1.0 von Liftoff Monetize.
  • Erstellt und getestet mit dem Google Mobile Ads Unity Plugin Version 8.4.1.

Version 3.9.2

  • Die Klasse Vungle wurde aktualisiert:
    • Die Methode UpdateCCPAStatus(VungleCCPAStatus) wurde hinzugefügt.
    • Die Methode GetCurrentConsentStatus() wurde entfernt.
    • Die Methode GetCurrentConsentMessageVersion() wurde entfernt.
  • Unterstützt die Vungle-Android-Adapterversion 6.12.1.0.
  • Unterstützt Vungle iOS Adapter Version 6.12.2.0.
  • Erstellt und getestet mit dem Google Mobile Ads Unity-Plug-in der Version 7.4.1.

Version 3.9.1

Version 3.9.0

Version 3.8.2

Version 3.8.1

Version 3.8.0

Version 3.7.5

Version 3.7.4

Version 3.7.3

Version 3.7.2

Version 3.7.1

Version 3.7.0

Version 3.6.0

Version 3.5.1

Version 3.5.0

Version 3.4.1

Version 3.4.0

Version 3.3.1

Version 3.3.0

Version 3.2.0

Version 3.1.4

  • Unterstützt die Android-Adapterversion 6.3.24.1.
  • Unterstützt iOS-Adapterversion 6.3.2.3.

Version 3.1.3

  • Unterstützt die Android-Adapterversion 6.3.24.1.
  • Unterstützt iOS-Adapterversion 6.3.2.2.

Version 3.1.2

  • Das Plug-in wurde aktualisiert, um die neue Rewarded API in der offenen Betaphase zu unterstützen.
  • Unterstützt die Android-Adapterversion 6.3.24.1.
  • Unterstützt die iOS-Adapterversion 6.3.2.1.

Version 3.1.1

  • Unterstützt die Android-Adapterversion 6.3.24.0.
  • Unterstützt iOS-Adapterversion 6.3.2.0.
  • Die Methode Vungle.UpdateConsentStatus() wurde aktualisiert, um den Parameter consentMessageVersion optional zu machen. Der Wert von consentMessageVersion wird bei iOS jetzt ignoriert.
  • Vungle.GetCurrentConsentMessageVersion() für iOS wurde eingestellt.

Version 3.1.0

  • Unterstützt die Android-Adapterversion 6.3.17.0.
  • Unterstützt die iOS-Adapterversion 6.3.0.0.
  • Die Methode Vungle.UpdateConsentStatus() wurde aktualisiert, um einen zusätzlichen Parameter String für die vom Publisher bereitgestellte Version der Einwilligungsnachricht zu berücksichtigen.
  • Die Methode Vungle.GetCurrentConsentMessageVersion() wurde hinzugefügt, um die Version der vom Publisher bereitgestellten Mitteilung zur Einwilligung der Nutzer in der EU abzurufen.

Version 3.0.1

  • Unterstützt die Android-Adapterversion 6.2.5.1.
  • Unterstützt die iOS-Adapterversion 6.2.0.3.

Version 3.0.0

  • Unterstützt die Android-Adapterversion 6.2.5.0.
  • Unterstützt iOS-Adapterversion 6.2.0.2.
  • Die folgenden Methoden wurden hinzugefügt:
    • Vungle.UpdateConsentStatus()-Methode, um den Einwilligungsstatus festzulegen, der im Vungle SDK erfasst wird.
    • Vungle.GetCurrentConsentStatus()-Methode, um den aktuellen Einwilligungsstatus des Nutzers abzurufen.

Version 2.0.0

  • Unterstützt die Android-Adapterversion 5.3.2.1.
  • Unterstützt die iOS-Adapterversion 6.2.0.0.

Version 1.1.0

  • Unterstützt die Android-Adapterversion 5.3.2.1.
  • Unterstützt iOS-Adapterversion 5.4.0.0.

Version 1.0.0

  • Erste Veröffentlichung!
  • Unterstützt die Android-Adapterversion 5.3.0.0.
  • Unterstützt die iOS-Adapterversion 5.3.0.0.