Chartboost in die Vermittlung einbinden

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.

Chartboost Apps-Dashboard

Klicken Sie auf die Schaltfläche Neue App hinzufügen, um Ihre App zu erstellen.

App-Verwaltung

Füllen Sie den Rest des Formulars aus und klicken Sie auf die Schaltfläche App hinzufügen, um den Vorgang abzuschließen.

Neues App-Formular

Nachdem Ihre App erstellt wurde, werden Sie zum zugehörigen Dashboard weitergeleitet. Achten Sie auf App-ID und App-Signatur der App

Android

App-Einstellungen

iOS

App-Einstellungen

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.

Chartboost-Vermittlungs-Dashboard

Rufen Sie den Tab Ressourcen > API Explorer und notieren Sie sich Ihre User ID (Nutzer-ID) und User Signature (Nutzersignatur) im Abschnitt Authentication (Authentifizierung).

Chartboost API Explorer

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

App-Einstellungen bearbeiten

iOS

App-Einstellungen bearbeiten

In den App-Einstellungen können Sie den Testmodus aktivieren und deaktivieren.

Chartboost-Testmodus

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

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

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

Details zu OpenUPM

Gehen Sie dann zu Fenster > Paketmanager, um die Unity Package Manager und Wählen Sie im Drop-down-Menü My Registries (Meine Registrys) aus.

Unity-Registries

Wählen Sie das Google Mobile Ads Chartboost Mediation-Paket aus. Klicken Sie auf Installieren.

Von OpenUPM 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:

Von Unity 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.

Auflösung erzwingen

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 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 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, 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.