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, wobei abfolgebasierte Integrationen abgedeckt werden. Sie erfahren, wie Sie DT Exchange zur Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und das DT Exchange SDK und den Adapter in eine Flutter 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 |
Voraussetzungen
- Das aktuelle Google Mobile Ads SDK
- Flutter 3.7.0 oder höher
- Für die Bereitstellung unter Android
- Android API-Level 21 oder höher
- Für die Bereitstellung unter iOS
- iOS-Bereitstellungsziel 12.0 oder höher
- Ein funktionierendes Flutter Projekt, das mit dem Google Mobile Ads SDK konfiguriert wurde Weitere Informationen finden Sie unter Erste Schritte.
- 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.
Android
iOS
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
Android
Eine Anleitung finden Sie in Schritt 2 der Anleitung für Android.
iOS
Eine Anleitung dazu finden Sie in Schritt 2 der Anleitung für iOS.
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
Integration über pub.dev
Fügen Sie die folgende Abhängigkeit mit den neuesten Versionen desDT Exchange SDK und des Adapters in die Datei pubspec.yaml
des Pakets ein:
dependencies:
gma_mediation_dtexchange: ^1.0.0
Manuelle Integration
Laden Sie die neueste Version des Google Mobile Ads-Vermittlungs-Plug-ins für DT Exchange herunter, extrahieren Sie die heruntergeladene Datei und fügen Sie den extrahierten Plug-in-Ordner (und seinen Inhalt) dem Flutter-Projekt hinzu. Verweisen Sie dann in der Datei pubspec.yaml
auf das Plug-in. Fügen Sie dazu die folgende Abhängigkeit hinzu:
dependencies:
gma_mediation_dtexchange:
path: path/to/local/package
Schritt 4: Datenschutzeinstellungen im DT Exchange SDK implementieren
EU-Einwilligung 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.
Das Vermittlungs-Plug-in von Google Mobile Ads für DT Exchange unterstützt nicht die Weitergabe von Einwilligungsinformationen an das DT Exchange SDK.
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.
Das Vermittlungs-Plug-in von Google Mobile Ads für DT Exchange unterstützt nicht die Weitergabe von Einwilligungsinformationen an das DT Exchange SDK.
Schritt 5: Erforderlichen Code hinzufügen
Android
Für die DT Exchange-Integration ist kein zusätzlicher Code erforderlich.
iOS
SKAdNetwork-Integration
Folgen Sie der Dokumentation von DT Exchange, um die SKAdNetwork-Kennungen in die Info.plist
-Datei Ihres Projekts einzufügen.
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.
Fehlercodes
Wenn der Adapter keine Anzeige von DT Exchange empfängt, können Publisher den zugrunde liegenden Fehler aus der Anzeigenantwort mithilfe von ResponseInfo
in der folgenden Klasse überprüfen:
Android
com.google.ads.mediation.fyber.FyberMediationAdapter
iOS
GADMediationAdapterFyber
Dies sind die Codes und Begleitmeldungen, die vom DT Exchange-Adapter ausgegeben werden, wenn eine Anzeige nicht geladen werden kann:
Android
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. |
iOS
Fehlercode | Grund |
---|---|
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. |
1.0.0
- Erste Version
- Bestätigte Kompatibilität mit DT Exchange Android Adapter Version 8.2.6.1
- Bestätigte Kompatibilität mit DT Exchange iOS Adapter Version 8.2.7.0