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.
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 Ihre App erstellt wurde, werden Sie zum Dashboard weitergeleitet. Notieren Sie sich die App-ID und die App-Signatur Ihrer App.
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.
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).
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 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
Mit CocoaPods (empfohlen)
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
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. 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 inChartboostAdapter.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 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
- 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 KopfdateiChartboostAdapter
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 ZielsAllow Non-modular Includes in Framework Modules
aufYES
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.