In diesem Leitfaden erfahren Sie, wie Sie mit dem Google Mobile Ads SDK Anzeigen von Chartboost mithilfe der Vermittlung mit Vermittlungsabfolgen. Sie erfahren, wie Sie Chartboost zur Vermittlungskonfiguration und Integration des Chartboost SDK und des Adapters in eine Unity-App integriert.
Unterstützte Integrationen und Anzeigenformate
Der Ad Manager Vermittlungsadapter für Chartboost hat die folgende Funktionen:
Integration | |
---|---|
Gebote | |
Wasserfall | |
Formate | |
Banner | |
Interstitial | |
Verfügbar |
Voraussetzungen
- Unity 4 oder höher
- Neuestes Google Mobile Ads SDK
- Auf Android-Geräten bereitstellen
- Android API-Level 21 oder höher
- Auf iOS-Geräten bereitstellen
- iOS-Bereitstellungsziel von 12.0 oder höher
- Ein funktionierendes Unity-Projekt, das mit dem Google Mobile Ads SDK konfiguriert wurde Weitere Informationen finden Sie unter Weitere Informationen
- Vermittlung abschließen Startleitfaden
Schritt 1: Konfigurationen in der Chartboost-Benutzeroberfläche einrichten
Registrieren Sie sich für ein Chartboost-Konto und melden Sie sich an, sobald Ihr Konto bestätigt wurde. Gehen Sie dann zum Tab App-Verwaltung.
Klicken Sie auf die Schaltfläche Neue App hinzufügen, um Ihre App zu erstellen.
Füllen Sie den Rest des Formulars aus und klicken Sie auf die Schaltfläche Add App (App hinzufügen), um Ihre Anwendung fertigzustellen.
Nachdem Ihre App erstellt wurde, werden Sie zum zugehörigen Dashboard weitergeleitet. Notieren Sie sich die App-ID und die App-Signatur Ihrer App.
Android
iOS
Ad Manager erfordert die User-ID und die Nutzersignatur von Chartboost zum Einrichten der Ad Manager Anzeigenblock-ID. Klicken Sie zum Aufrufen dieser Parameter in der Chartboost-Benutzeroberfläche auf Chartboost-Vermittlung.
Wechseln Sie zum Tab Ressourcen > API Explorer und notieren Sie sich im Abschnitt Authentifizierung Ihre Nutzer-ID und Ihre Nutzersignatur.
Testmodus aktivieren
Sie können den Testmodus für Ihre App aktivieren. Rufen Sie dazu über die Chartboost-Benutzeroberfläche den Tab Apps-Verwaltung auf, wählen Sie Ihre App aus der Liste aus und klicken Sie auf App-Einstellungen bearbeiten.
Android
iOS
In den Einstellungen Ihrer App können Sie den Testmodus ein-/ausschalten.
Sobald der Testmodus aktiviert ist, können Sie Anzeigen mit der zuvor erstellten Anzeigenblock-ID anfordern und eine Chartboost-Testanzeige erhalten.
Sobald Sie die Testanzeigen von Chartboost erhalten haben, wird Ihre App in die App-Überprüfung für Publisher von Chartboost aufgenommen. Damit die Monetarisierung auf Chartboost funktioniert, muss die App-Überprüfung durch Publisher von Chartboost genehmigt werden.
Schritt 2: Chartboost-Nachfrage in 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.
Chartboost der Liste der Werbepartner zur DSGVO und zu Bestimmungen von US-Bundesstaaten hinzufügen
Folgen Sie den Schritten unter DSGVO-Einstellungen und Einstellungen zu Bestimmungen von US-Bundesstaaten um Chartboost in die Liste der Werbepartner gemäß DSGVO und US-Bundesstaaten auf der Ad Manager Benutzeroberfläche aufzunehmen.
Schritt 3: Chartboost SDK und Adapter importieren
Aktuelle Version des Google Mobile Ads-Vermittlungs-Plug-ins für Chartboost herunterladen
über den Download-Link im
Änderungsprotokoll und Extrahierung
GoogleMobileAdsChartboostMediation.unitypackage
aus der ZIP-Datei.
Wählen Sie im Unity-Projekteditor Assets > Paket importieren >
Benutzerdefiniertes Paket und suchen Sie die GoogleMobileAdsChartboostMediation.unitypackage
.
die Sie heruntergeladen haben. Wählen Sie alle Dateien aus und klicken Sie auf
Importieren:
Wählen Sie dann Assets > Play-Dienste-Resolver > Android-Resolver >
„Auflösung erzwingen“. Die Unity Play Services Resolver-Bibliothek führt
Abhängigkeiten von Grund auf neu auflösen und die deklarierten Abhängigkeiten in den
Assets/Plugins/Android
-Verzeichnis Ihrer Unity-App.
Schritt 4: Datenschutzeinstellungen im Chartboost SDK implementieren
Einwilligung der Nutzer in der EU und DSGVO
Gemäß der Google-Einwilligung der Nutzer in der EU den Richtlinien entsprechen, müssen Sie sicherstellen, dass bestimmte Personen Einwilligungen von Nutzern im Europäischen Wirtschaftsraum (EWR) bezüglich die Verwendung von Gerätekennungen und personenbezogenen Daten. Diese Richtlinie entspricht den der EU-Datenschutzrichtlinie für elektronische Kommunikation und der EU-Datenschutz-Grundverordnung Verordnung (DSGVO) aufgeführt. Beim Einholen der Einwilligung müssen Sie jedes Werbenetzwerk angeben in Ihrer Vermittlungskette, die personenbezogene Daten erheben, erhalten oder nutzen, Informationen zur Nutzung der einzelnen Werbenetzwerke enthalten. Google kann derzeit nicht wird die Einwilligungsentscheidung des Nutzers automatisch an diese Netzwerke übergeben.
Version 3.1.0 des Google Mobile Ads-Vermittlungs-Plug-ins für Chartboost Version
Chartboost.AddDataUseConsent()
-Methode. Der folgende Beispielcode legt die Datennutzung fest.
Einwilligung zu NonBehavioral
. Wenn Sie diese Methode aufrufen,
bevor Sie Anzeigen über das Google Mobile Ads SDK anfordern.
using GoogleMobileAds.Api.Mediation.Chartboost;
// ...
Chartboost.AddDataUseConsent(CBGDPRDataUseConsent.NonBehavioral);
Datenschutzgesetze von US-Bundesstaaten
USA Datenschutzgesetze von Bundesstaaten müssen Sie Nutzern das Angebot des Angebots ihrer "personenbezogenen Daten" (wie das Gesetz definiert der vorliegenden Nutzungsbedingungen), wobei die Widerspruchsmöglichkeit über die deutlich sichtbare „Do Not Sell My Personal“- Informationen“ auf den Link „Verkauf“ die Startseite der Party. Die USA Datenschutz für Bundesstaaten Leitfaden zur Einhaltung gesetzlicher Vorschriften die Möglichkeit, eingeschränkte Datenverarbeitung für die Anzeigenbereitstellung durch Google, aber Google kann diese Einstellung nicht auf jede Anzeige anwenden Netzwerk in Ihrer Vermittlungskette. Daher müssen Sie jedes Werbenetzwerk, Vermittlungskette, die am Verkauf von persönlichen und folgen den Leitlinien der einzelnen Netzwerke, um sicherzustellen, Compliance.
Version 3.1.0 des Google Mobile Ads-Vermittlungs-Plug-ins für Chartboost Version
Chartboost.AddDataUseConsent()
-Methode. Der folgende Beispielcode legt die Datennutzung fest.
Einwilligung zu OptInSale
. Wenn Sie diese Methode aufrufen,
bevor Sie Anzeigen über das Google Mobile Ads SDK anfordern.
using GoogleMobileAds.Api.Mediation.Chartboost;
// ...
Chartboost.AddDataUseConsent(CBCCPADataUseConsent.OptInSale);
Schritt 5: Erforderlichen Code hinzufügen
Android
Für die Chartboost-Integration ist kein zusätzlicher Code erforderlich.
iOS
SKAdNetwork-Integration
Folgen Sie Chartboost's
Dokumentation
um die SKAdNetwork-IDs zur Info.plist
-Datei Ihres Projekts hinzuzufügen.
Schritt 6: Implementierung testen
Testanzeigen aktivieren
Registrieren Sie Ihr Testgerät für Ad Manager und aktivieren Sie den Testmodus in der Chartboost Benutzeroberfläche.
Testanzeigen überprüfen
Wenn Sie prüfen möchten, ob Sie Testanzeigen vonChartboosterhalten, aktivieren Sie im Anzeigenprüftool mithilfe der Chartboost (Waterfall) Anzeigenquellen den Test für eine einzelne Anzeigenquelle.
Optionale Schritte
Android
Berechtigungen
Für eine optimale Leistung empfiehlt Chartboost, dass Sie die folgenden optionalen
Berechtigungen für die AndroidManifest.xml
-Datei deiner App:
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
iOS
Für die iOS-Integration sind keine weiteren Schritte erforderlich.
Fehlercodes
Wenn der Adapter keine Anzeige von Chartboost erhält,
Publisher können den zugrunde liegenden Fehler der Anzeigenantwort mit
ResponseInfo
in den folgenden Klassen:
Android
com.google.ads.mediation.chartboost.ChartboostAdapter
com.google.ads.mediation.chartboost.ChartboostMediationAdapter
iOS
GADMAdapterChartboost
GADMediationAdapterChartboost
Dies sind die Codes und zugehörigen Meldungen, die vom Chartboost-Adapter ausgegeben werden, wenn eine Anzeige nicht geladen werden kann:
Android
Fehlercode | Grund |
---|---|
0-99 | Das Chartboost SDK hat einen Fehler zurückgegeben. |
101 | Die angeforderte Anzeigengröße stimmt nicht mit einer von Chartboost unterstützten Bannergröße überein. |
102 | Chartboost kann jeweils nur eine Anzeige pro Standort laden. |
103 | Die in der Ad Manager Benutzeroberfläche konfigurierten Chartboost-Serverparameter fehlen oder sind ungültig. |
104 | Die Chartboost-Interstitial-Anzeige oder die Chartboost-Anzeige mit Prämie ist noch nicht zur Auslieferung bereit. |
iOS
Fehlercode | Grund |
---|---|
101 | Die in der Ad Manager Benutzeroberfläche konfigurierten Chartboost-Serverparameter fehlen oder sind ungültig. |
102 | Das Chartboost SDK hat einen Initialisierungsfehler zurückgegeben. |
103 | Die Chartboost-Anzeige wird zum Zeitpunkt der Auslieferung nicht im Cache gespeichert. |
104 | Die angeforderte Anzeigengröße stimmt nicht mit einer von Chartboost unterstützten Bannergröße überein. |
105 | Die Betriebssystemversion des Geräts ist niedriger als die mindestens unterstützte Betriebssystemversion des Chartboost SDK. |
200-299 | Cache-Fehler des Chartboost SDK Siehe Code . |
300-399 | Im Chartboost SDK werden Fehler angezeigt. Siehe Code . |
400-499 | Chartboost SDK-Klickfehler Siehe Code . |
Änderungsprotokoll für das Chartboost Unity-Vermittlungs-Plug-in
Nächste Version
DummyClient
wurde inPlaceholderClient
umbenannt.
Version 4.6.0
- Unterstützt die Chartboost Android-Adapterversion 9.7.0.0.
- Unterstützt die Chartboost iOS-Adapterversion 9.7.0.0.
- Mit dem Google Mobile Ads Unity Plugin Version 9.0.0 erstellt und getestet.
Version 4.5.0
- Unterstützt die Chartboost Android-Adapterversion 9.6.0.0.
- Unterstützt die Chartboost iOS-Adapterversion 9.6.0.0.
- Mit dem Google Mobile Ads Unity Plugin Version 8.6.0 erstellt und getestet.
Version 4.4.0
- Unterstützt die Chartboost Android-Adapterversion 9.5.0.0.
- Unterstützt die Chartboost iOS-Adapterversion 9.5.1.0.
- Erstellt und getestet mit dem Google Mobile Ads Unity Plugin Version 8.5.3.
Version 4.3.0
- Unterstützt die Chartboost Android-Adapterversion 9.4.0.0.
- Unterstützt die Chartboost iOS-Adapterversion 9.4.0.0.
- Mit dem Google Mobile Ads Unity Plugin Version 8.5.0 erstellt und getestet.
Version 4.2.0
- Unterstützt die Chartboost Android-Adapterversion 9.3.0.0.
- Unterstützt die Chartboost iOS-Adapterversion 9.3.0.0.
- Mit dem Google Mobile Ads Unity Plugin Version 8.2.0 erstellt und getestet.
Version 4.1.1
- Adapterinhalt wurde nach
GoogleMobileAds/Mediation/Chartboost/
verschoben. - Adapter-Namespace zur Verwendung von
GoogleMobileAds.Mediation.Chartboost
überarbeitet. - Unterstützt die Chartboost Android-Adapterversion 9.2.1.1.
- Unterstützt die Chartboost iOS-Adapterversion 9.2.0.0.
- Mit dem Google Mobile Ads Unity Plugin Version 8.1.0 erstellt und getestet.
Version 4.1.0
- Unterstützt die Chartboost Android-Adapterversion 9.2.0.0.
- Unterstützt die Chartboost iOS-Adapterversion 9.2.0.0.
- Erstellt und getestet mit dem Google Mobile Ads Unity-Plug-in Version 7.4.1.
Version 4.0.0
- Unterstützt die Chartboost Android-Adapterversion 9.1.1.0.
- Unterstützt die Chartboost iOS-Adapterversion 9.1.0.0.
- Erstellt und getestet mit dem Google Mobile Ads Unity Plugin Version 7.3.0.
Version 3.5.1
- Unterstützt die Chartboost Android-Adapterversion 8.4.3.1.
- Unterstützt die Chartboost iOS-Adapterversion 8.5.0.2.
- Erstellt und getestet mit dem Google Mobile Ads Unity Plugin Version 7.0.2.
Version 3.5.0
- Unterstützt die Chartboost Android-Adapterversion 8.4.2.0.
- Unterstützt die Chartboost iOS-Adapterversion 8.5.0.2.
- Mit dem Google Mobile Ads Unity Plugin Version 7.0.0 erstellt und getestet.
Version 3.4.1
- Unterstützt die Chartboost Android-Adapterversion 8.3.1.0.
- Unterstützt die Chartboost iOS-Adapterversion 8.5.0.2.
- Mit dem Google Mobile Ads Unity Plugin Version 7.0.0 erstellt und getestet.
Version 3.4.0
- Unterstützt die Chartboost Android-Adapterversion 8.3.0.0.
- Unterstützt die Chartboost iOS-Adapterversion 8.5.0.1.0.
Version 3.3.1
- Unterstützt die Chartboost Android-Adapterversion 8.2.1.0.
- Unterstützt die Chartboost iOS-Adapterversion 8.4.1.1.
Version 3.3.0
- Unterstützt die Chartboost Android-Adapterversion 8.2.0.0.
- Unterstützt die Chartboost iOS-Adapterversion 8.4.0.0.
Version 3.2.0
- Unterstützt die Chartboost Android-Adapterversion 8.1.0.0.
- Unterstützt die Chartboost iOS-Adapterversion 8.3.1.0.
Version 3.1.0
- Die Methode
RestrictDataCollection()
wurde aus der KlasseChartboost
entfernt. AddDataUseConsent()
Hilfsmethoden zur Weitergabe von DSGVO- und CCPA-Informationen an Chartboost wurden hinzugefügt.- Unterstützt die Chartboost Android-Adapterversion 8.1.0.0.
- Unterstützt die Chartboost iOS-Adapterversion 8.2.0.0.
Version 3.0.1
- Unterstützt die Chartboost Android-Adapterversion 8.0.3.1.
- Unterstützt die Chartboost iOS-Adapterversion 8.1.0.1.
Version 3.0.0
- Unterstützt die Chartboost Android-Adapterversion 8.0.2.0.
- Unterstützt die Chartboost iOS-Adapterversion 8.1.0.0.
Version 2.0.1
- Unterstützt die Chartboost Android-Adapterversion 7.5.0.1.
- Unterstützt die Chartboost iOS-Adapterversion 8.0.4.0.
Version 2.0.0
- Unterstützt den Chartboost Android-Adapterversion 7.5.0.0.
- Unterstützt den Chartboost iOS-Adapterversion 8.0.1.1.
Version 1.3.0
- Das Plug-in wurde aktualisiert, damit die neue Reward API unterstützt wird.
- Unterstützt den Chartboost Android-Adapterversion 7.3.1.1.
- Unterstützt den Chartboost iOS-Adapterversion 7.5.0.0.
Version 1.2.0
- Unterstützt den Chartboost Android-Adapterversion 7.3.0.0.
- Unterstützt den Chartboost iOS-Adapterversion 7.3.0.0.
Version 1.1.1
- Unterstützt den Chartboost Android-Adapterversion 7.2.0.1.
- Unterstützt den Chartboost iOS-Adapterversion 7.2.0.1.
Version 1.1.0
- Unterstützt Chartboost Android SDK Version 7.2.0.
- Unterstützt Chartboost iOS SDK Version 7.2.0.
- Die Methode
Chartboost.RestrictDataCollection()
wurde hinzugefügt, um Einschränkungen für die DSGVO-Datenerfassung für das Chartboost SDK zu aktivieren.
Version 1.0.0
- Erste Veröffentlichung!
- Unterstützt Chartboost Android SDK Version 7.0.1.
- Unterstützt Chartboost iOS SDK Version 7.1.2.