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. Dort erfahren Sie, 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:

Voraussetzungen

• iOS-Bereitstellungsziel 12.0 oder höher

• Neueste Version des Google Mobile Ads SDK

• Mediation abschließen 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 die App erstellt wurde, werden Sie zum Dashboard weitergeleitet. Notieren Sie sich die App-ID und die App-Signatur Ihrer App.

Für die Einrichtung der Ad Manager-Anzeigenblock-ID sind die Nutzer-ID und die Nutzersignatur von Chartboost erforderlich. Diese Parameter findest du in der Chartboost-Benutzeroberfläche unter Chartboost-Vermittlung.

Rufen Sie den Tab Ressourcen > API Explorer auf und notieren Sie sich Ihre Nutzer-ID und Nutzersignatur im Abschnitt Authentifizierung.

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

Vermittlungseinstellungen für Ihren Anzeigenblock konfigurieren

Melden Sie sich in Ihrem Ad Manager-Konto an.

Klicken Sie auf Auslieferung > Ertragsgruppen und dann auf die Schaltfläche Neue Ertragsgruppe.

Geben Sie einen eindeutigen Namen für die Ertragsgruppe ein, legen Sie den Status auf Aktiv fest, wählen Sie das Anzeigenformat aus und legen Sie den Inventartyp auf Mobile App fest. Wählen Sie dann unter Targeting > Inventar unter Inventar und Mobile App den Anzeigenblock aus, dem Sie die Vermittlung hinzufügen möchten.

Klicken Sie dann auf die Schaltfläche Ertragspartner hinzufügen.

Wenn du bereits einen Ertragspartner für Chartboost hast, kannst du ihn auswählen. Wählen Sie andernfalls Neuen Yield-Partner erstellen aus.

Wähle Chartboost als Werbenetzwerk aus, gib einen eindeutigen Namen ein und aktiviere Vermittlung.

Aktivieren Sie die automatische Datenerhebung und geben Sie die im vorherigen Abschnitt abgerufene Nutzer-ID und Nutzersignatur ein.

Wählen Sie als Integrationstyp SDK-Vermittlung für Mobilgeräte, als Plattform iOS und als Status Aktiv aus. Geben Sie die App-ID, die App-Signatur und die Anzeigenposition ein, die Sie im vorherigen Abschnitt abgerufen haben. Geben Sie dann einen Wert für CPM-Standardwert ein.

Chartboost-Anzeigenstandorte (benannte Standorte) sind einfache Namen, die einen Ort in Ihrer App darstellen, an dem eine Anzeige ausgeliefert werden soll. Ad Manager sendet Anfragen an den in den Einstellungen angegebenen Standort. Sobald die Anfragen gesendet wurden, fügt Chartboost den Standort zu Berichtszwecken in die Benutzeroberfläche ein.

In der Chartboost-Benutzeroberfläche kannst du deine Anzeigenflächen auf der Seite Grundlegende Einstellungen sehen, indem du auf Erweiterte Einstellungen klickst. Weitere Informationen finden Sie im Leitfaden zu benannten Standorten von Chartboost.

Klicken Sie abschließend unten auf der Seite auf Speichern.

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

Folgen Sie der Anleitung unter Einstellungen für die DSGVO und Einstellungen für die Bestimmungen von US-Bundesstaaten, um Chartboost in der Ad Manager-Benutzeroberfläche der Liste der Werbepartner für die DSGVO und die Bestimmungen von US-Bundesstaaten 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. Die 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.

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

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

Weitere Informationen und die Werte, die für die einzelnen Methoden angegeben werden können, findest du im Artikel zur DSGVO und in denDatenschutzmethoden für iOS undDatenschutzmethoden für CTV von Chartboost.

Datenschutzgesetze von US-Bundesstaaten

Gemäß den Datenschutzgesetzen von US-Bundesstaaten muss Nutzern das Recht eingeräumt werden, dem „Verkauf“ ihrer „personenbezogenen Daten“ zu widersprechen (laut gesetzlicher Definition der Begriffe „sale“ und „personal information“). Dazu muss auf der Website des „Verkäufers“ (selling party) ein gut sichtbarer Link mit dem Text „Do Not Sell My Personal Information“ (Meine personenbezogenen Daten sollen nicht verkauft werden) vorhanden sein. 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 identifizieren, das am Verkauf personenbezogener Daten beteiligt sein könnte, und die Anleitungen der einzelnen Netzwerke befolgen, um die Einhaltung der Anforderungen 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. Wenn Sie diese Methode aufrufen, sollten Sie dies vor dem Anfordern von Anzeigen über das Google Mobile Ads SDK tun.

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

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

Weitere Informationen und die Werte, die für jede Methode angegeben werden können, findest du im Artikel zu Chartboost und dem CCPA sowie in den ArtikelnDatenschutzmethoden für iOS und.

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:

Ä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

• Kompatibilität mit der Chartboost SDK-Version 9.7.0 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

• Jetzt ist mindestens iOS 12.0 erforderlich.
• Jetzt ist das Google Mobile Ads SDK 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 in der Kopfdatei ChartboostAdapter entfernt
• Kompatibilität mit Chartboost SDK Version 9.2.0 bestätigt.
• Jetzt ist das Google Mobile Ads SDK 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

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

Version 8.4.1.0

• Kompatibilität mit 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 aktualisiert, um das .xcframework-Format zu verwenden.
• 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.
• Jetzt ist das Google Mobile Ads SDK 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

• Kompatibilität mit dem Chartboost SDK 8.3.1 bestätigt.
• Jetzt ist das Google Mobile Ads SDK Version 7.66.0 oder höher erforderlich.
• Jetzt ist mindestens iOS 10.0 erforderlich.
• Der Adapter wurde aktualisiert, um Anfragen für adaptive Banner zu unterstützen.

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 über denselben Chartboost-Speicherort.
• 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 Mindestversion des Google Mobile Ads SDK wurde auf 7.59.0 aktualisiert.
• Die Unterstützung für die i386-Architektur wurde entfernt.

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

• Es wurde Code hinzugefügt, um das Chartboost SDK richtig zu initialisieren.

Version 7.5.0.0

• Kompatibilität mit Chartboost SDK 7.5.0 bestätigt.
• Der Adapter wurde aktualisiert, damit 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

• Kompatibilität mit Chartboost SDK 7.0.2 bestätigt.
• 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

• Kompatibilität mit Chartboost SDK 6.6.3 bestätigt.
• Die Unterstützung für die Architektur „armv7s“ 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

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

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 Benennungssystem für Versionen wurde in [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 abrechenbare 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 Chartboost für die Vermittlung konfiguriert wird.

Version 1.0.0

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