Chartboost in die Vermittlung einbinden

In diesem Leitfaden erfahren Sie, wie Sie mit dem Google Mobile Ads SDK Anzeigen von Chartboost unter Verwendung von Vermittlung mit Vermittlungsabfolgen. Sie erfahren, wie Sie Chartboost zum Vermittlungskonfiguration und Integration des Chartboost SDK und des Adapters in einer App.

Unterstützte Integrationen und Anzeigenformate

Der Vermittlungsadapter für Chartboost hat folgende Funktionen:

Integration
Gebote
Wasserfall
Formate
Banner
Interstitial
Verfügbar
Nativ

Voraussetzungen

  • iOS-Bereitstellungsziel von 12.0 oder höher

  • Neuestes Google Mobile Ads 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 App-Verwaltung.

Apps-Dashboard von Chartboost

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 die Schaltfläche Add App (App hinzufügen), um Ihre Anwendung 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

Ad Manager erfordert die User-ID und die Nutzersignatur von Chartboost zum Einrichten der Ad Manager Anzeigenblock-ID. Klicken Sie zum Aufrufen dieser Parameter in der Chartboost-Benutzeroberfläche auf Chartboost-Vermittlung.

Chartboost-Vermittlungs-Dashboard

Wechseln Sie zum Tab Ressourcen > API Explorer und notieren Sie sich im Abschnitt Authentifizierung Ihre Nutzer-ID und Ihre Nutzersignatur.

Chartboost API Explorer

Testmodus aktivieren

Sie können den Testmodus für Ihre App aktivieren. Rufen Sie dazu über die Chartboost-Benutzeroberfläche den Tab Apps-Verwaltung auf, wählen Sie Ihre App aus der Liste aus und klicken Sie auf App-Einstellungen bearbeiten.

Android

App-Einstellungen bearbeiten

iOS

App-Einstellungen bearbeiten

In den Einstellungen Ihrer App können Sie den Testmodus ein-/ausschalten.

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 die Testanzeigen von Chartboost erhalten haben, wird Ihre App in die App-Überprüfung für Publisher von Chartboost aufgenommen. Damit die Monetarisierung auf Chartboost funktioniert, muss die App-Überprüfung durch Publisher von Chartboost genehmigt werden.

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

Vermittlungseinstellungen für Anzeigenblöcke konfigurieren

Android

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

iOS

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

Zur Liste der Werbepartner zur DSGVO und zu Verordnungen von US-Bundesstaaten hinzufügen Chartboost

Folgen Sie den Schritten unter DSGVO-Einstellungen und Einstellungen zu Bestimmungen von US-Bundesstaaten um Chartboost in die Liste der Werbepartner gemäß DSGVO und US-Bundesstaaten auf der Ad Manager Benutzeroberfläche aufzunehmen.

Schritt 3: Chartboost SDK und Adapter importieren

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

    pod 'GoogleMobileAdsMediationChartboost'

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

    pod install --repo-update

Manuelle Integration

  • Laden Sie die aktuelle Version der Chartboost SDK und Link Chartboost.framework und CHAMoatMobileAppKit.framework in Ihrem Projekt.

  • Laden Sie die neueste Version des Chartboost-Adapters über den Download-Link im Änderungsprotokoll herunter und Verknüpfen Sie ChartboostAdapter.framework in Ihrem 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-Einwilligung der Nutzer in der EU den Richtlinien entsprechen, müssen Sie sicherstellen, dass bestimmte Personen Einwilligungen von Nutzern im Europäischen Wirtschaftsraum (EWR) bezüglich die Verwendung von Gerätekennungen und personenbezogenen Daten. Diese Richtlinie entspricht den der EU-Datenschutzrichtlinie für elektronische Kommunikation und der EU-Datenschutz-Grundverordnung Verordnung (DSGVO) aufgeführt. Beim Einholen der Einwilligung müssen Sie jedes Werbenetzwerk angeben in Ihrer Vermittlungskette, die personenbezogene Daten erheben, erhalten oder nutzen, Informationen zur Nutzung der einzelnen Werbenetzwerke enthalten. Google kann derzeit nicht wird die Einwilligungsentscheidung des Nutzers automatisch an diese Netzwerke übergeben.

In der SDK-Version 8.2.0 hat Chartboost die Methode addDataUseConsent hinzugefügt. Die Im folgenden Beispielcode wird die Einwilligung für die Datennutzung auf CHBGDPRConsentNonBehavioral festgelegt. Wenn Sie diese Methode aufrufen, sollten Sie dies vor der über das Google Mobile Ads SDK angefordert werden.

Swift

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

Objective-C

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

Siehe Chartboost DSGVO-Artikel und die entsprechenden . Datenschutzmethoden für iOS finden Sie weitere Details und die Werte, die in jeder Methode angegeben werden können.

Datenschutzgesetze von US-Bundesstaaten

