Chartboost in die Vermittlung einbinden

In dieser Anleitung erfahren Sie, wie Sie mit GMA Next-Gen SDK 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 Android-App einbinden.

Unterstützte Integrationen und Anzeigenformate

Der Vermittlungsadapter für Chartboost bietet die folgenden Funktionen:

Integration
Gebote
Vermittlungsabfolge
Formate
Banner
Interstitial
Mit Prämie
Nativ

Voraussetzungen

  • Android API‑Level 24 oder höher
  • Neueste Version GMA Next-Gen SDK

  • Vermittlung abschließen Startleitfaden

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 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 Add App (App hinzufügen), um die Einrichtung Ihrer App abzuschließen.

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.

App-Einstellungen

Für die Einrichtung Ihrer Ad Manager-Anzeigenblock-ID sind die Nutzer-ID und die Nutzersignatur von Chartboost erforderlich. Sie finden diese Parameter in der Chartboost-Benutzeroberfläche, wenn Sie auf Chartboost mediation (Chartboost-Vermittlung) klicken.

Chartboost Mediation-Dashboard

Gehen Sie zum Tab Resources > API Explorer (Ressourcen > API-Explorer) und notieren Sie sich Ihre Nutzer-ID und Nutzersignatur 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, erstellen Sie eine app-ads.txt-Datei für Ad Manager.

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.

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 haben, wird Ihre App zur Überprüfung an Chartboost gesendet . Damit die Monetarisierung über 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

Melden Sie sich in Ihrem Ad Manager-Konto an.

Klicken Sie auf Auslieferung > Ertragsgruppen und dann auf den Button Neue Ertragsgruppe.

Geben Sie einen eindeutigen Namen für die Ertragsgruppe ein, legen Sie den Status auf Aktiv fest, wählen Sie das Anzeigenformat aus und legen Sie den Inventartyp auf Mobile App fest. Wählen Sie im Bereich Targeting > Inventar unter Inventar und Mobile App den Anzeigenblock aus, dem Sie die Vermittlung hinzufügen möchten.

Klicken Sie dann auf den Button Ertragspartner hinzufügen.

Wenn Sie bereits einen Ertragspartner für Chartboost haben, können Sie ihn auswählen. Andernfalls wählen Sie Neuen Ertragspartner erstellen aus.

Wählen Sie Chartboost als das Werbenetzwerk aus, geben Sie einen eindeutigen Namen ein und aktivieren Sie Vermittlung.

Aktivieren Sie Automatische Datenerhebung und geben Sie die Nutzer-ID und die Nutzersignatur ein, die Sie im vorherigen Abschnitt erhalten haben.

Wählen Sie als Integrationstyp SDK-Vermittlung für Mobilgeräte , als Plattform Android und als Status Aktiv aus. Geben Sie die App-ID, die App-Signatur und den Anzeigenstandort ein, die Sie im vorherigen Abschnitt erhalten haben. Geben Sie dann einen Wert für den Standard-CPM ein.

Chartboost-Anzeigenstandorte (benannte Standorte) sind einfache Namen, die einen Ort in Ihrer App darstellen, an dem Sie eine Anzeige präsentieren möchten. Ad Manager sendet Anfragen an den in den Einstellungen angegebenen Standort. Sobald Anfragen gesendet wurden, fügt Chartboost den Standort zu seiner Benutzeroberfläche hinzu, um Berichte zu erstellen.

In der Chartboost-Benutzeroberfläche können Sie Ihre Anzeigenstandorte auf der Seite Basic Settings (Grundeinstellungen) aufrufen, indem Sie auf Advanced Settings (Erweiterte Einstellungen) klicken. Weitere Informationen finden Sie im Leitfaden zu benannten Standorten von Chartboost.

Klicken Sie unten auf der Seite auf Speichern.

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

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

Schritt 3: Chartboost SDK und Adapter importieren

Fügen Sie in der Datei settings.gradle.kts auf Projektebene die folgenden Repositories hinzu:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://cboost.jfrog.io/artifactory/chartboost-ads/")
    }
  }
}

