Chartboost in die Vermittlung einbinden

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 账号,并在账号通过验证后登录。 然后,转到应用管理标签页。

Chartboost 应用信息中心

点击 Add new app 按钮创建应用。

应用管理

填写表单的其余部分,然后点击 Add App(添加应用)按钮,完成应用。

新建应用表单

创建应用后,系统会将您定向到该应用的信息中心。记下应用的应用 ID应用签名

Android

应用设置

iOS

应用设置

AdMob 需要 Chartboost 用户 ID用户签名,用于设置您的 AdMob 广告单元 ID。您可以通过点击 Chartboost 界面中的 Chartboost 中介找到这些参数。

Chartboost 中介信息中心

转到资源 > API Explorer 标签页,并记下身份验证部分下的用户 ID用户签名

Chartboost API Explorer

开启测试模式

您可以为应用启用测试模式,方法是从 Chartboost 界面中转到应用管理标签页,从列表中选择您的应用,然后点击 Edit app settings(修改应用设置)。

Android

修改应用设置

iOS

修改应用设置

在应用的设置中,您可以开启/关闭应用的测试模式

Chartboost 测试模式

启用测试模式后,您可以使用之前创建的广告单元 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

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 in PlaceholderClient umbenannt.

Version 4.6.0

Version 4.5.0

Version 4.4.0

Version 4.3.0

Version 4.2.0

Version 4.1.1

Version 4.1.0

Version 4.0.0

Version 3.5.1

Version 3.5.0

Version 3.4.1

Version 3.4.0

Version 3.3.1

Version 3.3.0

Version 3.2.0

Version 3.1.0

Version 3.0.1

Version 3.0.0

Version 2.0.1

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.