USA Datenschutzgesetze von Bundesstaaten müssen Sie den Nutzern das Angebot des Angebots ihrer "personenbezogenen Daten" (wie das Gesetz definiert der vorliegenden Nutzungsbedingungen), wobei die Widerspruchsmöglichkeit über die deutlich sichtbare „Do Not Sell My Personal“- Informationen“ auf den Link „Verkauf“ die Startseite der Party. Die USA Datenschutz für Bundesstaaten Leitfaden zur Einhaltung gesetzlicher Vorschriften die Möglichkeit, eingeschränkte Datenverarbeitung für die Anzeigenbereitstellung durch Google, aber Google kann diese Einstellung nicht auf jede Anzeige anwenden Netzwerk in Ihrer Vermittlungskette. Daher müssen Sie jedes Werbenetzwerk, Vermittlungskette, die am Verkauf von persönlichen und folgen den Leitlinien der einzelnen Netzwerke, um sicherzustellen, Compliance.

In der SDK-Version 8.2.0 hat Chartboost die Methode addDataUseConsent hinzugefügt. Die Im folgenden Beispielcode wird die Einwilligung für die Datennutzung auf CHBCCPAConsentOptInSale festgelegt. Wenn Sie diese Methode aufrufen, sollten Sie dies vor der Anfrage über das Google Mobile Ads SDK.

Swift

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

Objective-C

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

Siehe Chartboost CCPA-Artikel und die entsprechenden . Datenschutzmethoden für iOS finden Sie weitere Details und die Werte, die in jeder Methode angegeben werden können.

Fehlercodes

Wenn der Adapter keine Anzeige von Chartboost erhält, können Sie auf der zugrunde liegender Fehler aus der Anzeigenantwort GADResponseInfo.adNetworkInfoArray in folgenden Klassen:

GADMAdapterChartboost
GADMediationAdapterChartboost

Dies sind die Codes und zugehörigen Nachrichten, 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 zu Chartboost-Dokumentation .
101 Die angeforderte Anzeigengröße stimmt nicht mit einer von Chartboost unterstützten Bannergröße überein.
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 die Chartboost-Anzeige mit Prämie ist noch nicht zur Auslieferung bereit.
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 stimmt nicht mit einer von Chartboost unterstützten Bannergröße überein.
105 Die Betriebssystemversion des Geräts ist niedriger als die mindestens unterstützte Betriebssystemversion des Chartboost SDK.
200-299 Cache-Fehler des Chartboost SDK Siehe Code .
300-399 Im Chartboost SDK werden Fehler angezeigt. Siehe Code .
400-499 Chartboost SDK-Klickfehler Siehe Code .

Änderungsprotokoll zum Chartboost iOS-Vermittlungsadapter

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 wurde in die Frameworks von 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

  • Die Kompatibilität mit Chartboost SDK Version 9.6.0 wurde 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

  • Die Kompatibilität mit Chartboost SDK Version 9.5.1 wurde 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

  • Die Kompatibilität mit Chartboost SDK Version 9.4.0 wurde 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

  • Die Kompatibilität mit Chartboost SDK Version 9.3.1 wurde 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

  • Die Kompatibilität mit Chartboost SDK Version 9.3.0 wurde bestätigt.
  • Es ist jetzt mindestens iOS-Version 11.0 erforderlich.
  • Für Google Mobile Ads SDK ist jetzt 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

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

Entwickelt und getestet mit:

  • Version 10.0.0 des Google Mobile Ads SDK
  • Chartboost SDK Version 9.2.0.

Version 9.1.0.0

  • Die Kompatibilität mit Chartboost SDK Version 9.1.0 wurde 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

  • Die Kompatibilität mit Chartboost SDK Version 9.0.0 wurde bestätigt.
  • Die Kompatibilität mit Version 9.10.0 des Google Mobile Ads SDK wurde bestätigt.
  • Der Adapter wurde aktualisiert, um die didRewardUser API zu verwenden.
  • Für Google Mobile Ads SDK ist jetzt 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

  • Die Kompatibilität mit Version 9.0.0 des Google Mobile Ads SDK wurde bestätigt.
  • Für Google Mobile Ads SDK ist jetzt Version 9.0.0 oder höher erforderlich.

Entwickelt und getestet mit:

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

Version 8.5.0.1.0

  • Es wurde die Kompatibilität mit dem Chartboost SDK 8.5.0 bestätigt, das auf Version 8.5.0.1 in CocoaPods verweist.

Entwickelt und getestet mit

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

Version 8.5.0.0

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

Entwickelt und getestet mit

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

Version 8.4.2.0

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

Entwickelt und getestet mit

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

Version 8.4.1.1

  • Entspannte Abhängigkeit von Version 8.0.0 oder höher des Google Mobile Ads SDK.

Entwickelt und getestet mit

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

Version 8.4.1.0

  • Geprüfte Kompatibilität mit Chartboost SDK 8.4.1.
  • Für Google Mobile Ads SDK ist jetzt 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 Fehlercodes und Fehlermeldungen für Adapter hinzugefügt.
  • Der Adapter wurde aktualisiert, sodass das Format .xcframework verwendet wird.
  • Für Google Mobile Ads SDK ist jetzt Version 8.0.0 oder höher erforderlich.

Entwickelt und getestet mit

  • Version 8.0.0 des Google Mobile Ads SDK
  • Chartboost SDK Version 8.4.0.

