Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
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 eine Unity-App einbinden.
1 Die Gebotsintegration befindet sich in der offenen Betaphase.
2 Interstitials mit Prämie erfordern Unterstützung bei der Einrichtung. Dann wenden Sie sich an Ihren Account Manager bei Liftoff Monetize oder monetize@liftoff.io.
Voraussetzungen
Das aktuelle Google Mobile Ads SDK
Unity 4 oder höher
(Für Gebote): Vermittlungs-Plug-in für Google Mobile Ads für Liftoff Monetize 3.8.2 oder höher (aktuelle Version empfohlen)
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 Unity Projekt, das mit dem Google Mobile Ads SDK konfiguriert wurde Weitere Informationen finden Sie unter Erste Schritte.
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:
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.
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 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 Monetize-Nachfrage in der Ad Manager 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
Schritt 3: Vungle SDK und den Liftoff Monetize-Adapter importieren
Laden Sie über den Downloadlink im Änderungsprotokoll die aktuelle Version des Vermittlungs-Plug-ins für Google Mobile Ads für Liftoff Monetize herunter und extrahieren Sie die GoogleMobileAdsVungleMediation.unitypackage aus der ZIP-Datei.
Wählen Sie im Unity-Projekteditor Assets > Import Package > Custom Package (Assets > Paket importieren > Benutzerdefiniertes Paket) aus und suchen Sie nach der heruntergeladenen Datei GoogleMobileAdsVungleMediation.unitypackage. Prüfen Sie, ob alle Dateien ausgewählt sind, und klicken Sie auf Importieren.
Wählen Sie dann Assets > Play Services Resolver > Android Resolver > Force Resolver aus. Die Unity Play Services Resolver-Bibliothek führt die Abhängigkeitsauflösung von Grund auf durch und kopiert die deklarierten Abhängigkeiten in das Verzeichnis Assets/Plugins/Android Ihrer Unity-Anwendung.
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 für Google Mobile Ads für Liftoff Monetize Version 4.0.0 enthält Methoden zur Weitergabe von Einwilligungsinformationen an das Vungle SDK.
Android
Beim Aktualisieren des Einwilligungsstatus können Sie zwei Werte angeben:
VungleConsentStatus.OPTED_IN
VungleConsentStatus.OPTED_OUT
Mit dem folgenden Beispielcode wird der Einwilligungsstatus in VungleConsentStatus.OPTED_IN aktualisiert. Wir empfehlen, diese Methode vor der Anzeigenanfrage mit dem Google Mobile Ads SDK aufzurufen.
using GoogleMobileAds.Mediation.LiftoffMonetize.Api;
// ...
LiftoffMonetize.UpdateConsentStatus(VungleConsentStatus.OPTED_IN, "1.0.0");
Mit dem folgenden Beispielcode werden Einwilligungsinformationen an das Vungle iOS SDK weitergeleitet. Wir empfehlen, diese Methode vor dem Anfordern von Anzeigen mit dem Google Mobile Ads SDK aufzurufen.
using GoogleMobileAds.Mediation.LiftoffMonetize.Api;
// ...
LiftoffMonetize.SetGDPRStatus(true);
LiftoffMonetize.SetGDPRMessageVersion("1.0.0");
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 für Google Mobile Ads für Liftoff Monetize Version 4.0.0 enthält Methoden zur Weitergabe von Einwilligungsinformationen an das Vungle SDK.
Android
Beim Aktualisieren des Einwilligungsstatus können Sie zwei Werte angeben:
VungleCCPAStatus.OPTED_IN
VungleCCPAStatus.OPTED_OUT
Mit dem folgenden Beispielcode wird der Einwilligungsstatus in VungleCCPAStatus.OPTED_IN aktualisiert. Wir empfehlen, diese Methode vor der Anzeigenanfrage mit dem Google Mobile Ads SDK aufzurufen.
using GoogleMobileAds.Mediation.LiftoffMonetize.Api;
// ...
LiftoffMonetize.UpdateCCPAStatus(VungleCCPAStatus.OPTED_IN);
Mit dem folgenden Beispielcode werden Einwilligungsinformationen an das Vungle iOS SDK weitergeleitet. Wir empfehlen, diese Methode vor dem Anfordern von Anzeigen mit dem Google Mobile Ads SDK aufzurufen.
using GoogleMobileAds.Mediation.LiftoffMonetize.Api;
// ...
LiftoffMonetize.SetCCPAStatus(true);
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 Ad Manager 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 des Liftoff Monetize Unity Mediation-Plug-ins
Das Plug-in wurde aktualisiert, um die neue offene Beta Reward API zu unterstützen.
Unterstützt die Android-Adapterversion 6.3.24.1.
Unterstützt 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, sodass der Parameter consentMessageVersion optional ist. Der Wert von consentMessageVersion wird jetzt für iOS 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, sodass für die vom Publisher bereitgestellte Mitteilung zur EU-Nutzereinwilligung ein zusätzlicher String-Parameter verwendet wird.
Methode Vungle.GetCurrentConsentMessageVersion() zum Abrufen der Version der vom Publisher bereitgestellten Mitteilung zur EU-Nutzereinwilligung wurde hinzugefügt.
Version 3.0.1
Unterstützt die Android-Adapterversion 6.2.5.1.
Unterstützt 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.
Folgende Methoden wurden hinzugefügt:
Vungle.UpdateConsentStatus() zum Festlegen des Einwilligungsstatus, der im Vungle SDK aufgezeichnet wird.
Vungle.GetCurrentConsentStatus(), um den aktuellen Einwilligungsstatus des Nutzers abzurufen.
