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 | |
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
- 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
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
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
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 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 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).
Liftoff Monetize Unity Mediation-Plug-in – Änderungsprotokoll
Version 5.2.1
DummyClient
wurde inPlaceholderClient
umbenannt.- Unterstützt die Android-Adapterversion 7.4.0.1 von Liftoff Monetize.
- Unterstützt die Version 7.4.0.1 des Liftoff Monetize iOS-Adapters.
- Mit dem Google Mobile Ads Unity Plugin Version 9.2.0 erstellt und getestet.
Version 5.2.0
- Unterstützt die Android-Adapterversion 7.4.0.0 von Liftoff Monetize.
- Unterstützt die Version 7.4.0.0 des Liftoff Monetize iOS-Adapters.
- Erstellt und getestet mit dem Google Mobile Ads Unity Plugin Version 9.1.1.
Version 5.1.1
- Unterstützt Liftoff Monetize Android-Adapterversion 7.3.2.0.
- Unterstützt die Version 7.3.2.0 des Liftoff Monetize iOS-Adapters.
- Mit dem Google Mobile Ads Unity Plugin Version 9.1.0 erstellt und getestet.
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()
undUpdateCCPAStatus()
wurden entfernt. - Die
VungleConsentStatus
- undVungleCCPAStatus
-Enumerationen wurden entfernt. - Die Methode
SetGDPRStatus(bool)
wurde aufSetGDPRStatus(bool, String)
aktualisiert.
- Die Methoden
- 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
- Eine Warnung wegen doppelter Definitionen für
MediationExtras
wurde korrigiert. - Unterstützt Liftoff Monetize Android-Adapterversion 7.1.0.0.
- Unterstützt die Version 7.2.1.1 des Liftoff Monetize iOS-Adapters.
- Mit dem Google Mobile Ads Unity Plugin Version 8.7.0 erstellt und getestet.
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.
- Die Methode
- 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
- Unterstützt die Vungle-Android-Adapterversion 6.12.1.0.
- Unterstützt die Vungle iOS-Adapterversion 6.12.1.1.
- Erstellt und getestet mit der Version 7.4.0 des Google Mobile Ads Unity-Plug-ins.
Version 3.9.0
- Unterstützt die Vungle-Android-Adapterversion 6.12.0.0.
- Unterstützt die Vungle iOS-Adapterversion 6.12.0.0.
- Mit dem Google Mobile Ads Unity Plugin Version 7.2.0 erstellt und getestet.
Version 3.8.2
- Unterstützt die Vungle Android-Adapterversion 6.11.0.2.
- Unterstützt die Vungle iOS-Adapterversion 6.11.0.1.
- Erstellt und getestet mit der Version 7.1.0 des Google Mobile Ads Unity-Plug-ins.
Version 3.8.1
- Unterstützt die Vungle-Android-Adapterversion 6.11.0.1.
- Unterstützt die Vungle iOS-Adapterversion 6.11.0.0.
- Erstellt und getestet mit dem Google Mobile Ads Unity Plugin Version 7.0.2.
Version 3.8.0
- Unterstützt die Vungle-Android-Adapterversion 6.11.0.0.
- Unterstützt die Vungle iOS-Adapterversion 6.11.0.0.
- Mit dem Google Mobile Ads Unity Plugin Version 7.0.0 erstellt und getestet.
Version 3.7.5
- Unterstützt die Vungle-Android-Adapterversion 6.10.5.0.
- Unterstützt die Vungle iOS-Adapterversion 6.10.6.1.
- Mit dem Google Mobile Ads Unity Plugin Version 7.0.0 erstellt und getestet.
Version 3.7.4
- Unterstützt die Vungle-Android-Adapterversion 6.10.4.0.
- Unterstützt die Vungle iOS-Adapterversion 6.10.6.1.
- Erstellt und getestet mit der Version 7.0.0 des Google Mobile Ads Unity-Plug-ins.
Version 3.7.3
- Unterstützt die Vungle Android-Adapterversion 6.10.3.0.
- Unterstützt die Vungle iOS-Adapterversion 6.10.5.1.
Version 3.7.2
- Unterstützt die Vungle-Android-Adapterversion 6.10.2.1.
- Unterstützt die Vungle iOS-Adapterversion 6.10.5.1.
Version 3.7.1
- Unterstützt die Vungle-Android-Adapterversion 6.10.2.0.
- Unterstützt die Vungle iOS-Adapterversion 6.10.4.0.
Version 3.7.0
- Unterstützt die Vungle-Android-Adapterversion 6.10.2.0.
- Unterstützt die Vungle iOS-Adapterversion 6.10.3.0.
Version 3.6.0
- Unterstützt die Vungle-Android-Adapterversion 6.9.1.1.
- Unterstützt Vungle iOS Adapter Version 6.9.2.0.
Version 3.5.1
- Unterstützt die Vungle-Android-Adapterversion 6.8.1.0.
- Unterstützt die Vungle-iOS-Adapterversion 6.8.1.0.
Version 3.5.0
- Unterstützt die Vungle-Android-Adapterversion 6.8.0.0.
- Unterstützt die Vungle iOS-Adapterversion 6.8.0.0.
Version 3.4.1
- Unterstützt die Vungle-Android-Adapterversion 6.7.1.0.
- Unterstützt die Vungle iOS-Adapterversion 6.7.1.0.
Version 3.4.0
- Unterstützt die Vungle-Android-Adapterversion 6.7.0.0.
- Unterstützt die Vungle-iOS-Adapterversion 6.7.0.0.
Version 3.3.1
vungle-extras-library.jar
wurde mit einem.aar
-Build zur Unterstützung von Unity 2020 invungle-unity-android-library.aar
umgepackt.- Entfernen Sie
vungle-extras-library.jar
aus Ihrem Projekt, wenn Sie auf diese Version umstellen.
- Entfernen Sie
- Unterstützt die Vungle-Android-Adapterversion 6.5.3.0.
- Unterstützt die Vungle-iOS-Adapterversion 6.5.3.0.
Version 3.3.0
- Unterstützt die Vungle-Android-Adapterversion 6.5.3.0.
- Unterstützt die Vungle-iOS-Adapterversion 6.5.3.0.
Version 3.2.0
- Unterstützt die Vungle-Android-Adapterversion 6.4.11.1.
- Unterstützt die Vungle iOS-Adapterversion 6.4.6.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 ParameterconsentMessageVersion
optional zu machen. Der Wert vonconsentMessageVersion
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 ParameterString
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.