In diesem Leitfaden erfahren Sie, wie Sie mit dem Google Mobile Ads SDK Anzeigen von Chartboost mithilfe der Vermittlung zur Einbindung von Vermittlungsabfolgen. Sie erfahren, wie Sie Chartboost zum Vermittlungskonfiguration und Integration des Chartboost SDK und des Adapters in eine Unity-App integriert.
Unterstützte Integrationen und Anzeigenformate
Der AdMob 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
<ph type="x-smartling-placeholder">
- </ph>
- Android API-Level 21 oder höher
- Auf iOS-Geräten bereitstellen
<ph type="x-smartling-placeholder">
- </ph>
- 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 Melde dich an, nachdem dein 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 App hinzufügen, um den Vorgang abzuschließen.
Nachdem Ihre App erstellt wurde, werden Sie zum zugehörigen Dashboard weitergeleitet. Achten Sie auf App-ID und App-Signatur der App
Android
iOS
Für AdMob sind die Nutzer-ID von Chartboost und die Nutzersignatur zur Einrichtung Ihrer AdMob-Anzeige Einheits-ID. Sie finden diese Parameter, indem Sie auf Chartboost-Vermittlung der Chartboost-Benutzeroberfläche.
Rufen Sie den Tab Ressourcen > API Explorer und notieren Sie sich Ihre User ID (Nutzer-ID) und User Signature (Nutzersignatur) im Abschnitt Authentication (Authentifizierung).
Testmodus aktivieren
Sie können den Testmodus für Ihre App aktivieren, indem Sie die App-Verwaltung aufrufen auf der Chartboost-Benutzeroberfläche, wählen Sie Ihre App in der Liste aus und klicken Sie auf App-Einstellungen bearbeiten
Android
iOS
In den App-Einstellungen können Sie den Testmodus aktivieren und deaktivieren.
Sobald der Testmodus aktiviert ist, können Sie mit der erstellten Anzeigenblock-ID Anzeigen anfordern. und eine Chartboost-Testanzeige erhalten.
Sobald Sie Chartboost-Testanzeigen erhalten können, wird Ihre App in der App Review des Publishers von Chartboost Damit die Monetarisierung in Chartboost funktioniert, wird die Publisher-App-Überprüfung müssen von Chartboost genehmigt werden.
Schritt 2: Chartboost-Nachfrage in der AdMob 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
Schritt 3: Chartboost SDK und Adapter importieren
OpenUPM-CLI
Wenn Sie OpenUPM-CLI haben Google Mobile Ads Chartboost Vermittlungs-Plug-in für Unity mit dem folgenden Befehl verknüpfen aus dem Stammverzeichnis Ihres Projekts:
openupm add com.google.ads.mobile.mediation.chartboost
OpenUPM
Wählen Sie im Unity-Projekteditor Bearbeiten > Projekteinstellungen > Paketmanager, um die Unity Package Manager-Einstellungen.
Fügen Sie auf dem Tab Scoped Registries OpenUPM als Bereichs-Registry hinzu. die folgenden Details:
- Name:
OpenUPM
- URL:
https://package.openupm.com
- Zugriffsbereiche:
com.google
Gehen Sie dann zu Fenster > Paketmanager, um die Unity Package Manager und Wählen Sie im Drop-down-Menü My Registries (Meine Registrys) aus.
Wählen Sie das Google Mobile Ads Chartboost Mediation-Paket aus. Klicken Sie auf Installieren.
Unity-Paket
Neueste Version des Google Mobile Ads Mediation-Plug-ins für herunterladen
Chartboost über den Download-Link in
die
Änderungsprotokoll
und extrahieren Sie die
GoogleMobileAdsChartboostMediation.unitypackage
aus der ZIP-Datei
-Datei.
Wählen Sie im Unity-Projekteditor Assets aus. Paket importieren >
Benutzerdefiniertes Paket und suchen Sie
GoogleMobileAdsChartboostMediation.unitypackage
die Sie heruntergeladen haben. Wählen Sie alle Dateien aus und klicken Sie auf
Importieren:
Wähle dann Assets > Play Services-Resolver >
Android-Resolver > Auflösung erzwingen. Der Unity Play-Dienste-Resolver
die Abhängigkeitsauflösung von Grund auf neu durchführt und die
deklarierten Abhängigkeiten im Verzeichnis Assets/Plugins/Android
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 automatisch an solche Werbenetzwerke übergeben wird.
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 dieser Nutzungsbedingungen), wobei die Widerspruchsmöglichkeit über einen gut sichtbaren "Do Not Sell My Personal"-Artikel 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 AdMob 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 AdMob 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 AdMob 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.
- Mit dem Google Mobile Ads Unity Plugin Version 7.3.0 erstellt und getestet.
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, um die neue Reward API zu unterstützen.
- 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()
zum Aktivieren von Einschränkungen der DSGVO-Datenerhebung für das Chartboost SDK wurde hinzugefügt.
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.