Chartboost in die Vermittlung einbinden

Plattform auswählen: Android iOS Unity Flutter Android (Legacy)

In dieser Anleitung erfahren Sie, wie Sie mit Google Mobile Ads Unity Plugin Anzeigen von Chartboost mithilfe der Vermittlung laden und präsentieren. Dabei werden auch Abfolgeintegrationen behandelt. Darin wird beschrieben, wie Sie Chartboost der Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und das Chartboost SDK und den Adapter in eine Unity-App einbinden.

Unterstützte Integrationen und Anzeigenformate

Der Ad Manager-Vermittlungsadapter für Chartboost bietet die folgenden Funktionen:

Integration
Gebote
Vermittlungsabfolge
Formate
App öffnen
Banner
Interstitial
Verfügbar
Interstitial mit Prämie
Nativ

Vorbereitung

Prüfen Sie vor dem Fortfahren Folgendes:

  • Aktuelle Google Mobile Ads Unity Plugin-Version.
  • Unity Editor-Version 2019.4 oder höher
  • Für die Bereitstellung auf Android-Geräten
    • Android API-Level 24 oder höher
  • Für die Bereitstellung auf iOS
    • Das iOS-Bereitstellungsziel muss 13.0 oder höher sein.
  • Ein funktionierendes Unity-Projekt, das mit Google Mobile Ads Unity Plugin konfiguriert ist. Weitere Informationen finden Sie unter Google Mobile Ads Unity Plugin einrichten.
  • Vermittlung einrichten

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

    Chartboost-App-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 App hinzufügen, um die App fertigzustellen.

    Formular für neue App

    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

    App-Einstellungen

    iOS

    App-Einstellungen

    Für die Einrichtung Ihrer Ad Manager-Anzeigenblock-ID benötigen Sie die Nutzer-ID und die Nutzer-Signatur von Chartboost. Diese Parameter finden Sie, wenn Sie in der Chartboost-Benutzeroberfläche auf Chartboost mediation klicken.

    Chartboost Mediation-Dashboard

    Rufen Sie den Tab Ressourcen > APIs Explorer auf und notieren Sie sich Ihre Nutzer-ID und Ihre Nutzersignatur im Abschnitt Authentifizierung.

    Chartboost API Explorer

    app-ads.txt-Datei aktualisieren

    Authorized Sellers for Apps (app-ads.txt) ist eine Initiative des IAB Tech Lab, die dafür sorgt, dass Ihr App-Anzeigeninventar nur über Kanäle verkauft wird, die Sie autorisiert haben. Um einen erheblichen Rückgang des Anzeigenumsatzes zu vermeiden, müssen Sie eine app-ads.txt-Datei implementieren. Falls noch nicht geschehen, erstellen Sie eine app-ads.txt-Datei für Ad Manager.

    Informationen zum Implementieren von app-ads.txt für Chartboost finden Sie unter app-ads.txt.

    Testmodus aktivieren

    Sie können den Testmodus für Ihre App aktivieren, indem Sie in der Chartboost-Benutzeroberfläche den Tab Apps management (App-Verwaltung) aufrufen, Ihre App aus der Liste auswählen und auf Edit app settings (App-Einstellungen bearbeiten) klicken.

    Android

    App-Einstellungen bearbeiten

    iOS

    App-Einstellungen bearbeiten

    In den Einstellungen Ihrer App können Sie den Testmodus aktivieren.

    Chartboost-Testmodus

    Sobald der Testmodus aktiviert ist, können Sie Anzeigen mit der zuvor erstellten Anzeigenblock-ID anfordern und eine Chartboost-Testanzeige erhalten.

    Sobald Sie Chartboost-Testanzeigen empfangen können, wird Ihre App in die Publisher App Review von Chartboost aufgenommen. Damit die Monetarisierung auf Chartboost funktioniert, muss die Überprüfung der Publisher-App von Chartboost genehmigt werden.

    Schritt 2: Chartboost-Nachfrage in der Ad Manager-Benutzeroberfläche einrichten

    Vermittlungseinstellungen für Ihren Anzeigenblock konfigurieren

    Android

    Eine Anleitung finden Sie in Schritt 2 des Leitfadens für Android.

    iOS

    Eine Anleitung finden Sie in Schritt 2 des Leitfadens für iOS.

    Chartboost zur Liste der Werbepartner für die DSGVO und die Bestimmungen von US-Bundesstaaten hinzufügen

    Folgen Sie der Anleitung unter Einstellungen für europäische Verordnungen und Einstellungen für Verordnungen von US-Bundesstaaten, um Chartboost in der Ad Manager-Benutzeroberfläche der Liste der Werbepartner für europäische Verordnungen und Verordnungen von US-Bundesstaaten hinzuzufügen.

    Schritt 3: Chartboost SDK und Adapter importieren

    OpenUPM-CLI

    Wenn Sie OpenUPM-CLI installiert haben, können Sie das Google Mobile Ads Chartboost Vermittlungs-Plug-in für Unity in Ihrem Projekt installieren. Führen Sie dazu den folgenden Befehl im Stammverzeichnis Ihres Projekts aus:

    openupm add com.google.ads.mobile.mediation.chartboost

    OpenUPM

    Wählen Sie im Unity-Projekt-Editor Bearbeiten > Projekteinstellungen > Paketmanager aus, um die Einstellungen für den Unity-Paketmanager zu öffnen.

    Fügen Sie auf dem Tab Scoped Registries OpenUPM als bereichsbezogene Registry mit den folgenden Details hinzu:

    • Name: OpenUPM
    • URL: https://package.openupm.com
    • Bereich(e): com.google

    OpenUPM-Details

    Gehen Sie dann zu Window > Package Manager, um den Unity Package Manager zu öffnen, und wählen Sie im Drop-down-Menü My Registries aus.

    Unity-Registries

    Wählen Sie das Paket Google Mobile Ads Chartboost Mediation aus und klicken Sie auf Installieren.

    Über OpenUPM installieren

    Unity-Paket

    Laden Sie die aktuelle Version des Google Mobile Ads-Vermittlungs-Plug-ins für Chartboost über den Downloadlink im Changelog herunter und extrahieren Sie die GoogleMobileAdsChartboostMediation.unitypackage aus der ZIP-Datei.

    Wählen Sie im Unity-Projekteditor Assets > Import Package > Custom Package aus und suchen Sie die heruntergeladene GoogleMobileAdsChartboostMediation.unitypackage-Datei. Achten Sie darauf, dass alle Dateien ausgewählt sind, und klicken Sie auf Importieren.

    Aus Unity importieren

    Wählen Sie dann Assets > External Dependency Manager > Android Resolver > Force Resolve aus. Die Bibliothek „External Dependency Manager“ führt die Abhängigkeitsauflösung von Grund auf neu durch und kopiert die deklarierten Abhängigkeiten in das Verzeichnis Assets/Plugins/Android Ihrer Unity-App.

    Lösung erzwingen

    Schritt 4: Datenschutzeinstellungen im Chartboost SDK implementieren

    Gemäß der Google-Richtlinie zur Einwilligung der Nutzer in der EU müssen Sie Ihren Nutzern im Europäischen Wirtschaftsraum (EWR), im Vereinigten Königreich und in der Schweiz bestimmte Informationen offenlegen und ihre Einwilligung zur Verwendung von Cookies oder anderen lokalen Speicherverfahren einholen, sofern dies gesetzlich vorgeschrieben ist. Außerdem müssen Sie ihre Einwilligung zur Erhebung, Weitergabe und Verwendung personenbezogener Daten für personalisierte Anzeigen einholen. Die Richtlinie entspricht den Anforderungen der EU-Datenschutzrichtlinie für elektronische Kommunikation und der EU-Datenschutz-Grundverordnung (DSGVO). Sie sind dafür verantwortlich, dass die Einwilligung an jede Anzeigenquelle in Ihrer Vermittlungskette weitergegeben wird.

    Datenschutzgesetze von US-Bundesstaaten

    Datenschutzgesetze von US-Bundesstaaten schreiben vor, dass Nutzern das Recht eingeräumt werden muss, dem „Verkauf“ ihrer „personenbezogenen Daten“ zu widersprechen (laut gesetzlicher Definition der Begriffe „sale“ und „personal information“). Dazu muss auf der Website des „Verkäufers“ (selling party) ein gut sichtbarer Link mit dem Text „Do Not Sell My Personal Information“ (Meine personenbezogenen Daten dürfen nicht verkauft werden) vorhanden sein. Im Leitfaden zur Einhaltung der Datenschutzgesetze von US-Bundesstaaten wird beschrieben, wie Sie die eingeschränkte Datenverarbeitung für die Anzeigenbereitstellung von Google aktivieren. Google kann diese Einstellung jedoch nicht auf jedes Werbenetzwerk in Ihrer Vermittlungskette anwenden. Daher müssen Sie jedes Werbenetzwerk in Ihrer Vermittlungskette identifizieren, das am Verkauf personenbezogener Daten beteiligt sein könnte, und die Richtlinien der einzelnen Netzwerke befolgen, um die Einhaltung der Bestimmungen zu gewährleisten.

    Im folgenden Beispielcode wird die Einwilligung zur Datennutzung auf OptInSale festgelegt. Wenn Sie diese Methode aufrufen, sollten Sie dies tun, bevor Sie Anzeigen mit Google Mobile Ads Unity Plugin 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 der Dokumentation von Chartboost, um die SKAdNetwork-IDs in die Info.plist-Datei Ihres Projekts einzufü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 prüfen

    Wenn Sie prüfen möchten, ob Sie Testanzeigen von Chartboost erhalten, aktivieren Sie im Anzeigenprüftool die Tests für einzelne Anzeigenquellen und verwenden Sie die Anzeigenquelle (n) Chartboost(Vermittlungsabfolge).

    Optionale Schritte

    Android

    Berechtigungen

    Für eine optimale Leistung empfiehlt Chartboost, die folgenden optionalen Berechtigungen in die AndroidManifest.xml-Datei Ihrer App aufzunehmen:

    <uses-permission android:name="android.permission.READ_PHONE_STATE" />

    iOS

    Für die iOS-Integration sind keine zusätzlichen Schritte erforderlich.

    Fehlercodes

    Wenn der Adapter keine Anzeige von Chartboost erhält, können Publisher den zugrunde liegenden Fehler aus der Anzeigenantwort mit ResponseInfo unter den folgenden Klassen prüfen:

    Android

    com.google.ads.mediation.chartboost.ChartboostAdapter
