In diesem Leitfaden erfahren Sie, wie Sie das Google Mobile Ads SDK verwenden, um Anzeigen aus Chartboost mithilfe von Vermittlung und mit abfolgebasierten Integrationen zu laden und einzublenden. Sie erfahren, wie Sie Chartboost der Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und das Chartboost SDK und den Adapter in eine App einbinden.
Unterstützte Integrationen und Anzeigenformate
Der Vermittlungsadapter für Chartboost hat folgende Funktionen:
Integration | |
---|---|
Gebote | |
Wasserfall | |
Formate | |
Banner | |
Interstitial | |
Verfügbar | |
Ich bin Muttersprachler |
Voraussetzungen
- iOS-Bereitstellungsziel von 12.0 oder höher
Neuestes Google Mobile Ads SDK
Schließen Sie die Vermittlung ab. 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 neueste Version des Chartboost SDK herunter und verknüpfen Sie Chartboost.framework und CHAMoatMobileAppKit.framework in Ihrem Projekt.
Laden Sie die neueste Version des Chartboost-Adapters über den Downloadlink im Changelog 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-Richtlinie zur Einwilligung der Nutzer in der EU müssen Sie dafür sorgen, dass Nutzer im Europäischen Wirtschaftsraum (EWR) bestimmte Informationen zur Verwendung von Gerätekennungen und personenbezogenen Daten erhalten und deren Einwilligungen eingeholt werden. 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 alle Werbenetzwerke in Ihrer Vermittlungskette angeben, die personenbezogene Daten erheben, empfangen oder verwenden können, und Informationen zur Nutzung der einzelnen Werbenetzwerke zur Verfügung stellen. Google ist derzeit nicht in der Lage, die Einwilligungsentscheidung des Nutzers automatisch an solche Netzwerke zu übergeben.
In der SDK-Version 8.2.0 hat Chartboost die Methode addDataUseConsent
hinzugefügt. Im folgenden Beispielcode wird die Einwilligung für die Datennutzung auf CHBGDPRConsentNonBehavioral
festgelegt. Wir empfehlen, diese Methode aufzurufen, bevor Sie Anzeigen über das Google Mobile Ads SDK anfordern.
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 in den einzelnen Methoden angegeben werden können, finden Sie im DSGVO-Artikel von Chartboost und in den Datenschutzmethoden für iOS .
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. Der Leitfaden zur Einhaltung der Datenschutzgesetze von US-Bundesstaaten bietet die Möglichkeit, die eingeschränkte Datenverarbeitung für die Anzeigenbereitstellung durch Google zu aktivieren. Google kann diese Einstellung jedoch nicht auf die einzelnen Werbenetzwerke 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 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 für die 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, können Sie den zugrunde liegenden Fehler aus der Anzeigenantwort mit
GADResponseInfo.adNetworkInfoArray
in den folgenden Klassen:
GADMAdapterChartboost
GADMediationAdapterChartboost
Dies sind die Codes und zugehörigen Meldungen, 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 finden Sie in der Dokumentation zu Chartboost. |
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 Weitere Informationen finden Sie unter Code. |
300-399 | Im Chartboost SDK werden Fehler angezeigt. Weitere Informationen finden Sie unter Code. |
400-499 | Chartboost SDK-Klickfehler Weitere Informationen finden Sie unter 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 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 die Armv7s-Architektur wurde entfernt.
- Es wurde ein Fehler behoben, bei dem Publisher in Swift auf ein Kompilierungsproblem traten, wenn sie
ChartboostAdapter.framework
als Modul importiert hatten, für das ein nicht modulares Chartboost SDK importiert wurde.
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 in den Build-Einstellungen Ihres ZielsAllow Non-modular Includes in Framework Modules
aufYES
setzen.
Version 6.5.2.0
- Das System zur Benennung der Version wurde zu [Chartboost SDK version].[adapter patch version] geändert.
- 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 die Interstitial-Anzeige geschlossen wird. - Apps erhalten jetzt den
rewardBasedVideoAdDidOpen:
-Callback, wenn eine prämienbasierte Videoanzeige geöffnet wird.
Version 1.1.0
- Die Chartboost-Anzeigenplatzierung wurde aus den Chartboost-Extras entfernt. Die Anzeigenplatzierung wird jetzt in der AdMob-Konsole bei der Konfiguration von Chartboost für die Vermittlung angegeben.
Version 1.0.0
- Erste Version Videoanzeigen und Interstitial-Anzeigen auf Prämienbasis werden unterstützt.