Chartboost in die Vermittlung einbinden

In dieser Anleitung erfahren Sie, wie Sie mit dem Google Mobile Ads SDK Anzeigen von Chartboost mithilfe von AdMob Mediation laden und präsentieren. Dabei werden auch Abfolgeintegrationen behandelt. Dort erfahren Sie, wie Sie Chartboost der Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und das Chartboost SDK und den Adapter in eine Android-App einbinden.

Unterstützte Einbindungen und Anzeigenformate

Der Vermittlungsadapter für Chartboost bietet folgende Funktionen:

Voraussetzungen

• Neueste Version des Google Mobile Ads SDK

• Mediation abschließen Startleitfaden

Schritt 1: Konfigurationen in der Chartboost-Benutzeroberfläche einrichten

Melde dich für ein Chartboost-Konto an und melde dich an, sobald dein Konto bestätigt wurde. Gehen Sie dann zum Tab App-Verwaltung.

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

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

Nachdem die App erstellt wurde, werden Sie zum Dashboard weitergeleitet. Notieren Sie sich die App-ID und die App-Signatur Ihrer App.

Für die Einrichtung Ihrer AdMob-Anzeigenblock-ID sind die Nutzer-ID und die Nutzersignatur von Chartboost erforderlich. Diese Parameter findest du in der Chartboost-Benutzeroberfläche unter Chartboost-Vermittlung.

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

Testmodus aktivieren

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

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

Sobald der Testmodus aktiviert ist, kannst du Anzeigen mit der zuvor erstellten Anzeigenblock-ID anfordern und eine Chartboost-Testanzeige erhalten.

Sobald Sie Chartboost-Testanzeigen erhalten können, wird Ihre App in die App-Überprüfung für Publisher von Chartboost aufgenommen. Damit die Monetarisierung bei 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

Sie müssen Chartboost der Vermittlungskonfiguration für Ihren Anzeigenblock hinzufügen.

Melden Sie sich zuerst in Ihrem AdMob-Konto an. Rufen Sie als Nächstes den Tab Vermittlung auf. Wenn Sie eine vorhandene Vermittlungsgruppe ändern möchten, klicken Sie auf den Namen der Vermittlungsgruppe, um sie zu bearbeiten. Fahren Sie dann mit Chartboost als Anzeigenquelle hinzufügen fort.

Wenn Sie eine neue Vermittlungsgruppe erstellen möchten, wählen Sie Vermittlungsgruppe erstellen aus.

Geben Sie das Anzeigenformat und die Plattform ein und klicken Sie auf Weiter.

Geben Sie Ihrer Vermittlungsgruppe einen Namen und wählen Sie die Standorte aus, auf die Sie Ihre Anzeigen ausrichten möchten. Legen Sie als Nächstes den Status der Vermittlungsgruppe auf Aktiviert fest und klicken Sie dann auf Anzeigenblöcke hinzufügen.

Weisen Sie diese Vermittlungsgruppe mindestens einem Ihrer vorhandenen AdMob-Anzeigenblöcke zu. Klicken Sie dann auf Fertig.

Die Karte „Anzeigenblöcke“ sollte jetzt die von Ihnen ausgewählten Anzeigenblöcke enthalten:

Chartboost als Anzeigenquelle hinzufügen

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

Folgen Sie der Anleitung unter Einstellungen zur DSGVO und Einstellungen zu Bestimmungen von US-Bundesstaaten, um Chartboost der Liste der Anzeigenpartner für die DSGVO und Bestimmungen von US-Bundesstaaten in der AdMob-Benutzeroberfläche hinzuzufügen.

Schritt 3: Chartboost SDK und Adapter importieren

Android Studio-Integration (empfohlen)

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 dann in der Datei build.gradle.kts auf App-Ebene die folgenden Implementierungsabhängigkeiten und ‑konfigurationen hinzu. Verwenden Sie die neuesten Versionen des Chartboost SDK und des Adapters:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.6.0")
    implementation("com.google.ads.mediation:chartboost:9.8.1.0")
}

Manuelle Integration

1. Lade die .aar-Datei der neuesten Version des Chartboost SDK von Maven Central herunter und füge sie deinem Projekt hinzu.

2. Rufe die Chartboost-Adapter-Artefakte im Maven-Repository von Google auf. Wähle die neueste Version aus, lade die .aar-Datei des Chartboost-Adapters herunter und füge sie deinem Projekt hinzu.

Schritt 4: Datenschutzeinstellungen im Chartboost SDK implementieren

Einwilligung der Nutzer in der EU und DSGVO

