DT Exchange in die Vermittlung einbinden

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:

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

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.

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 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: <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 wird die Einwilligungsentscheidung des Nutzers automatisch an diese Netzwerke übergeben.

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.

import com.fyber.inneractive.sdk.external.InneractiveAdManager;
// ...

InneractiveAdManager.setGdprConsent(true);
InneractiveAdManager.setGdprConsentString("myGdprConsentString");

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 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.

import com.fyber.inneractive.sdk.external.InneractiveAdManager;
// ...

InneractiveAdManager.setUSPrivacyString("myUSPrivacyString");

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:

Das folgende Codebeispiel zeigt, wie diese Anzeigenanfrageparameter festgelegt werden:

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();

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:

Ä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 und targetSdkVersion 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

• Die Kompatibilität mit dem Fyber SDK 7.8.4 wurde bestätigt.
• 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 dem 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.