DT Exchange in die Vermittlung integrieren

In diesem Leitfaden erfahren Sie, wie Sie das Google Mobile Ads SDK verwenden, um Anzeigen aus DT Exchange mithilfe von AdMob Mediation, der abfolgebasierte Integrationen zu laden und einzublenden. Darin erfahren Sie, wie Sie DT Exchange zur Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und wie Sie das DT Exchange SDK und den Adapter in eine Android App einbinden.

Unterstützte Einbindungen und Anzeigenformate

Der Vermittlungsadapter für DT Exchange bietet folgende Funktionen:

Voraussetzungen

• Android API-Level 21 oder höher

• Neueste Version des Google Mobile Ads SDK

• Mediation abschließen Startleitfaden

Schritt 1: Konfigurationen in der DT Exchange-Benutzeroberfläche einrichten

Neue App und neues Anzeigen-Placement hinzufügen

Melde dich oder melde dich an in der DT Exchange Console an.

Klicken Sie auf die Schaltfläche App hinzufügen, um die App hinzuzufügen.

Wählen Sie Ihre Plattform aus, füllen Sie den Rest des Formulars aus und klicken Sie auf Placements hinzufügen.

Geben Sie in das Feld Placement benennen einen Namen für das neue Placement ein und wählen Sie in der Drop-down-Liste den gewünschten Placement-Typ aus. Klicken Sie abschließend auf Placement speichern.

App-ID und Placement-ID

Bewegen Sie den Mauszeiger auf die linke Navigationsleiste, um sie zu öffnen. Klicken Sie dann im Menü links auf Apps.

Auf der Seite App-Verwaltung wird neben Ihrer App die App-ID angezeigt.

Wählen Sie Ihre App aus, rufen Sie den Tab Placements auf und klicken Sie neben Placement-Name auf das Symbol zum Kopieren. 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.

Notiere dir die Publisher-ID, den Consumer-Key und das Consumer-Secret, da du sie im nächsten Schritt benötigst.

Schritt 2: DT Exchange-Nachfrage in der AdMob -Benutzeroberfläche einrichten

Vermittlungseinstellungen für Anzeigenblöcke konfigurieren

Sie müssen der Vermittlungskonfiguration für Ihren Anzeigenblock DT Exchange hinzufügen.

Melden Sie sich in Ihrem AdMob-Konto an. Rufen Sie als Nächstes den Tab Vermittlung auf. Wenn Sie eine bestehende Vermittlungsgruppe ändern möchten, klicken Sie zum Bearbeiten auf ihren Namen und fahren Sie mit DT Exchange als Anzeigenquelle hinzufügen fort.

Wenn Sie eine neue Vermittlungsgruppe erstellen möchten, wählen Sie Vermittlungsgruppe erstellen aus.

Geben Sie das Anzeigenformat und die Plattform ein. Klicken Sie dann auf Weiter.

Geben Sie einen Namen für die Vermittlungsgruppe ein und wählen Sie Standorte für die Ausrichtung aus. Legen Sie als Nächstes den Status der Vermittlungsgruppe auf Aktiviert fest und klicken Sie dann auf Anzeigenblöcke hinzufügen.

Verknüpfen Sie diese Vermittlungsgruppe mit einem oder mehreren Ihrer vorhandenenAdMob Anzeigenblöcke. Klicken Sie dann auf Fertig.

Die Karte „Anzeigenblöcke“ sollte jetzt mit den ausgewählten Anzeigenblöcken gefüllt sein:

DT Exchange als Anzeigenquelle hinzufügen

Wählen Sie im Bereich Anzeigenquellen auf der Karte Abfolge die Option Anzeigenquelle hinzufügen aus. Wählen Sie dann DT Exchange aus.

Wenn Sie bereits eine Zuordnung für DT Exchangehaben, können Sie sie auswählen. Klicken Sie andernfalls auf Zuordnung hinzufügen.

Geben Sie als Nächstes den Application ID and Placement IDein, den Sie im vorherigen Abschnitt erhalten haben. Klicken Sie dann auf Fertig.

