Chartboost in die Vermittlung einbinden

In diesem Leitfaden erfahren Sie, wie Sie mit dem Google Mobile Ads SDK Anzeigen von Chartboost über die Vermittlung laden und präsentieren. Es werden auch Abfolgeintegrationen behandelt. Sie erfahren, wie Sie Chartboost der Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und das Chartboost SDK und den Adapter in eine iOS App einbinden.

Unterstützte Einbindungen und Anzeigenformate

Der Vermittlungsadapter für Chartboost bietet folgende Funktionen:

Integration
Gebote
Wasserfall
Formate
Banner
Interstitial
Verfügbar
Nativ

Voraussetzungen

  • iOS-Bereitstellungsziel 12.0 oder höher
  • Neueste Version des Google Mobile Ads SDK

  • Schließen Sie die Vermittlung ab. 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.

Chartboost-App-Dashboard

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

App-Verwaltung

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

Formular für neue Apps

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

App-Einstellungen

AdMob benötigt die Nutzer-ID und die Nutzersignatur von Chartboost, um Ihre AdMob-Anzeigenblock-ID einzurichten. Diese Parameter findest du in der Chartboost-Benutzeroberfläche unter Chartboost-Vermittlung.

Chartboost-Vermittlungs-Dashboard

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

Chartboost API Explorer

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.

App-Einstellungen bearbeiten

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

Chartboost-Testmodus

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 Ad Manager -Benutzeroberfläche einrichten

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

Folgen Sie den Schritten in den DSGVO-Einstellungen und den Einstellungen für Verordnungen von US-Bundesstaaten, um Chartboost der Liste der Werbepartner zur DSGVO und zu Verordnungen von US-Bundesstaaten in der AdMob-Benutzeroberfläche hinzuzufügen.

Schritt 3: Chartboost SDK und Adapter importieren

  • Fügen Sie der Podfile Ihres Projekts die folgende Zeile hinzu:

    pod 'GoogleMobileAdsMediationChartboost'
    
  • Führen Sie in der Befehlszeile folgenden Befehl aus:

    pod install --repo-update

Manuelle Integration

  • Lade die neueste Version des Chartboost SDK herunter und verknüpfe Chartboost.framework und CHAMoatMobileAppKit.framework in deinem Projekt.

  • Lade die neueste Version des Chartboost-Adapters über den Downloadlink im Changelog herunter und verknüpfe ChartboostAdapter.framework mit deinem Projekt.

  • Fügen Sie Ihrem Projekt die folgenden Frameworks hinzu:

    • StoreKit
    • Foundation
    • CoreGraphics
    • WebKit
    • AVFoundation
    • UIKit

Schritt 4: Datenschutzeinstellungen im Chartboost SDK implementieren

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. Diese 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.2.0 hat Chartboost die Methode addDataUseConsent hinzugefügt. Im folgenden Beispielcode wird die Einwilligung zur Datennutzung auf CHBGDPRConsentNonBehavioral festgelegt. Wenn Sie diese Methode aufrufen, sollten Sie dies vor dem Anfordern von Anzeigen über das Google Mobile Ads SDK tun.

Swift

let dataUseConsent = CHBDataUseConsent.GDPR(CHBDataUseConsent.GDPR.Consent.nonBehavioral)
Chartboost.addDataUseConsent(dataUseConsent)

Objective-C

CHBGDPRDataUseConsent *dataUseConsent = [CHBGDPRDataUseConsent gdprConsent:CHBGDPRConsentNonBehavioral];
[Chartboost addDataUseConsent:dataUseConsent];

Weitere Informationen und die Werte, die für jede Methode angegeben werden können, findest du im Artikel zur DSGVO und in denDatenschutzmethoden für iOS undDatenschutzmethoden für Android-Geräte mit Play-Diensten von Chartboost.

Datenschutzgesetze von US-Bundesstaaten

Datenschutzgesetze von US-Bundesstaaten müssen Nutzern das Recht einräumen, dem „Verkauf“ ihrer „personenbezogenen Daten“ zu widersprechen (laut gesetzlicher Definition dieser Bedingungen). Dazu muss auf der Startseite des „Verkäufers“ ein gut sichtbarer Link mit dem Text „Meine personenbezogenen Daten sollen nicht verkauft werden“ eingeblendet werden. 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 angeben, das am Verkauf personenbezogener Daten beteiligt sein könnte, und die Richtlinien der einzelnen Werbenetzwerke befolgen, um die Compliance sicherzustellen.

