In diesem Leitfaden erfahren Sie, wie Sie das Google Mobile Ads SDK verwenden, um Anzeigen aus DT Exchange mithilfe der Vermittlung zu laden und einzublenden. Dabei werden auch die abfolgebasierten Integrationen behandelt. Sie erfahren, wie Sie DT Exchange zur Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und das DT Exchange SDK und den Adapter in eine Android App einbinden.
Unterstützte Integrationen und Anzeigenformate
Der Ad Manager -Vermittlungsadapter für DT Exchange hat folgende Funktionen:
Integration | |
---|---|
Gebote | |
Wasserfall | |
Formate | |
Banner | |
Interstitial | |
Verfügbar | |
Nativ |
Voraussetzungen
- Android API-Level 19 oder höher
Das aktuelle Google Mobile Ads SDK
Arbeiten Sie den Startleitfaden zur Vermittlung ab.
Schritt 1: Konfigurationen in der DT Exchange-Benutzeroberfläche 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 auf 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.
Fyber zur Liste der Werbepartner gemäß DSGVO und Bestimmungen von US-Bundesstaaten hinzufügen
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 der Datei build.gradle.kts
auf App-Ebene die folgenden Implementierungsabhängigkeiten und Konfigurationen hinzu. Verwenden Sie die neuesten Versionen des DT Exchange-SDK und -Adapters:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.0.0")
implementation("com.google.ads.mediation:fyber:8.2.6.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
EU-Nutzereinwilligung und DSGVO
Gemäß der Richtlinie zur Einwilligung der Nutzer in der EU von Google müssen Sie dafür sorgen, dass Nutzern im Europäischen Wirtschaftsraum (EWR) bestimmte Informationen zur Verwendung von Gerätekennungen und personenbezogenen Daten offengelegt und deren Einwilligung von diesen eingeholt wird. 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 nutzen kann, und Informationen zur Nutzung der einzelnen Werbenetzwerke angeben. Google ist derzeit nicht in der Lage, die Einwilligungsentscheidung des Nutzers automatisch an diese Netzwerke weiterzugeben.
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, wird empfohlen, diesen Code vor der Anzeigenanfrage über das Google Mobile Ads SDK aufzurufen.
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")
Auf der Seite DSGVO-Ressourcen von DT Exchange und im Leitfaden zur DSGVO-Implementierung finden Sie weitere Details und die Werte, die in der Methode angegeben werden können.
Datenschutzgesetze von US-Bundesstaaten
Datenschutzgesetze von US-Bundesstaaten schreiben Nutzern das Recht, dem „Verkauf“ ihrer „personenbezogenen Daten“ zu widersprechen (laut gesetzlicher Definition dieser Begriffe). Dazu muss auf der Startseite des „Verkäufers“ ein deutlich sichtbarer Link mit dem Text „Do Not Sell My Personal Information“ (Meine personenbezogenen Daten dürfen 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 durch Google aktivieren. Google kann diese Einstellung jedoch nicht auf jedes Werbenetzwerk in der Vermittlungskette anwenden. Daher müssen Sie jedes Werbenetzwerk in Ihrer Vermittlungskette angeben, das möglicherweise am Verkauf personenbezogener Daten beteiligt ist, und die Anleitungen 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, wird empfohlen, diesen Code vor der Anzeigenanfrage über das Google Mobile Ads SDK aufzurufen.
Java
import com.fyber.inneractive.sdk.external.InneractiveAdManager;
// ...
InneractiveAdManager.setUSPrivacyString("myUSPrivacyString");
Kotlin
import com.fyber.inneractive.sdk.external.InneractiveAdManager
// ...
InneractiveAdManager.setUSPrivacyString("myUSPrivacyString")
Auf der CCPA-Ressourcenseite von DT Exchange und im CCPA-Implementierungsleitfaden findest du 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 werden können. Der Adapter sucht im Bundle nach den folgenden Schlüsseln:
Anfrageparameter und -werte | |
---|---|
InneractiveMediationDefs.KEY_AGE
|
Integer (Ganzzahl). Alter des Nutzers |
FyberMediationAdapter.KEY_MUTE_VIDEO
|
Boolean. Video stummschalten oder Stummschaltung aufheben |
Hier ein Codebeispiel für das Festlegen dieser Parameter für Anzeigenanfragen:
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)
var adrequest = AdRequest.Builder()
.addNetworkExtrasBundle(FyberMediationAdapter::class.java, extras)
.build()
Fehlercodes
Wenn der Adapter keine Anzeige von DT Exchange empfängt, können Sie den zugrunde liegenden Fehler aus der Anzeigenantwort mit
ResponseInfo.getAdapterResponses()
in der folgenden Klasse überprüfen:
com.google.ads.mediation.fyber.FyberMediationAdapter
Dies sind die Codes und Begleitmeldungen, die vom DT Exchange-Adapter ausgegeben werden, wenn eine Anzeige nicht geladen werden kann:
Fehlercode | Grund |
---|---|
101 | Die in der Ad Manager Benutzeroberfläche 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 zur Auslieferung bereit. |
200-399 | Das DT Exchange SDK hat einen Fehler zurückgegeben. Weitere Informationen finden Sie unter Code. |
0-10 | Das DT Exchange SDK hat einen Fehler zurückgegeben. Weitere Informationen finden Sie in der Dokumentation. |
101 | Die in der Ad Manager Benutzeroberfläche konfigurierten DT Exchange-Serverparameter fehlen oder sind ungültig. |
102 | Die angeforderte Anzeigengröße stimmt nicht mit einer von DT Exchange unterstützten Bannergröße überein. |
103 | Die Anzeige konnte nicht eingeblendet werden, da das Anzeigenobjekt bereits verwendet wurde. |
104 | DT Exchange-Anzeigen konnten nicht angezeigt werden, da die Anzeige nicht bereit ist. |
105 | Das DT Exchange SDK hat einen Initialisierungsfehler zurückgegeben. |
Änderungsprotokoll für den DT Exchange Android-Vermittlungsadapter
Version 8.2.6.0
- Bestätigte Kompatibilität mit DT Exchange SDK 8.2.6.
Erstellt und getestet mit:
- Version 22.6.0 des Google Mobile Ads SDK
- DT Exchange SDK Version 8.2.6.
Version 8.2.5.0
- Bestätigte Kompatibilität mit DT Exchange SDK 8.2.5.
Erstellt und getestet mit:
- Version 22.5.0 des Google Mobile Ads SDK
- DT Exchange SDK Version 8.2.5.
Version 8.2.4.0
- Bestätigte Kompatibilität mit DT Exchange SDK 8.2.4.
Erstellt und getestet mit:
- Version 22.3.0 des Google Mobile Ads SDK
- DT Exchange SDK Version 8.2.4.
Version 8.2.3.0
- Der Adapter wurde zur Verwendung der neuen
VersionInfo
-Klasse aktualisiert. - Die erforderliche Mindestversion des Google Mobile Ads SDK wurde auf 22.0.0 aktualisiert.
Erstellt und getestet mit:
- Version 22.0.0 des Google Mobile Ads SDK
- DT Exchange SDK Version 8.2.3.
Version 8.2.2.1
- Unterstützung für die zusätzliche Übergabe des
muteVideo
-Schlüssels in der Vermittlung zum Stummschalten von Interstitial-Anzeigen wurde hinzugefügt.
Erstellt und getestet mit:
- Version 21.5.0 des Google Mobile Ads SDK
- DT Exchange SDK Version 8.2.2.
Version 8.2.2.0
- Bestätigte Kompatibilität mit DT Exchange SDK 8.2.2.
- Die erforderliche Mindestversion des Google Mobile Ads SDK wurde auf 21.5.0 aktualisiert.
Erstellt und getestet mit:
- Version 21.5.0 des Google Mobile Ads SDK
- DT Exchange SDK Version 8.2.2.
Version 8.2.1.0
- Adaptername in „DT Exchange“ umbenannt.
- Bestätigte Kompatibilität mit DT Exchange SDK 8.2.1.
- Die erforderliche Mindestversion des Google Mobile Ads SDK wurde auf 21.3.0 aktualisiert.
Erstellt und getestet mit:
- Version 21.3.0 des Google Mobile Ads SDK
- DT Exchange SDK Version 8.2.1.
Version 8.2.0.0
- Bestätigte Kompatibilität mit Fyber SDK 8.2.0.
- Die erforderliche Mindestversion des Google Mobile Ads SDK wurde auf 21.1.0 aktualisiert.
Erstellt und getestet mit:
- Version 21.1.0 des Google Mobile Ads SDK
- Fyber SDK, Version 8.2.0.
Version 8.1.5.0
- Bestätigte Kompatibilität mit Fyber SDK 8.1.5.
Erstellt und getestet mit:
- Version 21.0.0 des Google Mobile Ads SDK
- Fyber SDK, Version 8.1.5.
Version 8.1.4.0
- Bestätigte Kompatibilität mit Fyber SDK 8.1.4.
Erstellt und getestet mit:
- Version 21.0.0 des Google Mobile Ads SDK
- Fyber SDK Version 8.1.4.
Version 8.1.3.1
compileSdkVersion
undtargetSdkVersion
wurden auf API 31 aktualisiert.- Die erforderliche Mindestversion des Google Mobile Ads SDK wurde auf 21.0.0 aktualisiert.
- Das mindestens erforderliche Android API-Level wurde auf 19 aktualisiert.
Erstellt und getestet mit:
- Version 21.0.0 des Google Mobile Ads SDK
- Fyber SDK Version 8.1.3.
Version 8.1.3.0
- Bestätigte Kompatibilität mit Fyber SDK 8.1.3.
- Die erforderliche Mindestversion des Google Mobile Ads SDK wurde auf 20.6.0 aktualisiert.
Erstellt und getestet mit:
- Google Mobile Ads SDK: Version 20.6.0
- Fyber SDK Version 8.1.3.
Version 8.1.2.0
- Bestätigte Kompatibilität mit Fyber SDK 8.1.2.
- Die erforderliche Mindestversion des Google Mobile Ads SDK wurde auf 20.5.0 aktualisiert.
Erstellt und getestet mit:
- Google Mobile Ads SDK: Version 20.5.0.
- Fyber SDK Version 8.1.2.
Version 8.1.0.0
- Bestätigte Kompatibilität mit Fyber SDK 8.1.0.
Erstellt 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 in den Vermittlungskonfigurationen doppelt oder mehr als eine eindeutige App-ID vorhanden war. Dieses Problem wurde behoben.
- Die erforderliche Mindestversion des Google Mobile Ads SDK wurde auf 20.4.0 aktualisiert.
Erstellt und getestet mit:
- Google Mobile Ads SDK: Version 20.4.0
- Fyber SDK Version 7.8.4.
Version 7.8.4.0
- Bestätigte Kompatibilität mit Fyber SDK 7.8.4.
- Die erforderliche Mindestversion des Google Mobile Ads SDK wurde auf Version 20.3.0 aktualisiert.
- Es wurde ein Problem mit Displayanzeigen mit Prämie behoben, bei denen
onVideoComplete()
nicht aufgerufen wurde. - Fyber benötigt jetzt einen Aktivitätskontext, um Anzeigen präsentieren zu können.
Erstellt und getestet mit:
- Google Mobile Ads SDK: Version 20.3.0
- Fyber SDK Version 7.8.4.
Version 7.8.3.0
- Bestätigte Kompatibilität mit Fyber SDK 7.8.3.
- Standardisierte Adapterfehlercodes und -meldungen hinzugefügt.
- Die erforderliche Mindestversion des Google Mobile Ads SDK wurde auf Version 20.1.0 aktualisiert.
Erstellt und getestet mit:
- Google Mobile Ads SDK: Version 20.1.0.
- Fyber SDK Version 7.8.3.
Version 7.8.2.0
- Bestätigte Kompatibilität mit Fyber SDK 7.8.2.
- Die erforderliche Mindestversion des Google Mobile Ads SDK wurde auf Version 20.0.0 aktualisiert.
Erstellt und getestet mit:
- Google Mobile Ads SDK: Version 20.0.0.
- Fyber SDK, Version 7.8.2.
Version 7.8.1.0
- Bestätigte Kompatibilität mit Fyber SDK 7.8.1.
Erstellt und getestet mit:
- Version 19.7.0 des Google Mobile Ads SDK
- Fyber SDK Version 7.8.1.
Version 7.8.0.0
- Bestätigte Kompatibilität mit Fyber SDK 7.8.0.
- Die erforderliche Mindestversion des Google Mobile Ads SDK wurde auf Version 19.7.0 aktualisiert.
Erstellt und getestet mit:
- Version 19.7.0 des Google Mobile Ads SDK
- Fyber SDK, Version 7.8.0.
Version 7.7.4.0
- Bestätigte Kompatibilität mit Fyber SDK 7.7.4.
- Das Problem, dass
onUserEarnedReward()
bei Anzeigen mit Prämie zweimal weitergeleitet wurde, wurde behoben.
Erstellt und getestet mit:
- Version 19.5.0 des Google Mobile Ads SDK
- Fyber SDK Version 7.7.4.
Version 7.7.3.0
- Bestätigte Kompatibilität mit Fyber SDK 7.7.3.
Erstellt und getestet mit:
- Version 19.5.0 des Google Mobile Ads SDK
- Fyber SDK, Version 7.7.3.
Version 7.7.2.0
- Bestätigte Kompatibilität mit Fyber SDK 7.7.2.
- Die erforderliche Mindestversion des Google Mobile Ads SDK wurde auf 19.5.0 aktualisiert.
Erstellt und getestet mit:
- Version 19.5.0 des Google Mobile Ads SDK
- Fyber SDK, Version 7.7.2.
Version 7.7.1.0
- Bestätigte Kompatibilität mit Fyber SDK 7.7.1.
- Die erforderliche Mindestversion des Google Mobile Ads SDK wurde auf 19.4.0 aktualisiert.
Erstellt und getestet mit:
- Version 19.4.0 des Google Mobile Ads SDK
- Fyber SDK, Version 7.7.1.
Version 7.7.0.0
- Bestätigte Kompatibilität mit Fyber SDK 7.7.0.
Erstellt und getestet mit:
- Version 19.3.0 des Google Mobile Ads SDK
- Fyber SDK, Version 7.7.0.
Version 7.6.1.0
- Bestätigte Kompatibilität mit Fyber SDK 7.6.1.
Erstellt und getestet mit:
- Version 19.3.0 des Google Mobile Ads SDK
- Fyber SDK, Version 7.6.1.
Version 7.6.0.0
- Bestätigte Kompatibilität mit Fyber SDK 7.6.0.
- Der Adapter wurde aktualisiert, sodass Anfragen für adaptive Inline-Banner unterstützt werden.
- Die erforderliche Mindestversion des Google Mobile Ads SDK wurde auf Version 19.3.0 aktualisiert.
- Es wurde ein Fehler behoben, bei dem die Methoden onAdOpened()/onAdClosed() für Banneranzeigen nicht aufgerufen wurden.
Erstellt und getestet mit:
- Version 19.3.0 des Google Mobile Ads SDK
- Fyber SDK, Version 7.6.0.
Version 7.5.4.0
- Bestätigte Kompatibilität mit Fyber SDK 7.5.4.
- Die erforderliche Mindestversion des Google Mobile Ads SDK wurde auf Version 19.1.0 aktualisiert.
Erstellt und getestet mit:
- Version 19.1.0 des Google Mobile Ads SDK
- Fyber SDK, Version 7.5.4.
Version 7.5.3.0
- Bestätigte Kompatibilität mit Fyber SDK 7.5.3.
Erstellt und getestet mit:
- Google Mobile Ads SDK, Version 19.0.1.
- Fyber SDK, Version 7.5.3.
Version 7.5.2.0
- Bestätigte Kompatibilität mit Fyber SDK 7.5.2.
- Die erforderliche Mindestversion des Google Mobile Ads SDK wurde auf 19.0.1 aktualisiert.
Erstellt und getestet mit:
- Google Mobile Ads SDK, Version 19.0.1.
- Fyber SDK, Version 7.5.2.
Version 7.5.0.0
- Bestätigte Kompatibilität mit Fyber SDK 7.5.0.
- Der NullPointerException-Absturz beim Laden von Fyber-Anzeigen wurde behoben.
Erstellt und getestet mit:
- Version 18.3.0 des Google Mobile Ads SDK
- Fyber SDK, Version 7.5.0.
Version 7.4.1.0
- Bestätigte Kompatibilität mit Fyber SDK 7.4.1.
- Die erforderliche Mindestversion des Google Mobile Ads SDK wurde auf Version 18.3.0 aktualisiert.
Erstellt und getestet mit:
- Version 18.3.0 des Google Mobile Ads SDK
- Fyber SDK, Version 7.4.1.
Version 7.3.4.0
- Erstes Release!
- Unterstützt Banner-, Interstitial- und Anzeigen mit Prämie.
Erstellt und getestet mit:
- Version 18.2.0 des Google Mobile Ads SDK
- Fyber SDK, Version 7.3.4.