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 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
- 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
注册 Chartboost 账号,并在账号通过验证后登录。 然后,转到应用管理标签页。
点击 Add new app 按钮创建应用。
填写表单的其余部分,然后点击 Add App(添加应用)按钮,完成应用。
创建应用后,系统会将您定向到该应用的信息中心。记下应用的应用 ID 和应用签名。
Android
iOS
AdMob 需要 Chartboost 用户 ID 和用户签名,用于设置您的 AdMob 广告单元 ID。您可以通过点击 Chartboost 界面中的 Chartboost 中介找到这些参数。
转到资源 > API Explorer 标签页,并记下身份验证部分下的用户 ID 和用户签名。
开启测试模式
您可以为应用启用测试模式,方法是从 Chartboost 界面中转到应用管理标签页,从列表中选择您的应用,然后点击 Edit app settings(修改应用设置)。
Android
iOS
在应用的设置中,您可以开启/关闭应用的测试模式。
启用测试模式后,您可以使用之前创建的广告单元 ID 请求广告,并接收 Chartboost 测试广告。
在您能够收到 Chartboost 测试广告后,您的应用将会参与 Chartboost 的 Publisher App Review 审核。为了确保 Chartboost 能够正常使用创收功能,发布商应用审核需要获得 Chartboost 的批准。
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
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 AdMob 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 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.
- 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.