Zur Liste der Werbepartner zur DSGVO und zu Verordnungen von US-Bundesstaaten hinzufügen DT Exchange (Fyber Monetization)

Folgen Sie den Schritten in den DSGVO-Einstellungen und den Einstellungen für Verordnungen von US-Bundesstaaten, um DT Exchange (Fyber Monetization) zur Liste der Werbepartner für DSGVO und Verordnungen von US-Bundesstaaten in der AdMob-Benutzeroberfläche hinzuzufügen.

Schritt 3: DT Exchange SDK und Adapter importieren

Android Studio-Integration (empfohlen)

Fügen Sie in der build.gradle.kts-Datei auf App-Ebene die folgenden Implementierungsabhängigkeiten und ‑konfigurationen hinzu. Verwenden Sie die neuesten Versionen des DT Exchange SDK und des Adapters:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.5.0")
    implementation("com.google.ads.mediation:fyber:8.3.2.0")
}

Manuelle Integration

• Laden Sie die neueste Version des DT Exchange SDK for Android herunter und fügen Sie Ihrem Projekt die folgenden Dateien hinzu:
  • ia-mraid-kit-release-x.y.z.aar
  • ia-sdk-core-release-x.y.z.aar
  • ia-video-kit-release-x.y.z.aar
• Rufen Sie die DT Exchange-Adapterartefakte im Maven-Repository von Google auf. Wählen Sie die neueste Version aus, laden Sie die Datei .aar des DT Exchange-Adapters herunter 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-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 kann die Einwilligung des Nutzers derzeit nicht automatisch an diese Netzwerke weitergeben.

DT Exchange enthält eine API, mit der Sie die Nutzereinwilligung an das SDK weiterleiten können. Der folgende Beispielcode zeigt, wie Einwilligungsinformationen manuell an das DT Exchange SDK übergeben werden. Wenn Sie Informationen zur Einwilligung manuell an das DT Exchange SDK weitergeben möchten, wird empfohlen, diesen Code vor dem Anfordern von Anzeigen über das Google Mobile Ads SDK aufzurufen.

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")

Weitere Informationen und die Werte, die in der Methode angegeben werden können, finden Sie auf der DSGVO-Ressourcenseite von DT Exchange und im Leitfaden zur Implementierung der DSGVO .

Datenschutzgesetze von US-Bundesstaaten

Datenschutzgesetze von US-Bundesstaaten verpflichten Sie, Nutzern das Recht einzuräumen, dem „Verkauf“ ihrer „personenbezogenen Daten“ zu widersprechen (laut gesetzlicher Definition der Begriffe „sale“ und „personal information“). Dazu muss auf der Website des „Verkäufers“ (selling party) ein gut sichtbarer Link mit dem Text „Do Not Sell My Personal Information“ (Meine personenbezogenen Daten sollen nicht verkauft werden) vorhanden sein. 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 angeben, das am Verkauf personenbezogener Daten beteiligt sein könnte, und die Richtlinien der einzelnen Werbenetzwerke befolgen, um die Compliance sicherzustellen.

DT Exchange enthält eine API, mit der Sie die Nutzereinwilligung an das SDK weiterleiten können. Im folgenden Codebeispiel wird gezeigt, wie Sie Einwilligungsinformationen manuell an das DT Exchange SDK übergeben. Wenn Sie Einwilligungsinformationen manuell an das DT Exchange SDK übergeben möchten, sollten Sie diesen Code vor dem Anfordern von Anzeigen über das Google Mobile Ads SDK aufrufen.

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

InneractiveAdManager.setUSPrivacyString("myUSPrivacyString");

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

InneractiveAdManager.setUSPrivacyString("myUSPrivacyString")

Weitere Informationen und die Werte, die in der Methode angegeben werden können, finden Sie auf der CCPA Resource Page von DT Exchange und im Leitfaden zur Implementierung von CCPA .

Schritt 5: Erforderlichen Code hinzufügen