Gemäß der Google-Richtlinie zur Einwilligung der Nutzer in der EU müssen Sie Nutzern im Europäischen Wirtschaftsraum (EWR) bestimmte Informationen zur Verwendung von Geräte-IDs und personenbezogenen Daten offenlegen und ihre Einwilligung einholen. Die Richtlinie entspricht den Anforderungen der EU-Datenschutzrichtlinie für elektronische Kommunikation und der EU-Datenschutz-Grundverordnung (DSGVO). Wenn Sie die Einwilligung einholen, müssen Sie jedes Werbenetzwerk in Ihrer Vermittlungskette angeben, das personenbezogene Daten erheben, empfangen oder verwenden kann. Außerdem müssen Sie Informationen zur Nutzung jedes Netzwerks bereitstellen. Google kann die Einwilligung des Nutzers derzeit nicht automatisch an diese Netzwerke weitergeben.

In der 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 dies vor dem Anfordern von Anzeigen über das Google Mobile Ads SDK tun.

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

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

Weitere Informationen und die Werte, die für jede Methode angegeben werden können, findest du im Artikel zur DSGVO und in den Datenschutzmethoden für Android von Chartboost.

Datenschutzgesetze von US-Bundesstaaten

Datenschutzgesetze von US-Bundesstaaten verpflichten Sie, Nutzern das Recht einzuräumen, 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 sollen nicht verkauft werden) vorhanden sein. Im Leitfaden zur Einhaltung der Datenschutzgesetze von US-Bundesstaaten können Sie die eingeschränkte Datenverarbeitung für die Anzeigenbereitstellung von Google aktivieren. Google kann diese Einstellung jedoch nicht auf jedes Anzeigennetzwerk 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 Anleitungen der einzelnen Netzwerke befolgen, um die Einhaltung der Anforderungen sicherzustellen.

In der 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 dies vor dem Anfordern von Anzeigen über das Google Mobile Ads SDK tun.

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

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

Weitere Informationen und die Werte, die für jede Methode angegeben werden können, findest du im Artikel zu Chartboost und dem CCPA und in den Datenschutzmethoden für Android.

Schritt 5: Erforderlichen Code hinzufügen

AndroidManifest ändern

Andere Elemente

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

android:configChanges="keyboardHidden|orientation|screenSize"

Lebenszyklus-Ereignisse

Fügen Sie gemäß der Empfehlung von Chartboost allen Lebenszyklusereignissen Ihrer Aktivität, bei denen Chartboost-Anzeigen ausgeliefert werden, den folgenden Code hinzu.

import com.chartboost.sdk.Chartboost;
// ...

@Override
public void onBackPressed() {
    // If an interstitial is on screen, close it.
    if (Chartboost.onBackPressed()) {
        return;
    } else {
        super.onBackPressed();
    }
}

import com.chartboost.sdk.Chartboost
// ...

@Override
fun onBackPressed() {
    // If an interstitial is on screen, close it.
    if (Chartboost.onBackPressed())
        return
    else
        super.onBackPressed()
}

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 bestätigen

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 Anzeigenquellen Chartboost (Wasserfall).

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, kannst du den zugrunde liegenden Fehler in der Anzeigenantwort mithilfe von ResponseInfo.getAdapterResponses() 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:

Änderungsprotokoll für den Chartboost-Android-Vermittlungsadapter

Version 9.8.1.0

• Kompatibilität mit der Chartboost SDK-Version 9.8.1 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 23.5.0
• Chartboost SDK-Version 9.8.1

Version 9.8.0.0

• Kompatibilität mit der Chartboost SDK-Version 9.8.0 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 23.4.0
• Chartboost SDK-Version 9.8.0

Version 9.7.0.0

• Kompatibilität mit der Chartboost SDK-Version 9.7.0 bestätigt.
• Die Mindestversion des Google Mobile Ads SDK wurde auf 23.0.0 aktualisiert.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 23.0.0
• Chartboost SDK-Version 9.7.0

Version 9.6.1.0

• Kompatibilität mit der Chartboost SDK-Version 9.6.1 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 22.6.0
• Chartboost SDK-Version 9.6.1

Version 9.6.0.0

• Kompatibilität mit der Chartboost SDK-Version 9.6.0 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 22.5.0
• Chartboost SDK-Version 9.6.0

Version 9.5.0.0

• Kompatibilität mit der Chartboost SDK-Version 9.5.0 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 22.3.0
• Chartboost SDK-Version 9.5.0

Version 9.4.1.0

• Kompatibilität mit der Chartboost SDK-Version 9.4.1 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 22.2.0
• Chartboost SDK-Version 9.4.1

Version 9.4.0.0