Fügen Sie in der Gradle-Datei auf App-Ebene die folgenden Implementierungsabhängigkeiten und ‑konfigurationen hinzu:

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.google.ads.mediation:chartboost:9.11.1.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Groovy

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01'
    implementation 'com.google.ads.mediation:chartboost:9.11.1.1'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

Manuelle Integration

  1. Laden Sie die .aar-Datei der neuesten Version des Chartboost SDK von Maven Central herunter und fügen Sie sie Ihrem Projekt hinzu.

  2. Rufen Sie die Chartboost-Adapterartefakte im Maven-Repository von Google auf. Wählen Sie die neueste Version aus, laden Sie die .aar-Datei des Chartboost-Adapters herunter und fügen Sie sie Ihrem Projekt hinzu.

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.

In SDK-Version 8.1.0 hat Chartboost die Methode addDataUseConsent() hinzugefügt. Im folgenden Beispielcode wird die Einwilligung zur Datennutzung auf NON_BEHAVIORAL festgelegt. Wenn Sie diese Methode aufrufen, sollten Sie das tun, bevor Sie Anzeigen über GMA Next-Gen SDK anfordern.

Java

DataUseConsent dataUseConsent = new GDPR(GDPR.GDPR_CONSENT.NON_BEHAVIORAL);
Chartboost.addDataUseConsent(context, dataUseConsent);

Kotlin

val dataUseConsent = GDPR(GDPR.GDPR_CONSENT.NON_BEHAVIORAL)
Chartboost.addDataUseConsent(context, dataUseConsent)

Weitere Informationen und die Werte, die in jeder Methode angegeben werden können, finden Sie im DSGVO-Artikel von Chartboost und unter Android Privacy Methods.

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 jeweiligen Netzwerke befolgen, um die Einhaltung der Datenschutzgesetze zu gewährleisten.

In SDK-Version 8.1.0 hat Chartboost die Methode addDataUseConsent() hinzugefügt. Im folgenden Beispielcode wird die Einwilligung zur Datennutzung auf OPT_IN_SALE festgelegt. Wenn Sie diese Methode aufrufen, sollten Sie das tun, bevor Sie Anzeigen über GMA Next-Gen SDK anfordern.

Java

DataUseConsent dataUseConsent = new CCPA(CCPA.CCPA_CONSENT.OPT_IN_SALE);
Chartboost.addDataUseConsent(context, dataUseConsent);

Kotlin

val dataUseConsent = CCPA(CCPA.CCPA_CONSENT.OPT_IN_SALE)
Chartboost.addDataUseConsent(context, dataUseConsent)

Weitere Informationen und die Werte, die in jeder Methode angegeben werden können, finden Sie im CCPA-Artikel von Chartboost und unter Android Privacy Methods.

Schritt 5: Erforderlichen Code hinzufügen

Konfigurationsänderungen für Aktivitäten aktualisieren

Fügen Sie jeder Aktivität in der Datei AndroidManifest.xml, in der Chartboost-Anzeigen präsentiert werden und die verschiedene Ausrichtungen unterstützt, das folgende Attribut hinzu:

android:configChanges="keyboardHidden|orientation|screenSize"

Schritt 6: Implementierung testen

Testanzeigen aktivieren

Stellen Sie sicher, dass Sie Ihr Testgerät für Ad Manager 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

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" />

Fehlercodes

Wenn der Adapter keine Anzeige von Chartboost empfängt, können Sie den zugrunde liegenden Fehler in der Anzeigenantwort mit ResponseInfo.getAdSourceResponses() unter den folgenden Klassen prüfen:

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

Hier sind die Codes und die zugehörigen Meldungen, die vom Chartboost-Adapter ausgegeben werden, wenn eine Anzeige nicht geladen werden kann:

Fehlercode Grund
0-99 Das Chartboost SDK hat einen Fehler zurückgegeben. Weitere Informationen finden Sie in der Dokumentation von Chartboost.
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 Interstitial- oder Prämienanzeige von Chartboost ist noch nicht bereit für die Präsentation.