DT Exchange in die Vermittlung integrieren

In diesem Leitfaden erfahren Sie, wie Sie mit dem Google Mobile Ads SDK Anzeigen über DT Exchange mithilfe von Vermittlung laden und präsentieren. Dabei werden auch Abfolgeintegrationen behandelt. Darin wird beschrieben, wie Sie DT Exchange der Vermittlungskonfiguration einer Anzeigeneinheit hinzufügen und 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 an oder mache dich sitzungsaktiv in der DT Exchange Console.

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

Wählen Sie die 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.

Notieren Sie sich auf der Seite App-Verwaltung die App-ID neben Ihrer App.

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.

Notieren Sie sich die Publisher-ID, den Consumer-Key und das Consumer-Secret, da Sie sie im nächsten Schritt benötigen.

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

Vermittlungseinstellungen für Ihren Anzeigenblock konfigurieren

Melden Sie sich in Ihrem Ad Manager-Konto an.

Klicken Sie auf Auslieferung > Ertragsgruppen und dann auf die Schaltfläche Neue Ertragsgruppe.

Geben Sie einen eindeutigen Namen für die Ertragsgruppe ein, legen Sie den Status auf Aktiv fest, wählen Sie das Anzeigenformat aus und legen Sie den Inventartyp auf Mobile App fest. Wählen Sie dann 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ür DT Exchange haben, können Sie ihn auswählen. Wählen Sie andernfalls Neuen Yield-Partner erstellen aus.

Wählen Sie DT Exchange als Werbenetzwerk aus, geben Sie einen eindeutigen Namen ein und aktivieren Sie Vermittlung.

Aktiviere die automatische Datenerhebung und gib die Publisher-ID, das Consumer Secret und den Consumer Key ein, die du im vorherigen Abschnitt abgerufen hast.

Wählen Sie als Integrationstyp SDK-Vermittlung für Mobilgeräte, als Plattform Android und als Status Aktiv aus. Geben Sie die Anwendungs-ID und die Placement-ID ein, die Sie im vorherigen Abschnitt abgerufen haben. Geben Sie dann einen Wert für CPM-Standardwert ein.

Klicken Sie abschließend unten auf der Seite auf Speichern.

DT Exchange (Fyber Monetization) der Liste der Werbepartner für die DSGVO und Verordnungen von US-Bundesstaaten hinzufügen

Folgen Sie der Anleitung unter Einstellungen für die DSGVO und Einstellungen für die Bestimmungen von US-Bundesstaaten, um DT Exchange (Fyber Monetization) der Liste der Werbepartner für die DSGVO und die Bestimmungen von US-Bundesstaaten in der Ad Manager-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.3.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
• Rufe die DT Exchange-Adapter-Artefakte im Maven-Repository von Google auf. Wählen Sie die neueste Version aus, laden Sie die .aar-Datei 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 Nutzern im Europäischen Wirtschaftsraum (EWR) bestimmte Informationen zur Verwendung von Geräte-IDs und personenbezogenen Daten offenlegen und ihre Einwilligung einholen. Die 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 jedes Werbenetzwerk in Ihrer Vermittlungskette angeben, das personenbezogene Daten erheben, empfangen oder verwenden kann. Außerdem müssen Sie Informationen zur Nutzung jedes Netzwerks bereitstellen. 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. Im folgenden Codebeispiel wird gezeigt, wie Sie Einwilligungsinformationen manuell an das DT Exchange SDK übergeben. 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 und im Leitfaden zur DSGVO-Implementierung von DT Exchange.

Datenschutzgesetze von US-Bundesstaaten

Gemäß den Datenschutzgesetzen von US-Bundesstaaten muss Nutzern das Recht eingeräumt werden, 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. Im Leitfaden zur Einhaltung der Datenschutzgesetze von US-Bundesstaaten können Sie die eingeschränkte Datenverarbeitung für die Anzeigenbereitstellung von Google aktivieren. Google kann diese Einstellung jedoch nicht auf jedes Anzeigennetzwerk 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 Anleitungen der einzelnen Netzwerke befolgen, um die Einhaltung der Anforderungen 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 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.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-Ressourcenseite und im CCPA-Implementierungsleitfaden von DT Exchange.

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 bestätigen

Wenn Sie prüfen möchten, ob Sie Testanzeigen von DT Exchange erhalten, aktivieren Sie im Anzeigenprüftool die Tests für einzelne Anzeigenquellen und verwenden Sie die Anzeigenquellen DT Exchange (Wasserfall).

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:

Hier ein Codebeispiel für die Einstellung dieser Parameter für Anzeigenanfragen:

Bundle extras = new Bundle();
extras.putInt(InneractiveMediationDefs.KEY_AGE, 10);
extras.putBoolean(FyberMediationAdapter.KEY_MUTE_VIDEO, false);

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
   .addNetworkExtrasBundle(FyberMediationAdapter.class, extras)
   .build();

var extras = Bundle()
extras.putInt(InneractiveMediationDefs.KEY_AGE, 10)
extras.putBoolean(FyberMediationAdapter.KEY_MUTE_VIDEO, false)

val request = AdManagerAdRequest.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 für den DT Exchange-Android-Vermittlungsadapter

Version 8.3.3.0

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

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 23.5.0
• DT Exchange SDK-Version 8.3.3

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 Version des Google Mobile Ads SDK 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 Mindestversion des Google Mobile Ads SDK wurde auf 23.0.0 aktualisiert.
• Kompatibilität mit DT Exchange SDK 8.2.6 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

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

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

• Es wurde die Unterstützung für das Übergeben des Schlüssels muteVideo in der Vermittlungs-Extrafunktion hinzugefügt, um Interstitial-Anzeigen stummzuschalten.

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 Mindestversion des Google Mobile Ads SDK wurde auf 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“ geändert.
• Kompatibilität mit DT Exchange SDK 8.2.1 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

• Kompatibilität mit dem Fyber SDK 8.2.0 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 auf API 31 aktualisiert
• Die Mindestversion des Google Mobile Ads SDK wurde auf 21.0.0 aktualisiert.
• Das für Android erforderliche Mindest-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 Mindestversion des Google Mobile Ads SDK wurde auf 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 Mindestversion des Google Mobile Ads SDK wurde auf 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

• Kompatibilität mit dem Fyber SDK 8.1.0 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 Mindestversion des Google Mobile Ads SDK wurde auf 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 Mindestversion des Google Mobile Ads SDK wurde auf 20.3.0 aktualisiert.
• Ein Problem mit Displayanzeigen mit Prämie, bei dem onVideoComplete() nicht aufgerufen wurde, wurde behoben.
• Für die Auslieferung von Anzeigen über Fyber ist jetzt ein Aktivitätskontext erforderlich.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 20.3.0
• Fyber SDK-Version 7.8.4

Version 7.8.3.0

• Kompatibilität mit dem Fyber SDK 7.8.3 bestätigt.
• Es wurden standardisierte Adapterfehlercodes und ‑meldungen 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 Mindestversion des Google Mobile Ads SDK wurde auf 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

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

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

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

• Kompatibilität mit dem Fyber SDK 7.7.0 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

• Kompatibilität mit dem Fyber SDK 7.6.1 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

• Kompatibilität mit dem Fyber SDK 7.6.0 bestätigt.
• Der Adapter wurde aktualisiert, um Anfragen für adaptive Inline-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

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

• Kompatibilität mit dem Fyber SDK 7.5.3 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

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

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