In der SDK-Version 8.2.0 hat Chartboost die Methode addDataUseConsent hinzugefügt. Im folgenden Beispielcode wird die Einwilligung zur Datennutzung auf CHBCCPAConsentOptInSale festgelegt. Wir empfehlen, diese Methode aufzurufen, bevor Sie Anzeigen über das Google Mobile Ads SDK anfordern.

Swift

let dataUseConsent = CHBDataUseConsent.CCPA(CHBDataUseConsent.CCPA.Consent.optInSale)
Chartboost.addDataUseConsent(dataUseConsent)

Objective-C

CHBCCPADataUseConsent *dataUseConsent = [CHBCCPADataUseConsent ccpaConsent:CHBCCPAConsentOptInSale];
[Chartboost addDataUseConsent:dataUseConsent];

Weitere Informationen und die Werte, die in den einzelnen Methoden angegeben werden können, finden Sie im CCPA-Artikel von Chartboost und in den Datenschutzmethoden für iOS .

Fehlercodes

Wenn der Adapter keine Anzeige von Chartboost empfängt, kannst du den zugrunde liegenden Fehler in der Anzeigenantwort mithilfe von GADResponseInfo.adNetworkInfoArray unter den folgenden Klassen:

GADMAdapterChartboost
GADMediationAdapterChartboost

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

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 wird zum Zeitpunkt der Auslieferung nicht im Cache gespeichert.
104 Die angeforderte Anzeigengröße entspricht nicht einer von Chartboost unterstützten Bannergröße.
105 Die Betriebssystemversion des Geräts ist niedriger als die mindestens unterstützte Betriebssystemversion des Chartboost SDK.
200-299 Cache-Fehler des Chartboost SDK Weitere Informationen finden Sie unter Code.
300-399 Für das Chartboost SDK werden Fehler angezeigt. Weitere Informationen finden Sie unter Code.
400-499 Klickfehler beim Chartboost SDK Weitere Informationen finden Sie unter Code.

Änderungslog für den Chartboost iOS-Vermittlungsadapter

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 11.11.0
  • Chartboost SDK-Version 9.8.0

Version 9.7.0.1

  • CFBundleShortVersionString wurde auf drei statt vier Komponenten aktualisiert.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK, Version 11.10.0.
  • Chartboost SDK-Version 9.7.0

Version 9.7.0.0

  • Die Kompatibilität mit Chartboost SDK Version 9.7.0 wurde bestätigt.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK-Version 11.2.0
  • Chartboost SDK Version 9.7.0.

Version 9.6.0.1

  • Erfordert jetzt mindestens iOS-Version 12.0.
  • Für Google Mobile Ads SDK ist jetzt Version 11.0 oder höher erforderlich.
  • Info.plist in die Frameworks in ChartboostAdapter.xcframework aufgenommen.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK, Version 11.0.1.
  • Chartboost SDK-Version 9.6.0

Version 9.6.0.0

  • Kompatibilität mit der Chartboost SDK-Version 9.6.0 bestätigt.
  • Die eingestellte Methode GADMobileAds.sharedInstance.sdkVersion wurde durch GADMobileAds.sharedInstance.versionNumber ersetzt.
  • GADMediationInterstitialAd-Implementierung hinzugefügt.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK Version 10.14.0
  • Chartboost SDK Version 9.6.0.

Version 9.5.1.0

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

Entwickelt und getestet mit:

  • Google Mobile Ads SDK, Version 10.12.0.
  • Chartboost SDK Version 9.5.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 10.7.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 10.7.0.
  • Chartboost SDK-Version 9.3.1

Version 9.3.0.0

  • Kompatibilität mit der Chartboost SDK-Version 9.3.0 bestätigt.
  • Jetzt ist mindestens iOS 11.0 erforderlich.
  • Jetzt ist das Google Mobile Ads SDK Version 10.4.0 oder höher erforderlich.

Entwickelt und getestet mit:

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

Version 9.2.0.0

  • GADMChartboostExtras-Import aus der Kopfdatei ChartboostAdapter entfernt
  • Kompatibilität mit Chartboost SDK Version 9.2.0 bestätigt.
  • Für Google Mobile Ads SDK ist jetzt Version 10.0.0 oder höher erforderlich.
  • Die Unterstützung für die armv7-Architektur wurde entfernt.
  • Jetzt ist mindestens iOS 11.0 erforderlich.

Entwickelt und getestet mit:

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

Version 9.1.0.0

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

