DT Exchange in die Vermittlung einbinden

In diesem Leitfaden erfahren Sie, wie Sie das Google Mobile Ads SDK verwenden, um Anzeigen aus DT Exchange mithilfe von Vermittlung und 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 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

• Schließen Sie die Vermittlung ab. 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ügen Sie in der Datei build.gradle.kts auf App-Ebene die folgenden Abhängigkeiten und Konfigurationen für die Implementierung hinzu. Verwenden Sie die neuesten Versionen des DT Exchange SDK und des Adapters:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.2.0")
    implementation("com.google.ads.mediation:fyber:8.2.7.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 ist derzeit nicht in der Lage, die Einwilligungsentscheidung des Nutzers automatisch an solche Netzwerke zu übergeben.

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 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.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 müssen Nutzern das Recht einräumen, dem „Verkauf“ ihrer „personenbezogenen Daten“ zu widersprechen (laut gesetzlicher Definition dieser Bedingungen). Dazu muss auf der Startseite des „Verkäufers“ ein gut sichtbarer Link mit dem Text „Meine personenbezogenen Daten sollen nicht verkauft werden“ eingeblendet werden. 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 identifizieren, 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. Der folgende Beispielcode zeigt, wie Einwilligungsinformationen manuell an das DT Exchange SDK übergeben werden. 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

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 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, können Sie mit ResponseInfo.getAdapterResponses() unter der folgenden Klasse den zugrunde liegenden Fehler aus der Anzeigenantwort prüfen:

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

Nächste Version:

• Übergeben Sie die MobileAds-Version an das DT Exchange SDK.

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

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

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

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