• Kompatibilität mit der Chartboost SDK-Version 9.4.0 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 22.1.0
• Chartboost SDK-Version 9.4.0

Version 9.3.1.0

• Kompatibilität mit der Chartboost SDK-Version 9.3.1 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 22.1.0
• Chartboost SDK-Version 9.3.1

Version 9.3.0.0

• Kompatibilität mit der Chartboost SDK-Version 9.3.0 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 22.0.0
• Chartboost SDK-Version 9.3.0

Version 9.2.1.1

• Der Adapter wurde aktualisiert, um die neue VersionInfo-Klasse zu verwenden.
• Die Mindestversion des Google Mobile Ads SDK wurde auf 22.0.0 aktualisiert.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 22.0.0
• Chartboost SDK-Version 9.2.1

Version 9.2.1.0

• Kompatibilität mit Chartboost SDK 9.2.1 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 21.5.0
• Chartboost SDK-Version 9.2.1

Version 9.2.0.0

• Kompatibilität mit dem Chartboost SDK 9.2.0 bestätigt.
• Die Mindestversion des Google Mobile Ads SDK wurde auf 21.5.0 aktualisiert.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 21.5.0
• Chartboost SDK-Version 9.2.0

Version 9.1.1.0

• Die Methode ChartboostMediationAdapter.setAppParams(String, String) wurde hinzugefügt, um optional die App-ID und die App-Signatur zu hartcodieren, die zum Initialisieren des Chartboost SDK verwendet werden sollen.
• Kompatibilität mit dem Chartboost SDK 9.1.1 bestätigt.
• Die Mindestversion des Google Mobile Ads SDK wurde auf 21.3.0 aktualisiert.

Entwickelt und getestet mit:

• Google Mobile Ads SDK-Version 21.3.0
• Chartboost SDK-Version 9.1.1

Version 8.4.3.1

• Die Mindestversion des Google Mobile Ads SDK wurde auf 21.0.0 aktualisiert.
• Das für Android erforderliche Mindest-API-Level wurde auf 19 aktualisiert.

Entwickelt und getestet mit:

• Google Mobile Ads SDK-Version 21.0.0
• Chartboost SDK-Version 8.4.3

Version 8.4.3.0

• Kompatibilität mit Chartboost SDK 8.4.3 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 20.6.0
• Chartboost SDK-Version 8.4.3

Version 8.4.2.0

• Kompatibilität mit Chartboost SDK 8.4.2 bestätigt.
• compileSdkVersion und targetSdkVersion auf API 31 aktualisiert
• Die Mindestversion des Google Mobile Ads SDK wurde auf 20.6.0 aktualisiert.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 20.6.0
• Chartboost SDK-Version 8.4.2

Version 8.4.1.0

• Kompatibilität mit Chartboost SDK 8.4.1 bestätigt.
• Die Mindestversion des Google Mobile Ads SDK wurde auf 20.6.0 aktualisiert.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 20.6.0
• Chartboost SDK-Version 8.4.1

Version 8.3.1.0

• Kompatibilität mit dem Chartboost SDK 8.3.1 bestätigt.
• Der Adapter wurde auf die neue AdError API umgestellt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK-Version 20.5.0
• Chartboost SDK-Version 8.3.1

Version 8.3.0.0

• Kompatibilität mit Chartboost SDK 8.3.0 bestätigt.
• Die Mindestversion des Google Mobile Ads SDK wurde auf 20.5.0 aktualisiert.

Entwickelt und getestet mit:

• Google Mobile Ads SDK-Version 20.5.0
• Chartboost SDK-Version 8.3.0

Version 8.2.1.0

• Kompatibilität mit Chartboost SDK 8.2.1 bestätigt.
• Die Mindestversion des Google Mobile Ads SDK wurde auf 20.1.0 aktualisiert.

Entwickelt und getestet mit:

• Google Mobile Ads SDK-Version 20.1.0
• Chartboost SDK-Version 8.2.1

Version 8.2.0.1

• Die Mindestversion des Google Mobile Ads SDK wurde auf 20.0.0 aktualisiert.

Entwickelt und getestet mit:

• Google Mobile Ads SDK-Version 20.0.0
• Chartboost SDK-Version 8.2.0

Version 8.2.0.0

• Kompatibilität mit Chartboost SDK 8.2.0 bestätigt.
• Die Mindestversion des Google Mobile Ads SDK wurde auf 19.5.0 aktualisiert.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 19.5.0
• Chartboost SDK-Version 8.2.0

Version 8.1.0.0

• Kompatibilität mit Chartboost SDK 8.1.0 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 19.2.0
• Chartboost SDK-Version 8.1.0

Version 8.0.3.2

