In diesem Leitfaden erfahren Sie, wie Sie das Google Mobile Ads SDK verwenden, um Anzeigen aus DT Exchange mithilfe der Vermittlung zu laden und einzublenden. Dabei werden auch Wasserfall-Integrationen behandelt. Hier erfahren Sie, wie Sie DT Exchange zur Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und wie Sie das DT Exchange SDK und den Adapter in eine Unity App einbinden.
Unterstützte Integrationen und Anzeigenformate
Der Vermittlungsadapter AdMob für DT Exchange hat folgende Funktionen:
Integration | |
---|---|
Gebote | |
Wasserfall | |
Formate | |
Banner | |
Interstitial | |
Verfügbar |
Voraussetzungen
- Neuestes Google Mobile Ads SDK
- Unity 4 oder höher
- So stellen Sie sie unter Android bereit:
- Android API-Level 21 oder höher
- So stellen Sie sie unter iOS bereit:
- iOS-Bereitstellungsziel von 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.
- Schließen Sie die Vermittlung ab. Startleitfaden
Schritt 1: Konfigurationen in der DT Exchange-UI einrichten
Neue App und neues Anzeigen-Placement hinzufügen
Registrieren Sie sich oder melden Sie sich in der DT Exchange-Konsole an.
Klicken Sie auf die Schaltfläche App hinzufügen, um Ihre App hinzuzufügen.
Wählen Sie Ihre Plattform aus, füllen Sie den Rest des Formulars aus und klicken Sie dann auf Placements hinzufügen.
Android
iOS
Geben Sie in das Feld Placement benennen einen Namen für das neue Placement ein und wählen Sie den gewünschten Placement-Typ aus der Drop-down-Liste aus. Klicken Sie abschließend auf Placement speichern.
App-ID und Placement-ID
Öffnen Sie die linke Navigationsleiste, indem Sie den Mauszeiger darauf bewegen. Klicken Sie dann im linken Menü auf Apps.
Notieren Sie sich auf der Seite App-Verwaltung die App-ID neben Ihrer App.
Wählen Sie Ihre App aus, gehen Sie zum Tab Placements und klicken Sie auf das Kopiersymbol neben Placement-Name. Notieren Sie sich die Placement-ID.
Publisher-ID, Consumer Key und Consumer Secret
Klicken Sie im Menü auf der linken Seite auf Ihren Nutzernamen und wählen Sie Nutzerprofil aus.
Notieren Sie sich die Publisher-ID, den Consumer Key und das Consumer Secret, da diese im nächsten Schritt benötigt werden.
Schritt 2: DT Exchange-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.
Zur Liste der Werbepartner zur DSGVO und zu Verordnungen von US-Bundesstaaten hinzufügen Fyber
Folgen Sie den Schritten unter DSGVO-Einstellungen und Einstellungen zu Bestimmungen von US-Bundesstaaten um Fyber in die Liste der Werbepartner gemäß DSGVO und US-Bundesstaaten auf der AdMob Benutzeroberfläche aufzunehmen.
Schritt 3: DT Exchange SDK und Adapter importieren
Laden Sie die neueste Version des Google Mobile Ads-Vermittlungs-Plug-ins für DT Exchange über den Downloadlink im Änderungsprotokoll herunter und extrahieren Sie GoogleMobileAdsFyberMediation.unitypackage
aus der ZIP-Datei.
Wählen Sie im Unity-Projekteditor Assets > Import Package > Custom Package (Assets > Paket importieren > Benutzerdefiniertes Paket) und suchen Sie die heruntergeladene Datei GoogleMobileAdsFyberMediation.unitypackage
. Achten Sie darauf, dass alle Dateien ausgewählt sind, und klicken Sie auf Importieren.
Wählen Sie dann Assets > Play-Dienste-Resolver > Android-Resolver > Erzwingung erzwingen. Die Unity Play Services-Resolver-Bibliothek führt die Abhängigkeitsauflösung von Grund auf aus und kopiert die deklarierten Abhängigkeiten in das Verzeichnis Assets/Plugins/Android
Ihrer Unity-App.
Schritt 4: Datenschutzeinstellungen im DT Exchange SDK implementieren
Einwilligung der Nutzer in der EU und DSGVO
Gemäß der Google-Richtlinie zur Einwilligung der Nutzer in der EU müssen Sie dafür sorgen, dass Nutzer im Europäischen Wirtschaftsraum (EWR) bestimmte Informationen zur Verwendung von Gerätekennungen und personenbezogenen Daten erhalten und deren Einwilligungen eingeholt werden. Diese 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 alle Werbenetzwerke in Ihrer Vermittlungskette angeben, die personenbezogene Daten erheben, empfangen oder verwenden können, und Informationen zur Nutzung der einzelnen Werbenetzwerke zur Verfügung stellen. Google ist derzeit nicht in der Lage, die Einwilligungsentscheidung des Nutzers automatisch an solche Netzwerke zu übergeben.
In diesem Abschnitt wird beschrieben, wie Sie personalisierte Anzeigen für DT Exchange aktivieren oder deaktivieren.
Im Google Mobile Ads-Vermittlungs-Plug-in für DT Exchange Version 1.1.0 wurde die Klasse Fyber
mit den Methoden SetGDPRRequired()
und SetGDPRConsentString()
hinzugefügt, sodass Sie Einwilligungsinformationen manuell an DT Exchange übergeben können. Der folgende Beispielcode zeigt, wie diese Parameter an den DT Exchange-Adapter übergeben werden:
using GoogleMobileAds.Api.Mediation.Fyber;
// ...
Fyber.SetGDPRConsent(true);
Fyber.SetGDPRConsentString("myGDPRConsentString");
Weitere Informationen und die Werte, die in der Methode angegeben werden können, finden Sie im DSGVO-Artikel von DT Exchange.
Datenschutzgesetze von US-Bundesstaaten
Datenschutzgesetze von US-Bundesstaaten müssen Nutzern das Recht einräumen, dem „Verkauf“ ihrer „personenbezogenen Daten“ zu widersprechen (laut gesetzlicher Definition dieser Bedingungen). Dazu muss auf der Startseite des „Verkäufers“ ein gut sichtbarer Link mit dem Text „Meine personenbezogenen Daten sollen nicht verkauft werden“ eingeblendet werden. Der Leitfaden zur Einhaltung der Datenschutzgesetze von US-Bundesstaaten bietet die Möglichkeit, die eingeschränkte Datenverarbeitung für die Anzeigenbereitstellung durch Google zu aktivieren. Google kann diese Einstellung jedoch nicht auf die einzelnen Werbenetzwerke in Ihrer Vermittlungskette anwenden. Daher müssen Sie jedes Werbenetzwerk in Ihrer Vermittlungskette identifizieren, das am Verkauf personenbezogener Daten beteiligt sein könnte, und die Richtlinien der einzelnen Werbenetzwerke befolgen, um die Compliance sicherzustellen.
In Version 3.1.1 des Google Mobile Ads-Vermittlungs-Plug-ins für DT Exchange wurde die Klasse Fyber
mit der Methode SetCCPAString()
hinzugefügt, mit der Sie Einwilligungsinformationen manuell an DT Exchange übergeben können. Der folgende Beispielcode zeigt, wie diese Parameter an den DT Exchange-Adapter übergeben werden:
using GoogleMobileAds.Api.Mediation.Fyber;
// ...
Fyber.SetCCPAString("myCCPAConsentString");
// You can also clear CCPA consent information using the following method:
Fyber.ClearCCPAString();
Weitere Informationen und die Werte, die in der Methode zur Verfügung gestellt werden können, finden Sie im CCPA Open Source-Artikel von DT Exchange.
Schritt 5: Erforderlichen Code hinzufügen
Android
Für die DT Exchange-Integration ist kein zusätzlicher Code erforderlich.
iOS
SKAdNetwork-Integration
Folgen Sie der Dokumentation zu DT Exchange, um die SKAdNetwork-IDs zur Datei Info.plist
Ihres Projekts hinzuzufügen.
Schritt 6: Implementierung testen
Testanzeigen aktivieren
Registrieren Sie Ihr Testgerät für AdMob.
Testanzeigen überprüfen
Wenn Sie prüfen möchten, ob Sie Testanzeigen vonDT Exchangeerhalten, aktivieren Sie im Anzeigenprüftool mithilfe der DT Exchange (Waterfall) Anzeigenquellen den Test für eine einzelne Anzeigenquelle.
Fehlercodes
Wenn der Adapter keine Anzeige von DT Exchange empfängt, können Publisher mit ResponseInfo
in der folgenden Klasse den zugrunde liegenden Fehler aus der Anzeigenantwort prüfen:
Android
com.google.ads.mediation.fyber.FyberMediationAdapter
iOS
GADMediationAdapterFyber
Hier sind die Codes und zugehörigen Nachrichten, die vom DT Exchange-Adapter ausgegeben werden, wenn eine Anzeige nicht geladen werden kann:
Android
Fehlercode | Grund |
---|---|
101 | Die in der AdMob UI konfigurierten DT Exchange-Serverparameter fehlen oder sind ungültig. |
103 | Die angeforderte Anzeigengröße stimmt nicht mit einer von DT Exchange unterstützten Bannergröße überein. |
105 | Das DT Exchange SDK hat eine Anzeige geladen, aber einen unerwarteten Controller zurückgegeben. |
106 | Die Anzeige ist nicht bereit zur Auslieferung. |
200-399 | Das DT Exchange SDK hat einen Fehler zurückgegeben. Weitere Informationen finden Sie unter Code. |
iOS
Fehlercode | Grund |
---|---|
0-10 | Das DT Exchange SDK hat einen Fehler zurückgegeben. Weitere Informationen finden Sie in der Dokumentation. |
101 | Die in der AdMob UI konfigurierten DT Exchange-Serverparameter fehlen oder sind ungültig. |
102 | Die angeforderte Anzeigengröße stimmt nicht mit einer von DT Exchange unterstützten Bannergröße überein. |
103 | Die Anzeige konnte nicht angezeigt werden, da das Anzeigenobjekt bereits verwendet wurde. |
104 | DT Exchange-Anzeigen konnten nicht ausgeliefert werden, weil die Anzeige nicht bereit ist. |
105 | Das DT Exchange SDK hat einen Initialisierungsfehler zurückgegeben. |
Änderungsprotokoll zum DT Exchange Unity Mediation-Plug-in
Version 3.2.0
- Unterstützt DT Exchange Android Adapter Version 8.2.7.0.
- Unterstützt DT Exchange iOS Adapter Version 8.3.0.0.
- Mit dem Google Mobile Ads Unity Plugin Version 9.1.0 erstellt und getestet.
Version 3.1.12
- Unterstützt DT Exchange Android Adapter Version 8.2.7.0.
- Unterstützt DT Exchange iOS Adapter Version 8.2.8.0.
- Mit dem Google Mobile Ads Unity Plugin Version 9.1.0 erstellt und getestet.
Version 3.1.11
- Unterstützt DT Exchange Android Adapter Version 8.2.7.0.
- Unterstützt DT Exchange iOS Adapter Version 8.2.7.0.
- Mit dem Google Mobile Ads Unity Plugin Version 9.1.0 erstellt und getestet.
Version 3.1.10
- Unterstützt DT Exchange Android Adapter Version 8.2.6.1.
- Unterstützt DT Exchange iOS Adapter Version 8.2.7.0.
- Mit dem Google Mobile Ads Unity Plugin Version 9.0.0 erstellt und getestet.
Version 3.1.8
- Unterstützt DT Exchange Android Adapter Version 8.2.5.0.
- Unterstützt DT Exchange iOS Adapter Version 8.2.6.0.
- Mit dem Google Mobile Ads Unity Plugin Version 8.6.0 erstellt und getestet.
Version 3.1.7
- Unterstützt DT Exchange Android Adapter Version 8.2.4.0.
- Unterstützt DT Exchange iOS Adapter Version 8.2.4.0.
- Erstellt und getestet mit dem Google Mobile Ads Unity Plugin Version 8.5.2.
Version 3.1.6
- Unterstützt DT Exchange Android Adapter Version 8.2.3.0.
- Unterstützt DT Exchange iOS Adapter Version 8.2.3.0.
- Erstellt und getestet mit dem Google Mobile Ads Unity Plugin Version 8.4.1.
Version 3.1.5
- Adapterinhalt wurde nach
GoogleMobileAds/Mediation/DTExchange/
verschoben. - Adapter-Namespace zur Verwendung von
GoogleMobileAds.Mediation.DTExchange
überarbeitet. - Unterstützt DT Exchange Android Adapter Version 8.2.3.0.
- Unterstützt DT Exchange iOS Adapter Version 8.2.1.0.
- Mit dem Google Mobile Ads Unity Plugin Version 8.1.0 erstellt und getestet.
Version 3.1.4
- Unterstützt DT Exchange Android Adapter Version 8.2.2.0.
- Unterstützt DT Exchange iOS Adapter Version 8.1.9.1.
- Erstellt und getestet mit dem Google Mobile Ads Unity Plugin Version 7.4.1.
Version 3.1.3
- Unterstützt DT Exchange Android Adapter Version 8.2.1.0.
- Unterstützt DT Exchange iOS Adapter Version 8.1.9.0.
- Mit dem Google Mobile Ads Unity Plugin Version 7.4.0 erstellt und getestet.
Version 3.1.2
- Der Name des Unity-Vermittlungs-Plug-ins wurde in „DT Exchange“ umbenannt.
- Die Klasse
GoogleMobileAds.Api.Mediation.Fyber.Fyber
wurde inGoogleMobileAds.Api.Mediation.DTExchange.DTExchange
umbenannt. - Unterstützt DT Exchange Android Adapter Version 8.2.1.0.
- Unterstützt DT Exchange iOS Adapter Version 8.1.7.0.
- Erstellt und getestet mit dem Google Mobile Ads Unity Plugin Version 7.3.1.
Version 3.1.1
- Der Klasse
Fyber
wurden die folgenden Methoden hinzugefügt:SetCCPAString(string)
ClearCCPAString()
- Unterstützt die Fyber-Android-Adapterversion 8.2.0.0.
- Unterstützt die Fyber-iOS-Adapterversion 8.1.6.0.
- Mit dem Google Mobile Ads Unity Plugin Version 7.3.0 erstellt und getestet.
Version 3.1.0
- Unterstützt die Fyber-Android-Adapterversion 8.2.0.0.
- Unterstützt die Fyber-iOS-Adapterversion 8.1.5.0.
- Mit dem Google Mobile Ads Unity Plugin Version 7.2.0 erstellt und getestet.
Version 3.0.2
- Unterstützt die Fyber-Android-Adapterversion 8.1.3.1.
- Unterstützt die Fyber-iOS-Adapterversion 8.1.5.0.
- Erstellt und getestet mit dem Google Mobile Ads Unity Plugin Version 7.0.2.
Version 3.0.1
- Unterstützt die Fyber-Android-Adapterversion 8.1.3.0.
- Unterstützt Version 8.1.4.0 des Fyber-iOS-Adapters.
- Mit dem Google Mobile Ads Unity Plugin Version 7.0.0 erstellt und getestet.
Version 3.0.0
- Unterstützt die Fyber-Android-Adapterversion 8.1.2.0.
- Unterstützt Version 8.1.2.0 des Fyber-iOS-Adapters.
Version 2.0.0
- Unterstützt die Fyber-Android-Adapterversion 7.8.4.1.
- Unterstützt Version 8.0.0.0 des Fyber-iOS-Adapters.
Version 1.6.1
- Unterstützt die Fyber-Android-Adapterversion 7.8.3.0.
- Unterstützt die Fyber-iOS-Adapterversion 7.8.6.0.
Version 1.6.0
- Unterstützt die Fyber-Android-Adapterversion 7.8.2.0.
- Unterstützt die Fyber-iOS-Adapterversion 7.8.5.0.
Version 1.5.2
- Unterstützt die Fyber-Android-Adapterversion 7.7.4.0.
- Unterstützt die Fyber-iOS-Adapterversion 7.7.3.0.
Version 1.5.1
- Unterstützt die Fyber-Android-Adapterversion 7.7.2.0.
- Unterstützt die Fyber-iOS-Adapterversion 7.7.2.0.
Version 1.5.0
- Unterstützt die Fyber-Android-Adapterversion 7.7.1.0.
- Unterstützt die Fyber-iOS-Adapterversion 7.7.1.0.
Version 1.4.0
- Unterstützt die Fyber-Android-Adapterversion 7.7.0.0.
- Unterstützt die Fyber-iOS-Adapterversion 7.6.4.0.
Version 1.3.0
- Unterstützt die Fyber-Android-Adapterversion 7.6.0.0.
- Unterstützt die Fyber-iOS-Adapterversion 7.6.0.0.
Version 1.2.3
- Unterstützt die Fyber-Android-Adapterversion 7.5.4.0.
- Unterstützt die Fyber-iOS-Adapterversion 7.5.6.0.
Version 1.2.2
- Unterstützt die Fyber-Android-Adapterversion 7.5.3.0.
- Unterstützt die Fyber-iOS-Adapterversion 7.5.4.0.
Version 1.2.1
- Unterstützt die Fyber-Android-Adapterversion 7.5.2.0.
- Unterstützt die Fyber-iOS-Adapterversion 7.5.3.0.
Version 1.2.0
- Unterstützt die Fyber-Android-Adapterversion 7.5.0.0.
- Unterstützt die Fyber-iOS-Adapterversion 7.5.1.0.
Version 1.1.0
- Der Klasse
Fyber
wurden die folgenden Methoden hinzugefügt, um DSGVO-Anforderungen zu unterstützen:SetGDPRConsent()
SetGDPRConsentString()
ClearGDPRConsentData()
- Unterstützt die Fyber-Android-Adapterversion 7.3.4.0.
- Unterstützt die Fyber-iOS-Adapterversion 7.5.0.0.
Version 1.0.0
- Erste Veröffentlichung!
- Unterstützt die Fyber-Android-Adapterversion 7.3.4.0.
- Unterstützt die Fyber-iOS-Adapterversion 7.4.0.0.