Chartboost in die Vermittlung einbinden

Plattform auswählen: Android Neu Android iOS Unity Flutter

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

Unterstützte Integrationen und Anzeigenformate

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

Integration
Gebote
Vermittlungsabfolge
Formate
Banner
Interstitial
Verfügbar

Voraussetzungen

  • Aktuellstes Google Mobile Ads Flutter Plugin
  • Flutter 3.7.0 oder höher
  • Für die Bereitstellung auf Android-Geräten:
    • Android API-Level 23 oder höher
  • Für die Bereitstellung auf iOS-Geräten:
    • iOS-Bereitstellungsziel 13.0 oder höher
  • Ein funktionierendes Flutter-Projekt, das mit Google Mobile Ads Flutter Plugin konfiguriert wurde Weitere Informationen finden Sie unter Einrichten Google Mobile Ads Flutter Plugin.
  • AdMob Mediation 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 Apps management (App-Verwaltung).

Chartboost-App-Dashboard

Klicken Sie auf die Schaltfläche Add new app (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 Add App (App hinzufügen), um die App fertigzustellen.

Neues App-Formular

Nachdem Ihre App erstellt wurde, werden Sie zum 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 AdMob-Anzeigenblock-ID sind in AdMob die Nutzer-ID und die Nutzer-Signatur von Chartboost erforderlich. Sie finden diese Parameter in der Chartboost-Benutzeroberfläche, wenn Sie auf Chartboost mediation (Chartboost Mediation) klicken.

Chartboost Mediation-Dashboard

Gehen Sie zum Tab Resources > API Explorer (Ressourcen > API-Explorer) und notieren Sie sich Ihre Nutzer-ID und Nutzer-Signatur im Bereich Authentication (Authentifizierung).

Chartboost API Explorer

app-ads.txt-Datei aktualisieren

Authorized Sellers for Apps oder app-ads.txt ist eine IAB Tech Lab-Initiative, 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, richten Sie eine app-ads.txt-Datei für Ihre App ein.

Informationen zur Implementierung 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 zum Tab Apps management (App-Verwaltung) gehen, Ihre App in 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 für Ihre App aktivieren oder deaktivieren.

Chartboost-Testmodus

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

Nachdem Sie Chartboost-Testanzeigen erhalten können, wird Ihre App zur Überprüfung an Chartboost gesendet. Damit die Monetarisierung auf Chartboost funktioniert, muss die Überprüfung der Publisher-App von Chartboost genehmigt werden.

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

Vermittlungseinstellungen für Ihren Anzeigenblock konfigurieren

Android

Eine Anleitung finden Sie unter Schritt 2 in der Anleitung für Android.

iOS

Eine Anleitung finden Sie unter Schritt 2 in der Anleitung für iOS.

Chartboost der Liste der Werbepartner gemäß DSGVO und Verordnungen von US-Bundesstaaten hinzufügen

Folgen Sie der Anleitung unter Einstellungen gemäß EU-Verordnungen und Einstellungen gemäß Verordnungen von US-Bundesstaaten , um Chartboost der Liste der Werbepartner gemäß EU-Verordnungen und Verordnungen von US-Bundesstaaten in der AdMob-Benutzeroberfläche hinzuzufügen.

Schritt 3: Chartboost SDK und Adapter importieren

Integration über pub.dev

Fügen Sie der Datei pubspec.yaml Ihres Pakets die folgende Abhängigkeit mit den neuesten Versionen des Chartboost SDK und des Adapters hinzu:

dependencies:
  gma_mediation_chartboost: ^1.4.2

Manuelle Integration

Laden Sie die neueste Version des Google Mobile Ads-Vermittlungs-Plug-ins für Chartboost, extrahieren Sie die heruntergeladene Datei und fügen Sie den extrahierten Plug-in-Ordner (und dessen Inhalt) Ihrem Flutter-Projekt hinzu. Verweisen Sie dann in der Datei pubspec.yaml auf das Plug-in, indem Sie die folgende Abhängigkeit hinzufügen:

dependencies:
  gma_mediation_chartboost:
    path: path/to/local/package

Schritt 4: Datenschutzeinstellungen im Chartboost SDK implementieren

Gemäß der Richtlinie zur Einwilligung der Nutzer in der EU von Google müssen Sie Ihren Nutzern im Europäischen Wirtschaftsraum (EWR), im Vereinigten Königreich und in der Schweiz bestimmte Informationen offenlegen und ihre Einwilligung zu folgenden Aktivitäten einholen: Einsatz von Cookies oder anderen Formen der lokalen Speicherung, falls die Einholung der Einwilligung dafür gesetzlich vorgeschrieben ist, sowie Erhebung, Weiterleitung und Nutzung personenbezogener Daten für personalisierte Werbung. 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. Google kann die Einwilligung des Nutzers nicht automatisch an diese Netzwerke weitergeben.

Das Google Mobile Ads-Vermittlungs-Plug-in für Chartboost Version 3.1.0 enthält die Methode Chartboost.AddDataUseConsent(). Im folgenden Beispielcode wird die Einwilligung zur Datennutzung auf NonBehavioral gesetzt. Wenn Sie diese Methode aufrufen möchten, wird empfohlen , dass Sie dies tun, bevor Sie Anzeigen mit Google Mobile Ads Flutter Plugin anfordern.

using GoogleMobileAds.Api.Mediation.Chartboost;
// ...

Chartboost.AddDataUseConsent(CBGDPRDataUseConsent.NonBehavioral);

Datenschutzgesetze von US-Bundesstaaten

Gemäß den Datenschutzgesetzen von US-Bundesstaaten muss Nutzern das Recht eingeräumt werden, 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 können Sie die eingeschränkte Datenverarbeitung für die Google-Anzeigenauslieferung aktivieren. Google kann diese Einstellung jedoch nicht auf jedes Werbe netzwerk in Ihrer Vermittlungskette anwenden. Daher müssen Sie jedes Werbenetzwerk in Ihrer Vermittlungskette identifizieren, das am Verkauf personenbezogener Daten beteiligt sein kann, und die Anleitung der einzelnen Netzwerke befolgen, um die Einhaltung der Datenschutzgesetze zu gewährleisten.

Das Google Mobile Ads-Vermittlungs-Plug-in für Chartboost Version 3.1.0 enthält die Methode Chartboost.AddDataUseConsent(). Im folgenden Beispielcode wird die Einwilligung zur Datennutzung auf OptInSale gesetzt. Wenn Sie diese Methode aufrufen möchten, wird empfohlen , dass Sie dies tun, bevor Sie Anzeigen mit Google Mobile Ads Flutter 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 Chartboost-Dokumentation, um die SKAdNetwork-IDs der Datei Info.plist Ihres Projekts hinzuzufügen.

Schritt 6: Implementierung testen

Testanzeigen aktivieren

Stellen Sie sicher, dass Sie Ihr Testgerät für AdMob registrieren und den Testmodus in der Chartboost-Benutzeroberfläche aktivieren.

Testanzeigen prüfen

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

Optionale Schritte

Android

Berechtigungen

Für eine optimale Leistung empfiehlt Chartboost, der Datei AndroidManifest.xml Ihrer App die folgenden optionalen Berechtigungen hinzuzufügen:

<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 empfangen kann, 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 AdMob-Benutzeroberfläche konfigurierten Chartboost-Serverparameter fehlen oder sind ungültig.
104 Die Chartboost-Interstitial- oder Anzeige mit Prämie kann noch nicht ausgeliefert werden.

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 ist zum Zeitpunkt der Auslieferung nicht im Cache.
104 Die angeforderte Anzeigengröße entspricht keiner von Chartboost unterstützten Bannergröße.
105 Die Betriebssystemversion des Geräts ist niedriger als die von Chartboost SDK unterstützte Mindestversion.
200-299 Cache-Fehler im Chartboost SDK. Weitere Informationen finden Sie im Code.
300-399 Fehler bei der Auslieferung im Chartboost SDK. Weitere Informationen finden Sie im Code.
400-499 Fehler bei Klicks im Chartboost SDK. Weitere Informationen finden Sie im Code.

Änderungsprotokoll für den Chartboost Flutter-Vermittlungsadapter

Version 1.4.2

Version 1.4.1

Version 1.4.0

Version 1.3.3

Version 1.3.2

Version 1.3.1

Version 1.3.0

Version 1.2.1

Version 1.2.0

Version 1.1.0

Version 1.0.2

Version 1.0.1

Version 1.0.0