Für die DT Exchange-Integration ist kein zusätzlicher Code erforderlich.

Schritt 6: Implementierung testen

Optionale Schritte

Netzwerkspezifische Parameter

Der DT Exchange-Adapter unterstützt zusätzliche Anfrageparameter, die dem Adapter als Android-Bundle übergeben werden können. Der Adapter sucht im Bundle nach den folgenden Schlüsseln:

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 empfängt, kannst du den zugrunde liegenden Fehler in der Anzeigenantwort mithilfe von ResponseInfo.getAdapterResponses() unter der folgenden Klasse prüfen:

com.google.ads.mediation.fyber.FyberMediationAdapter

Im Folgenden finden Sie die Codes und die zugehörigen Meldungen, die vom DT Exchange-Adapter ausgegeben werden, wenn eine Anzeige nicht geladen werden kann:

Änderungsprotokoll zum DT Exchange Android-Vermittlungsadapter

Version 8.3.2.0

• Kompatibilität mit DT Exchange SDK 8.3.2 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK, Version 23.4.0.
• DT Exchange SDK Version 8.3.2.

Version 8.3.1.0

• Kompatibilität mit DT Exchange SDK 8.3.1 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

• Es wurde die Unterstützung für das Übergeben der Google Mobile Ads SDK-Version an das DT Exchange SDK hinzugefügt.
• Kompatibilität mit DT Exchange SDK 8.3.0 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

• Kompatibilität mit DT Exchange SDK 8.2.7 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

• Kompatibilität mit DT Exchange SDK 8.2.5 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 aktualisiert, um die neue VersionInfo-Klasse zu verwenden.
• 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

• Kompatibilität mit DT Exchange SDK 8.2.2 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 Mindestversion des Google Mobile Ads SDK wurde auf 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 Mindestversion des Google Mobile Ads SDK wurde auf 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

• Kompatibilität mit dem Fyber SDK 8.1.5 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK-Version 21.0.0
• Fyber SDK Version 8.1.5.

Version 8.1.4.0

• Kompatibilität mit dem Fyber SDK 8.1.4 bestätigt.

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

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

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

• Es wurde ein Problem behoben, durch das der Adapter nicht initialisiert wurde, wenn es ein Duplikat oder mehr als eine eindeutige App-ID aus den Vermittlungskonfigurationen gab.
• 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

• Kompatibilität mit dem Fyber SDK 7.8.4 bestätigt.
• Die mindestens erforderliche Version des Google Mobile Ads SDK wurde auf Version 20.3.0 aktualisiert.
• Ein Problem mit Displayanzeigen mit Prämie, bei dem onVideoComplete() nicht aufgerufen wurde, 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 Mindestversion des Google Mobile Ads SDK wurde auf 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

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

• Kompatibilität mit dem Fyber SDK 7.8.0 bestätigt.
• Die Mindestversion des Google Mobile Ads SDK wurde auf 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

• Kompatibilität mit dem Fyber SDK 7.7.4 bestätigt.
• Ein Problem wurde behoben, bei dem onUserEarnedReward() bei Anzeigen mit Prämie zweimal weitergeleitet wurde.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 19.5.0
• Fyber SDK Version 7.7.4.

Version 7.7.3.0

• Kompatibilität mit dem Fyber SDK 7.7.3 bestätigt.

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

• Kompatibilität mit dem Fyber SDK 7.7.1 bestätigt.
• Die Mindestversion des Google Mobile Ads SDK wurde auf 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 Mindestversion des Google Mobile Ads SDK wurde auf 19.3.0 aktualisiert.
• Ein Fehler wurde behoben, bei dem die Methoden „onAdOpened()“ und „onAdClosed()“ 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 Mindestversion des Google Mobile Ads SDK wurde auf 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 Mindestversion des Google Mobile Ads SDK wurde auf 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

• Kompatibilität mit dem Fyber SDK 7.5.0 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 Mindestversion des Google Mobile Ads SDK wurde auf 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.