Entwickelt und getestet mit:

  • Google Mobile Ads SDK-Version 9.11.0
  • Chartboost SDK Version 9.1.0.

Version 9.0.0.0

  • Kompatibilität mit der Chartboost SDK-Version 9.0.0 bestätigt.
  • Kompatibilität mit der Version 9.10.0 des Google Mobile Ads SDKs bestätigt.
  • Der Adapter wurde für die Verwendung der didRewardUser API aktualisiert.
  • Jetzt ist das Google Mobile Ads SDK Version 9.8.0 oder höher erforderlich.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK Version 9.10.0.
  • Chartboost SDK Version 9.0.0.

Version 8.5.0.2

  • Kompatible Version: Google Mobile Ads SDK Version 9.0.0
  • Jetzt ist das Google Mobile Ads SDK Version 9.0.0 oder höher erforderlich.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK Version 9.0.0
  • Chartboost SDK Version 8.5.0.

Version 8.5.0.1.0

  • Kompatibilität mit Chartboost SDK 8.5.0 bestätigt, das sich auf Version 8.5.0.1 in CocoaPods bezieht

Entwickelt und getestet mit

  • Google Mobile Ads SDK Version 8.13.0
  • Chartboost SDK-Version 8.5.0

Version 8.5.0.0

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

Entwickelt und getestet mit

  • Google Mobile Ads SDK-Version 8.12.0
  • Chartboost SDK-Version 8.5.0

Version 8.4.2.0

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

Entwickelt und getestet mit

  • Google Mobile Ads SDK Version 8.6.0
  • Chartboost SDK Version 8.4.2.

Version 8.4.1.1

  • Die Abhängigkeit vom Google Mobile Ads SDK 8.0.0 oder höher wurde gelockert.

Entwickelt und getestet mit

  • Version 8.4.0 des Google Mobile Ads SDK
  • Chartboost SDK-Version 8.4.1

Version 8.4.1.0

  • Kompatibilität mit dem Chartboost SDK 8.4.1 bestätigt.
  • Jetzt ist das Google Mobile Ads SDK Version 8.1.0 oder höher erforderlich.

Entwickelt und getestet mit

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

Version 8.4.0.1

  • Es wurden standardisierte Adapterfehlercodes und -meldungen hinzugefügt.
  • Der Adapter wurde so aktualisiert, dass das Format .xcframework verwendet wird.
  • Jetzt ist das Google Mobile Ads SDK Version 8.0.0 oder höher erforderlich.

Entwickelt und getestet mit

  • Google Mobile Ads SDK Version 8.0.0
  • Chartboost SDK-Version 8.4.0

Version 8.4.0.0

  • Kompatibilität mit Chartboost SDK 8.4.0 bestätigt.
  • Für Google Mobile Ads SDK ist jetzt Version 7.68.0 oder höher erforderlich.

Entwickelt und getestet mit

  • Google Mobile Ads SDK, Version 7.68.0.
  • Chartboost SDK-Version 8.4.0

Version 8.3.1.0

  • Geprüfte Kompatibilität mit Chartboost SDK 8.3.1.
  • Für Google Mobile Ads SDK ist jetzt Version 7.66.0 oder höher erforderlich.
  • Jetzt ist mindestens iOS 10.0 erforderlich.
  • Der Adapter wurde aktualisiert, damit Anfragen für adaptive Banner unterstützt werden.

Entwickelt und getestet mit

  • Google Mobile Ads SDK Version 7.66.0
  • Chartboost SDK Version 8.3.1.

Version 8.2.1.0

  • Kompatibilität mit Chartboost SDK 8.2.1 bestätigt.
  • Jetzt ist das Google Mobile Ads SDK Version 7.64.0 oder höher erforderlich.
  • Jetzt ist mindestens iOS 9.0 erforderlich.

Entwickelt und getestet mit

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

Version 8.2.0.0

  • Kompatibilität mit Chartboost SDK 8.2.0 bestätigt.
  • Jetzt ist das Google Mobile Ads SDK Version 7.61.0 oder höher erforderlich.

Entwickelt und getestet mit

  • Google Mobile Ads SDK Version 7.61.0
  • Chartboost SDK Version 8.2.0.

