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 zur 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.
Klicken Sie auf die Schaltfläche Neue App hinzufügen, um Ihre App zu erstellen.
Füllen Sie den Rest des Formulars aus und klicken Sie auf die Schaltfläche Add App (App hinzufügen), um Ihre Anwendung fertigzustellen.
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
iOS
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.
Wechseln Sie zum Tab Ressourcen > API Explorer und notieren Sie sich im Abschnitt Authentifizierung Ihre Nutzer-ID und Ihre Nutzersignatur.
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
iOS
In den Einstellungen Ihrer App können Sie den Testmodus ein-/ausschalten.
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
CocoaPods verwenden (empfohlen)
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
Einwilligung der Nutzer in der EU und DSGVO
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 .
Datenschutzgesetze von US-Bundesstaaten
USA Datenschutzgesetze von Bundesstaaten müssen Sie den Nutzern das Angebot des Angebots ihrer "personenbezogenen Daten" (wie das Gesetz definiert dieser Nutzungsbedingungen), wobei die Widerspruchsmöglichkeit über einen gut sichtbaren "Do Not Sell My Personal"-Artikel Informationen“ auf den Link „Verkauf“ die Startseite der Party. Die USA Datenschutz für Staaten 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 .
Fehlercodes
Wenn der Adapter keine Anzeige von Chartboost erhält, können Sie auf der
zugrunde liegender Fehler aus der Anzeigenantwort
GADResponseInfo.adNetworkInfoArray
in den 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 |
---|---|
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 vonChartboostAdapter.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 durchGADMobileAds.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:
- Google Mobile Ads SDK Version 10.0.0.
- 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 so aktualisiert, dass 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
bisYES
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.