com.google.ads.mediation.chartboost.ChartboostMediationAdapter

    iOS

    GADMAdapterChartboost
GADMediationAdapterChartboost

    Hier sind die Codes und die 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 entspricht keiner von Chartboost unterstützten Bannergröße.
    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 -Anzeige mit Prämie ist 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 ist zum Zeitpunkt der Auslieferung nicht im Cache gespeichert.
    104 Die angeforderte Anzeigengröße entspricht keiner von Chartboost unterstützten Bannergröße.
    105 Die Betriebssystemversion des Geräts ist niedriger als die vom Chartboost SDK unterstützte Mindestversion des Betriebssystems.
    200-299 Chartboost SDK-Cache-Fehler. Weitere Informationen finden Sie im Code.
    300-399 Chartboost SDK-Anzeigefehler. Weitere Informationen finden Sie im Code.
    400-499 Chartboost SDK-Klickfehler. Weitere Informationen finden Sie im Code.

    Änderungsprotokoll für das Chartboost Unity Mediation-Plug-in

    Version 4.15.2 (in Arbeit)

    Version 4.15.1

    Version 4.15.0

    Version 4.14.0

    Version 4.13.0

    Version 4.12.1

    Version 4.12.0

    Version 4.11.3

    Version 4.11.2

    Version 4.11.1

    Version 4.11.0

    Version 4.10.3

    Version 4.10.2

    Version 4.10.1

    Version 4.10.0

    Version 4.9.3

    Version 4.9.2

    Version 4.9.1

    Version 4.9.0

    Version 4.8.0

    Version 4.7.3

    Version 4.7.2

    Version 4.7.1

    Version 4.7.0

    Version 4.6.1

    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ützung der Chartboost Android-Adapterversion 7.5.0.0
    • Unterstützt die Chartboost iOS-Adapterversion 8.0.1.1.

    Version 1.3.0

    • Das Plug-in wurde aktualisiert, um die neue API für Anzeigen mit Prämie zu unterstützen.
    • Unterstützt den Chartboost-Android-Adapter in Version 7.3.1.1.
    • Unterstützt den Chartboost iOS-Adapter in Version 7.5.0.0.

    Version 1.2.0

    • Unterstützt die Version 7.3.0.0 des Chartboost-Android-Adapters.
    • Unterstützt die Chartboost iOS-Adapterversion 7.3.0.0.

    Version 1.1.1

    • Unterstützt Chartboost Android-Adapterversion 7.2.0.1.
    • Unterstützt die Chartboost iOS-Adapterversion 7.2.0.1.

    Version 1.1.0

    • Unterstützt das Chartboost Android SDK 7.2.0.
    • Unterstützt das Chartboost iOS SDK, Version 7.2.0.
    • Die Chartboost.RestrictDataCollection()-Methode wurde hinzugefügt, um Einschränkungen bei der Datenerhebung gemäß DSGVO für das Chartboost SDK zu ermöglichen.

    Version 1.0.0

    • Erster Release!
    • Unterstützt Chartboost Android SDK-Version 7.0.1.
    • Unterstützt das Chartboost iOS SDK Version 7.1.2.