Version 8.1.0.1

  • Die Mindestversion des Google Mobile Ads SDK wurde auf 7.60.0 aktualisiert.
  • Der Adapter wurde aktualisiert, um die neue Chartboost API zu verwenden. Außerdem wurden verworfene APIs entfernt.
  • Der Adapter unterstützt jetzt das Laden mehrerer Anzeigen desselben Formats an demselben Chartboost-Standort.
  • Wenn die Prämie nicht in der AdMob- oder Ad Manager-Benutzeroberfläche überschrieben wird, ist der Prämienwert für Anzeigen mit Prämie jetzt der in der Chartboost-Benutzeroberfläche angegebene Wert anstelle von 0.

Entwickelt und getestet mit

  • Google Mobile Ads SDK Version 7.60.0
  • Chartboost SDK Version 8.1.0.

Version 8.1.0.0

  • Kompatibilität mit Chartboost SDK 8.1.0 bestätigt.
  • Die mindestens erforderliche Version des Google Mobile Ads SDK wurde auf Version 7.59.0 aktualisiert.
  • Die i386-Architektur wird nicht mehr unterstützt.

Entwickelt und getestet mit

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

Version 8.0.4.0

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

Entwickelt und getestet mit

  • Google Mobile Ads SDK-Version 7.52.0
  • Chartboost SDK-Version 8.0.4

Version 8.0.1.1

  • Ein Problem wurde behoben, bei dem bei der Anfrage von Banneranzeigen keine Auslieferungen zurückgegeben wurden.

Version 8.0.1.0

  • Kompatibilität mit Chartboost SDK 8.0.1 bestätigt.
  • Es ist jetzt möglich, Banneranzeigen anzufordern.

Version 7.5.0.1

  • Code zur korrekten Initialisierung des Chartboost SDK wurde hinzugefügt.

Version 7.5.0.0

  • Kompatibilität mit Chartboost SDK 7.5.0 bestätigt.
  • Der Adapter wurde aktualisiert, sodass die neue API für Anzeigen mit Prämie verwendet wird.
  • Der Adapter wurde aktualisiert, um mehrere Interstitial-Anfragen zu verarbeiten.
  • Jetzt ist das Google Mobile Ads SDK Version 7.42.2 oder höher erforderlich.

Version 7.3.0.0

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

Version 7.2.0.1

  • Dem Adapter wurde der Rückruf adapterDidCompletePlayingRewardBasedVideoAd: hinzugefügt.

Version 7.2.0.0

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

Version 7.1.2.0

  • Kompatibilität mit dem Chartboost SDK 7.1.2 bestätigt.

Version 7.1.1.0

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

Version 7.1.0.0

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

Version 7.0.4.0

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

Version 7.0.3.0

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

Version 7.0.2.0

  • Geprüfte Kompatibilität mit Chartboost SDK 7.0.2.
  • Unterstützung für zwei neue Chartboost-Fehlercodes hinzugefügt.

Version 7.0.1.0

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

Version 7.0.0.0

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

Version 6.6.3.0

  • Geprüfte Kompatibilität mit Chartboost SDK 6.6.3.
  • Die Unterstützung für die Armv7s-Architektur wurde entfernt.
  • Ein Fehler wurde behoben, bei dem Publisher beim Importieren von ChartboostAdapter.framework als Modul ein Kompilierungsproblem in Swift hatten, wodurch das nicht modulare Chartboost SDK importiert wurde.

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

  • Geprüfte Kompatibilität mit Chartboost SDK 6.6.0.

Version 6.5.2.1

  • Bitcode-Unterstützung aktiviert.
  • Der Chartboost-Adapter wird jetzt als Framework bereitgestellt.
  • Wenn Sie ChartboostAdapter.framework in Ihr Projekt importieren möchten, müssen Sie unter „Build-Einstellungen“ des Ziels Allow Non-modular Includes in Framework Modules auf YES festlegen.

Version 6.5.2.0

  • Das System zur Benennung der Versionen wurde zu [Chartboost SDK version].[adapter patch version] geändert.
  • Das für die Anzeigenbereitstellung erforderliche Chartboost SDK wurde auf Version 6.5.1 aktualisiert.
  • Die Mindestversion des Google Mobile Ads SDK wurde auf Version 7.10.1 aktualisiert.
  • Ein Fehler wurde behoben, der die Unterstützung mehrerer Chartboost-Anzeigenflächen verhinderte.
  • Apps erhalten jetzt den interstitialWillDismissScreen:-Callback, wenn die Interstitialanzeige geschlossen wird.
  • Apps erhalten jetzt den rewardBasedVideoAdDidOpen:-Callback, wenn eine prämienbasierte Videoanzeige geöffnet wird.

Version 1.1.0

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

Version 1.0.0

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