In diesem Leitfaden erfahren Sie, wie Sie mit dem Google Mobile Ads SDK Anzeigen von DT Exchange mit Vermittlung zur Einbindung von Vermittlungsabfolgen. Sie erfahren, wie Sie DT Exchange einer Anzeige hinzufügen. Vermittlungskonfiguration des Anzeigenblocks und die Integration des DT Exchange SDK und Adapter in eine Android App.
Unterstützte Integrationen und Anzeigenformate
Der Vermittlungsadapter für DT Exchange bietet folgende Funktionen:
Integration | |
---|---|
Gebote | |
Wasserfall | |
Formate | |
Banner | |
Interstitial | |
Verfügbar | |
Nativ |
Voraussetzungen
- Android API-Level 21 oder höher
Neuestes Google Mobile Ads SDK
Vermittlung abschließen Startleitfaden
Schritt 1: Konfigurationen in der DT Exchange-UI einrichten
Schritt 2: DT Exchange-Nachfrage in der Ad Manager Benutzeroberfläche einrichten
Zur Liste der Werbepartner zur DSGVO und zu Verordnungen von US-Bundesstaaten hinzufügen Fyber
Schritt 3: DT Exchange SDK und Adapter importieren
Android Studio-Integration (empfohlen)
Füge der Datei build.gradle.kts
auf App-Ebene die folgende Implementierung hinzu:
Abhängigkeiten und Konfigurationen. Neueste Versionen des DT Exchange SDK verwenden
und Adapter:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.3.0")
implementation("com.google.ads.mediation:fyber:8.3.1.0")
}
Manuelle Integration
- Laden Sie die aktuelle Version der
DT Exchange SDK for Android und fügen Sie
folgende Dateien in Ihr Projekt:
<ph type="x-smartling-placeholder">
- </ph>
ia-mraid-kit-release-x.y.z.aar
ia-sdk-core-release-x.y.z.aar
ia-video-kit-release-x.y.z.aar
- Gehen Sie zur
Artefakte des DT Exchange-Adapters
im Maven-Repository von Google. Neueste Version auswählen und DT herunterladen
die Datei
.aar
des Exchange-Adapters und fügen Sie sie Ihrem Projekt hinzu.
Schritt 4: Datenschutzeinstellungen im DT Exchange 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.
DT Exchange enthält eine API, mit der Sie die Nutzereinwilligung an das SDK weiterleiten können. Die Der folgende Beispielcode zeigt, wie Einwilligungsinformationen an DT Exchange übergeben werden. SDK manuell. Sollten Sie Einwilligungsinformationen an DT Exchange senden, SDK manuell verwenden, wird empfohlen, diesen Code vor der Anforderung von Anzeigen aufzurufen. über das Google Mobile Ads SDK.
Java
import com.fyber.inneractive.sdk.external.InneractiveAdManager;
// ...
InneractiveAdManager.setGdprConsent(true);
InneractiveAdManager.setGdprConsentString("myGdprConsentString");
Kotlin
import com.fyber.inneractive.sdk.external.InneractiveAdManager
// ...
InneractiveAdManager.setGdprConsent(true)
InneractiveAdManager.setGdprConsentString("myGdprConsentString")
Besuchen Sie die Ressourcenseite zur DSGVO von DT Exchange und die Leitfaden zur Umsetzung der DSGVO finden Sie weitere Details und die Werte, die in der Methode angegeben werden können.
Datenschutzgesetze von US-Bundesstaaten
USA Datenschutzgesetze von Bundesstaaten müssen Sie Nutzern das Angebot des Angebots ihrer "personenbezogenen Daten" (wie das Gesetz definiert dieser Nutzungsbedingungen), wobei die Widerspruchsmöglichkeit über einen gut sichtbaren "Do Not Sell My Personal"-Artikel Informationen“ auf den Link „Verkauf“ die Startseite der Party. Die USA Datenschutz für Bundesstaaten 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, Vermittlungskette, die am Verkauf von persönlichen und folgen den Leitlinien der einzelnen Netzwerke, um sicherzustellen, Compliance.
DT Exchange enthält eine API, mit der Sie die Nutzereinwilligung an das SDK weiterleiten können. Die Der folgende Beispielcode zeigt, wie Einwilligungsinformationen an DT Exchange übergeben werden. SDK manuell. Sollten Sie Einwilligungsinformationen an DT Exchange senden, SDK manuell verwenden, wird empfohlen, diesen Code vor der Anforderung von Anzeigen aufzurufen. über das Google Mobile Ads SDK.
Java
import com.fyber.inneractive.sdk.external.InneractiveAdManager;
// ...
InneractiveAdManager.setUSPrivacyString("myUSPrivacyString");
Kotlin
import com.fyber.inneractive.sdk.external.InneractiveAdManager
// ...
InneractiveAdManager.setUSPrivacyString("myUSPrivacyString")
Besuchen Sie die CCPA-Ressourcenseite von DT Exchange. Leitfaden zur Implementierung des CCPA finden Sie weitere Details und die Werte, die in der Methode angegeben werden können.
Schritt 5: Erforderlichen Code hinzufügen
Für die DT Exchange-Integration ist kein zusätzlicher Code erforderlich.
Schritt 6: Implementierung testen
Testanzeigen aktivieren
Registrieren Sie Ihr Testgerät für Ad Manager.
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.
Optionale Schritte
Netzwerkspezifische Parameter
Der DT Exchange-Adapter unterstützt zusätzliche Anfrageparameter, die als Android-Bundle an den Adapter übergeben. Der Adapter sucht nach folgenden Elementen: Schlüssel im Bundle:
Anfrageparameter und -werte | |
---|---|
InneractiveMediationDefs.KEY_AGE
|
Integer: Dem Alter der Nutzenden |
FyberMediationAdapter.KEY_MUTE_VIDEO
|
Boolean. Video stummschalten oder Stummschaltung aufheben |
Das folgende Codebeispiel zeigt, wie diese Anzeigenanfrageparameter festgelegt werden:
Java
Bundle extras = new Bundle();
extras.putInt(InneractiveMediationDefs.KEY_AGE, 10);
extras.putBoolean(FyberMediationAdapter.KEY_MUTE_VIDEO, false);
AdRequest request = new AdRequest.Builder()
.addNetworkExtrasBundle(FyberMediationAdapter.class, extras)
.build();
Kotlin
var extras = Bundle()
extras.putInt(InneractiveMediationDefs.KEY_AGE, 10)
extras.putBoolean(FyberMediationAdapter.KEY_MUTE_VIDEO, false)
val request = AdRequest.Builder()
.addNetworkExtrasBundle(FyberMediationAdapter::class.java, extras)
.build()
Fehlercodes
Wenn der Adapter keine Anzeige von DT Exchange erhält, können Sie
zugrunde liegender Fehler aus der Anzeigenantwort
.
ResponseInfo.getAdapterResponses()
der folgenden Klasse:
com.google.ads.mediation.fyber.FyberMediationAdapter
Hier sind die Codes und zugehörigen Nachrichten, die vom DT Exchange-Adapter ausgegeben werden Wenn eine Anzeige nicht geladen werden kann:
Fehlercode | Grund |
---|---|
101 | Die in der Ad Manager 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. Siehe Code . |
Änderungsprotokoll zum DT Exchange Android-Vermittlungsadapter
Version 8.3.1.0
- Die Kompatibilität mit DT Exchange SDK 8.3.1 wurde bestätigt.
Entwickelt und getestet mit:
- Google Mobile Ads SDK, Version 23.3.0.
- DT Exchange SDK Version 8.3.1.
Version 8.3.0.0
- Unterstützung für die Übergabe der Version des Google Mobile Ads SDK an das DT Exchange SDK wurde hinzugefügt.
- Die Kompatibilität mit DT Exchange SDK 8.3.0 wurde bestätigt.
Entwickelt und getestet mit:
- Google Mobile Ads SDK, Version 23.2.0.
- DT Exchange SDK Version 8.3.0.
Version 8.2.7.0
- Die Kompatibilität mit DT Exchange SDK 8.2.7 wurde bestätigt.
Entwickelt und getestet mit:
- Google Mobile Ads SDK Version 23.0.0.
- DT Exchange SDK Version 8.2.7.
Version 8.2.6.1
- Die mindestens erforderliche Version des Google Mobile Ads SDK wurde auf Version 23.0.0 aktualisiert.
- Die Kompatibilität mit DT Exchange SDK 8.2.6 wurde bestätigt.
Entwickelt und getestet mit:
- Google Mobile Ads SDK Version 23.0.0.
- DT Exchange SDK Version 8.2.6.
Version 8.2.6.0
- Die Kompatibilität mit DT Exchange SDK 8.2.6 wurde bestätigt.
Entwickelt und getestet mit:
- Google Mobile Ads SDK, Version 22.6.0.
- DT Exchange SDK Version 8.2.6.
Version 8.2.5.0
- Die Kompatibilität mit DT Exchange SDK 8.2.5 wurde bestätigt.
Entwickelt und getestet mit:
- Google Mobile Ads SDK, Version 22.5.0.
- DT Exchange SDK Version 8.2.5.
Version 8.2.4.0
- Die Kompatibilität mit DT Exchange SDK 8.2.4 wurde bestätigt.
Entwickelt und getestet mit:
- Google Mobile Ads SDK, Version 22.3.0.
- DT Exchange SDK Version 8.2.4.
Version 8.2.3.0
- Der Adapter wurde zur Verwendung der neuen
VersionInfo
-Klasse aktualisiert. - Die mindestens erforderliche Version des Google Mobile Ads SDK wurde auf Version 22.0.0 aktualisiert.
Entwickelt und getestet mit:
- Google Mobile Ads SDK, Version 22.0.0.
- DT Exchange SDK Version 8.2.3.
Version 8.2.2.1
- Unterstützung für die zusätzliche Übergabe von
muteVideo
-Schlüssel in der Vermittlung zur Stummschaltung von Interstitial-Anzeigen wurde hinzugefügt.
Entwickelt und getestet mit:
- Google Mobile Ads SDK, Version 21.5.0.
- DT Exchange SDK Version 8.2.2.
Version 8.2.2.0
- Die Kompatibilität mit DT Exchange SDK 8.2.2 wurde bestätigt.
- Die mindestens erforderliche Version des Google Mobile Ads SDK wurde auf Version 21.5.0 aktualisiert.
Entwickelt und getestet mit:
- Google Mobile Ads SDK, Version 21.5.0.
- DT Exchange SDK Version 8.2.2.
Version 8.2.1.0
- Der Name des Adapters wurde in „DT Exchange“ umbenannt.
- Die Kompatibilität mit DT Exchange SDK 8.2.1 wurde bestätigt.
- Die mindestens erforderliche Version des Google Mobile Ads SDK wurde auf Version 21.3.0 aktualisiert.
Entwickelt und getestet mit:
- Google Mobile Ads SDK, Version 21.3.0.
- DT Exchange SDK Version 8.2.1.
Version 8.2.0.0
- Die Kompatibilität mit dem Fyber SDK 8.2.0 wurde bestätigt.
- Die mindestens erforderliche Version des Google Mobile Ads SDK wurde auf Version 21.1.0 aktualisiert.
Entwickelt und getestet mit:
- Google Mobile Ads SDK, Version 21.1.0.
- Fyber SDK Version 8.2.0.
Version 8.1.5.0
- Geprüfte Kompatibilität mit Fyber SDK 8.1.5.
Entwickelt und getestet mit:
- Google Mobile Ads SDK, Version 21.0.0.
- Fyber SDK Version 8.1.5.
Version 8.1.4.0
- Geprüfte Kompatibilität mit Fyber SDK 8.1.4.
Entwickelt und getestet mit:
- Google Mobile Ads SDK, Version 21.0.0.
- Fyber SDK Version 8.1.4.
Version 8.1.3.1
compileSdkVersion
undtargetSdkVersion
wurden auf API 31 aktualisiert.- Die mindestens erforderliche Version des Google Mobile Ads SDK wurde auf Version 21.0.0 aktualisiert.
- Das mindestens erforderliche Android-API-Level wurde auf 19 aktualisiert.
Entwickelt und getestet mit:
- Google Mobile Ads SDK, Version 21.0.0.
- Fyber SDK Version 8.1.3.
Version 8.1.3.0
- Geprüfte Kompatibilität mit Fyber SDK 8.1.3.
- Die mindestens erforderliche Version des Google Mobile Ads SDK wurde auf Version 20.6.0 aktualisiert.
Entwickelt und getestet mit:
- Google Mobile Ads SDK, Version 20.6.0.
- Fyber SDK Version 8.1.3.
Version 8.1.2.0
- Geprüfte Kompatibilität mit Fyber SDK 8.1.2.
- Die mindestens erforderliche Version des Google Mobile Ads SDK wurde auf Version 20.5.0 aktualisiert.
Entwickelt und getestet mit:
- Google Mobile Ads SDK, Version 20.5.0.
- Fyber SDK Version 8.1.2.
Version 8.1.0.0
- Die Kompatibilität mit dem Fyber SDK 8.1.0 wurde bestätigt.
Entwickelt und getestet mit:
- Google Mobile Ads SDK, Version 20.4.0.
- Fyber SDK Version 8.1.0.
Version 7.8.4.1
- Der Adapter wurde nicht initialisiert, wenn ein Duplikat oder mehrere eindeutige App-IDs aus den Vermittlungskonfigurationen vorhanden waren. Dieses Problem wurde behoben.
- Die mindestens erforderliche Version des Google Mobile Ads SDK wurde auf Version 20.4.0 aktualisiert.
Entwickelt und getestet mit:
- Google Mobile Ads SDK, Version 20.4.0.
- Fyber SDK Version 7.8.4.
Version 7.8.4.0
- Geprüfte Kompatibilität mit Fyber SDK 7.8.4.
- Die mindestens erforderliche Version des Google Mobile Ads SDK wurde auf Version 20.3.0 aktualisiert.
- Bei Displayanzeigen mit Prämie wurde
onVideoComplete()
nicht aufgerufen. Das Problem wurde behoben. - Für Fyber ist jetzt ein Aktivitätskontext erforderlich, damit Anzeigen eingeblendet werden können.
Entwickelt und getestet mit:
- Google Mobile Ads SDK, Version 20.3.0.
- Fyber SDK Version 7.8.4.
Version 7.8.3.0
- Geprüfte Kompatibilität mit Fyber SDK 7.8.3.
- Es wurden standardisierte Fehlercodes und Fehlermeldungen für Adapter hinzugefügt.
- Die mindestens erforderliche Version des Google Mobile Ads SDK wurde auf Version 20.1.0 aktualisiert.
Entwickelt und getestet mit:
- Google Mobile Ads SDK, Version 20.1.0.
- Fyber SDK Version 7.8.3.
Version 7.8.2.0
- Geprüfte Kompatibilität mit Fyber SDK 7.8.2.
- Die mindestens erforderliche Version des Google Mobile Ads SDK wurde auf Version 20.0.0 aktualisiert.
Entwickelt und getestet mit:
- Version 20.0.0 des Google Mobile Ads SDK
- Fyber SDK Version 7.8.2.
Version 7.8.1.0
- Geprüfte Kompatibilität mit Fyber SDK 7.8.1.
Entwickelt und getestet mit:
- Google Mobile Ads SDK, Version 19.7.0.
- Fyber SDK Version 7.8.1.
Version 7.8.0.0
- Die Kompatibilität mit dem Fyber SDK 7.8.0 wurde bestätigt.
- Die mindestens erforderliche Version des Google Mobile Ads SDK wurde auf Version 19.7.0 aktualisiert.
Entwickelt und getestet mit:
- Google Mobile Ads SDK, Version 19.7.0.
- Fyber SDK Version 7.8.0.
Version 7.7.4.0
- Geprüfte Kompatibilität mit Fyber SDK 7.7.4.
onUserEarnedReward()
wurde für Anzeigen mit Prämie zweimal weitergeleitet. Dieses Problem wurde behoben.
Entwickelt und getestet mit:
- Google Mobile Ads SDK, Version 19.5.0.
- Fyber SDK Version 7.7.4.
Version 7.7.3.0
- Geprüfte Kompatibilität mit Fyber SDK 7.7.3.
Entwickelt und getestet mit:
- Google Mobile Ads SDK, Version 19.5.0.
- Fyber SDK Version 7.7.3.
Version 7.7.2.0
- Geprüfte Kompatibilität mit Fyber SDK 7.7.2.
- Die mindestens erforderliche Version des Google Mobile Ads SDK wurde auf Version 19.5.0 aktualisiert.
Entwickelt und getestet mit:
- Google Mobile Ads SDK, Version 19.5.0.
- Fyber SDK Version 7.7.2.
Version 7.7.1.0
- Geprüfte Kompatibilität mit Fyber SDK 7.7.1.
- Die mindestens erforderliche Version des Google Mobile Ads SDK wurde auf Version 19.4.0 aktualisiert.
Entwickelt und getestet mit:
- Google Mobile Ads SDK, Version 19.4.0.
- Fyber SDK Version 7.7.1.
Version 7.7.0.0
- Die Kompatibilität mit dem Fyber SDK 7.7.0 wurde bestätigt.
Entwickelt und getestet mit:
- Google Mobile Ads SDK, Version 19.3.0.
- Fyber SDK Version 7.7.0.
Version 7.6.1.0
- Die Kompatibilität mit Fyber SDK 7.6.1 wurde bestätigt.
Entwickelt und getestet mit:
- Google Mobile Ads SDK, Version 19.3.0.
- Fyber SDK Version 7.6.1.
Version 7.6.0.0
- Die Kompatibilität mit dem Fyber SDK 7.6.0 wurde bestätigt.
- Der Adapter wurde aktualisiert, um Inline-Anfragen für adaptive Banner zu unterstützen.
- Die mindestens erforderliche Version des Google Mobile Ads SDK wurde auf Version 19.3.0 aktualisiert.
- Ein Fehler wurde behoben, bei dem onAdOpened()/onAdClosed()-Methoden für Banneranzeigen nicht aufgerufen wurden.
Entwickelt und getestet mit:
- Google Mobile Ads SDK, Version 19.3.0.
- Fyber SDK Version 7.6.0.
Version 7.5.4.0
- Geprüfte Kompatibilität mit Fyber SDK 7.5.4.
- Die mindestens erforderliche Version des Google Mobile Ads SDK wurde auf Version 19.1.0 aktualisiert.
Entwickelt und getestet mit:
- Google Mobile Ads SDK, Version 19.1.0.
- Fyber SDK Version 7.5.4.
Version 7.5.3.0
- Die Kompatibilität mit Fyber SDK 7.5.3 wurde bestätigt.
Entwickelt und getestet mit:
- Google Mobile Ads SDK, Version 19.0.1.
- Fyber SDK Version 7.5.3.
Version 7.5.2.0
- Geprüfte Kompatibilität mit Fyber SDK 7.5.2.
- Die mindestens erforderliche Version des Google Mobile Ads SDK wurde auf Version 19.0.1 aktualisiert.
Entwickelt und getestet mit:
- Google Mobile Ads SDK, Version 19.0.1.
- Fyber SDK Version 7.5.2.
Version 7.5.0.0
- Die Kompatibilität mit Fyber SDK 7.5.0 wurde bestätigt.
- Der Absturz von NullPointerException beim Laden von Fyber-Anzeigen wurde behoben.
Entwickelt und getestet mit:
- Google Mobile Ads SDK, Version 18.3.0.
- Fyber SDK Version 7.5.0.
Version 7.4.1.0
- Geprüfte Kompatibilität mit Fyber SDK 7.4.1.
- Die mindestens erforderliche Version des Google Mobile Ads SDK wurde auf Version 18.3.0 aktualisiert.
Entwickelt und getestet mit:
- Google Mobile Ads SDK, Version 18.3.0.
- Fyber SDK Version 7.4.1.
Version 7.3.4.0
- Erstes Release!
- Unterstützt Banner-, Interstitial- und Anzeigen mit Prämie.
Entwickelt und getestet mit:
- Google Mobile Ads SDK, Version 18.2.0.
- Fyber SDK Version 7.3.4.