Version 8.4.0.0

  • Geprüfte Kompatibilität mit Chartboost SDK 8.4.0.
  • 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.
  • Erfordert jetzt mindestens iOS-Version 10.0.
  • 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

  • Geprüfte Kompatibilität mit Chartboost SDK 8.2.1.
  • Für Google Mobile Ads SDK ist jetzt Version 7.64.0 oder höher erforderlich.
  • Erfordert jetzt mindestens iOS-Version 9.0.

Entwickelt und getestet mit

  • Google Mobile Ads SDK, Version 7.64.0.
  • Chartboost SDK Version 8.2.1.

Version 8.2.0.0

  • Geprüfte Kompatibilität mit Chartboost SDK 8.2.0.
  • Für Google Mobile Ads SDK ist jetzt 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 mindestens erforderliche Version des Google Mobile Ads SDK wurde auf Version 7.60.0 aktualisiert.
  • Der Adapter wurde aktualisiert, um die neue API von Chartboost zu verwenden, und die eingestellten APIs wurden entfernt.
  • Der Adapter unterstützt jetzt das Laden mehrerer Anzeigen desselben Formats an demselben Chartboost-Standort.
  • Wird die Prämie nicht auf der AdMob- oder Ad Manager-Benutzeroberfläche überschrieben, entspricht der Prämienwert für Anzeigen mit Prämie jetzt dem Wert, der in der Chartboost-Benutzeroberfläche angegeben ist, statt 0.

Entwickelt und getestet mit

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

Version 8.1.0.0

  • Geprüfte Kompatibilität mit Chartboost SDK 8.1.0.
  • 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

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

Entwickelt und getestet mit

  • Google Mobile Ads SDK, Version 7.52.0.
  • Chartboost SDK Version 8.0.4.

Version 8.0.1.1

  • Das Problem, dass beim Anfordern von Banneranzeigen keine Füllungen zurückgegeben wurden, wurde behoben.

Version 8.0.1.0

  • Geprüfte Kompatibilität mit Chartboost SDK 8.0.1.
  • Die Anforderung von Banneranzeigen wird jetzt unterstützt.

Version 7.5.0.1

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

Version 7.5.0.0

  • Geprüfte Kompatibilität mit Chartboost SDK 7.5.0.
  • Der Adapter wurde aktualisiert, sodass die neue API für Anzeigen mit Prämie verwendet wird.
  • Der Adapter wurde so aktualisiert, dass mehrere Interstitial-Anfragen verarbeitet werden.
  • Für Google Mobile Ads SDK ist jetzt Version 7.42.2 oder höher erforderlich.

Version 7.3.0.0

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

Version 7.2.0.1

  • Der adapterDidCompletePlayingRewardBasedVideoAd:-Callback wurde dem Adapter hinzugefügt.

Version 7.2.0.0

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

Version 7.1.2.0

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

Version 7.1.1.0

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

Version 7.1.0.0

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

Version 7.0.4.0

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

Version 7.0.3.0

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

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

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

Version 7.0.0.0

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

Version 6.6.3.0

  • Geprüfte Kompatibilität mit Chartboost SDK 6.6.3.
  • Die Unterstützung für „armv7s“ wurde entfernt Architektur.
  • Es wurde ein Fehler behoben, bei dem Publisher beim Importieren in Swift ein Kompilierungsproblem erlebten. ChartboostAdapter.framework wurde als Modul importiert, das nicht modulare Chartboost SDK

Version 6.6.2.0

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

Version 6.6.1.0

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

Version 6.6.0.0

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

Version 6.5.2.1

  • Bitcode-Unterstützung wurde aktiviert.
  • Der Chartboost-Adapter wird jetzt als Framework bereitgestellt.
  • Wenn Sie ChartboostAdapter.framework in Ihr Projekt importieren möchten, müssen Sie Folgendes festlegen: Allow Non-modular Includes in Framework Modules bis YES im Rahmen des Build-Programms Einstellungen des Ziels.

Version 6.5.2.0

  • Versionsbenennungssystem wurde geändert zu [Chartboost SDK-Version].[adapter-Patchversion].
  • Aktualisierung des mindestens erforderlichen Chartboost SDK auf Version 6.5.1.
  • Aktualisierung des mindestens erforderlichen Google Mobile Ads SDK auf Version 7.10.1.
  • Ein Fehler zur Unterstützung mehrerer Chartboost-Anzeigenplatzierungen wurde behoben.
  • Apps erhalten jetzt den interstitialWillDismissScreen:-Callback, wenn der Interstitial-Anzeige wird gleich geschlossen.
  • Apps erhalten jetzt den rewardBasedVideoAdDidOpen:-Callback, wenn eine prämienbasierte Videoanzeige wird geöffnet.

Version 1.1.0

  • Die Chartboost-Anzeigenplatzierung wurde aus den Chartboost-Extras entfernt. Anzeigenplatzierung ist jetzt in der AdMob-Konsole beim Konfigurieren von Chartboost für die Vermittlung angegeben.

Version 1.0.0

  • Erste Version Videoanzeigen und Interstitial-Anzeigen auf Prämienbasis werden unterstützt.