• Beschreibende Fehlercodes und Gründe für Fehler beim Laden/Darstellen von Adaptern hinzugefügt.
• Die Mindestversion des Google Mobile Ads SDK wurde auf 19.2.0 aktualisiert.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 19.2.0
• Chartboost SDK-Version 8.0.3

Version 8.0.3.1

• Unterstützung für Chartboost-Banneranzeigen hinzugefügt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 19.1.0
• Chartboost SDK-Version 8.0.3

Version 8.0.3.0

• Kompatibilität mit Chartboost SDK 8.0.3 bestätigt.
• Die Mindestversion des Google Mobile Ads SDK wurde auf 19.1.0 aktualisiert.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 19.1.0
• Chartboost SDK-Version 8.0.3

Version 8.0.2.0

• Kompatibilität mit Chartboost SDK 8.0.2 bestätigt.
• Die Mindestversion des Google Mobile Ads SDK wurde auf 19.0.1 aktualisiert.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 19.0.1
• Chartboost SDK-Version 8.0.2

Version 8.0.1.0

• Kompatibilität mit Chartboost SDK 8.0.1 bestätigt.
• Erfordert das Chartboost SDK 8.0.1 oder höher.
• Der Aktivitätskontext ist nicht mehr erforderlich, um Anzeigen zu laden.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 18.3.0
• Chartboost SDK-Version 8.0.1

Version 7.5.0.1

• Ein Fehler wurde behoben, bei dem der Chartboost-Adapter keine Anzeigenereignisse auslöste.
• Die Mindestversion des Google Mobile Ads SDK wurde auf 18.3.0 aktualisiert.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 18.3.0
• Chartboost SDK-Version 7.5.0

Version 7.5.0.0

• Kompatibilität mit Chartboost SDK 7.5.0 bestätigt.
• Der Adapter wurde auf die Verwendung von AndroidX-Abhängigkeiten umgestellt.
• Die Mindestversion des Google Mobile Ads SDK wurde auf 18.1.1 aktualisiert.

Version 7.3.1.1

• Der Adapter wurde aktualisiert, um die neue offene Betaversion der Rewarded API zu unterstützen.
• Die Mindestversion des Google Mobile Ads SDK wurde auf 17.2.0 aktualisiert.

Version 7.3.1.0

• Kompatibilität mit Chartboost SDK 7.3.1 bestätigt.

Version 7.3.0.0

• Kompatibilität mit Chartboost SDK 7.3.0 bestätigt.

Version 7.2.1.0

• Kompatibilität mit Chartboost SDK 7.2.1 bestätigt.

Version 7.2.0.1

• Der Adapter wurde aktualisiert, um das onRewardedVideoComplete()-Anzeigenereignis aufzurufen.

Version 7.2.0.0

• Kompatibilität mit Chartboost SDK 7.2.0 bestätigt.

Version 7.1.0.0

• Kompatibilität mit Chartboost SDK 7.1.0 bestätigt.

Version 7.0.1.0

• Kompatibilität mit Chartboost SDK 7.0.1 bestätigt.
• Unterstützung für neue Chartboost-Fehlercodes hinzugefügt.
• Adapterprojekt für Android Studio 3.0 aktualisiert

Version 7.0.0.0

• Der Adapter wurde aktualisiert, damit er mit dem Chartboost SDK 7.0.0 kompatibel ist.

Version 6.6.3.0

• Kompatibilität mit Chartboost SDK 6.6.3 bestätigt.

Version 6.6.2.0

• Kompatibilität mit Chartboost SDK 6.6.2 bestätigt.

Version 6.6.1.0

• Kompatibilität mit Chartboost SDK 6.6.1 bestätigt.

Version 6.6.0.0

• Das Benennungssystem für Versionen wurde in [Chartboost SDK-Version].[Adapter-Patch-Version] geändert.
• Die Adapter können jetzt als Kompilierungsabhängigkeit hinzugefügt werden. Fügen Sie dazu dem dependencies-Tag der Datei „build.gradle“ Folgendes hinzu: compile 'com.google.ads.mediation:chartboost:6.6.0.0'
• Der Adapter wird jetzt als AAR-Datei anstelle einer JAR-Datei bereitgestellt. Weitere Informationen finden Sie in der README-Datei.

Version 1.1.0

• Die Option „Chartboost-Anzeigenstandort“ wurde aus den Chartboost-Extras entfernt. Der Anzeigenstandort wird jetzt in der AdMob Console angegeben, wenn Chartboost für die Vermittlung konfiguriert wird.

Version 1.0.0

• Erste Version Videoanzeigen mit Prämie und Interstitial-Anzeigen werden unterstützt.