In diesem Leitfaden erfahren Sie, wie Sie mit dem Google Mobile Ads SDK Anzeigen von DT Exchange mit Vermittlung mit 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
Add new app and ad placement
Sign up or log in to DT Exchange Console.
Click on the Add App button to add your app.
Select your Platform, fill out the rest of the form, and click Add Placements.
Enter a name for the new placement in the field labeled Name your Placement and select your desired Placement Type from the dropdown list. Finally, click Save Placement.
App ID and Placement ID
Open the left navigation bar by hovering your mouse over it. Then click Apps from the left menu.
On the App Management page, take note of the App ID next to your app.
Select your app, navigate to the Placements tab, and click on the copy icon next to Placement Name. Take note of the Placement ID.
Publisher ID, Consumer Key and Consumer Secret
Click on your username from the left menu and select User Profile.
Take note of the Publisher ID, Consumer Key, and Consumer Secret as these are needed in the next step.
Schritt 2: DT Exchange-Nachfrage in der Ad Manager Benutzeroberfläche einrichten
Vermittlungseinstellungen für Anzeigenblöcke konfigurieren
Melden Sie sich in Ihrem Ad Manager-Konto an.
Rufen Sie Auslieferung > Ertragsgruppen auf und klicken Sie auf die Schaltfläche Neue Ertragsgruppe.
Geben Sie einen eindeutigen Namen für die Ertragsgruppe ein, setzen Sie den Status auf Aktiv, wählen Sie das Anzeigenformat und dann den Inventartyp auf Mobile App aus. Wählen Sie unter Targeting > Inventar unter Inventar und Mobile App den Anzeigenblock aus, dem Sie die Vermittlung hinzufügen möchten.
Klicken Sie dann auf die Schaltfläche Ertragspartner hinzufügen.
Wenn Sie bereits einen Ertragspartner fürDT Exchangehaben, können Sie ihn auswählen. Wählen Sie andernfalls Neuen Ertragspartner erstellen aus.
Wählen Sie DT Exchange als Werbenetzwerk aus, geben Sie einen eindeutigen Namen ein und aktivieren Sie die Vermittlung.
Aktivieren Sie Automatische Datenerhebung und geben Sie denPublisher ID, Consumer Secret and Consumer Key ein, den Sie im vorherigen Abschnitt erhalten haben.
Wählen Sie nach der Auswahl des Ertragspartners als Integrationstyp die Option SDK-Vermittlung für Mobilgeräte, als Plattform Android und als Status Aktiv aus. Geben Sie den im vorherigen Abschnitt ermitteltenApplication ID and Placement ID ein. Geben Sie dann einen Wert für den Standard-CPM ein.
Klicken Sie abschließend unten auf der Seite auf Speichern.
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 Ad Manager Benutzeroberfläche aufzunehmen.
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.0.0")
}
Manuelle Integration
- Laden Sie die aktuelle Version der
DT Exchange SDK for Android und fügen Sie
folgende Dateien in Ihr Projekt ein:
<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 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, 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.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:
- Google Mobile Ads SDK, Version 20.0.0.
- 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
- Geprüfte Kompatibilität mit Fyber SDK 7.6.1.
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.
- Es wurde ein Fehler 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
- Geprüfte Kompatibilität mit Fyber SDK 7.5.3.
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.