本指南将向您介绍如何使用 Google 移动广告 SDK 加载和展示 使用 从 Chartboost 投放的广告 AdMob 中介、 包括广告瀑布流集成其中介绍了如何将 Chartboost 添加到 中介配置,以及如何集成 Chartboost SDK 和适配器 iOS 应用
支持的集成和广告格式
Chartboost 的中介适配器具有以下功能:
集成 | |
---|---|
出价 | |
瀑布 | |
表现形式 | |
横幅 | |
插页式广告 | |
激励广告 | |
原生 |
要求
- iOS 部署目标为 12.0 或更高版本
最新版 Google 移动广告 SDK
完成中介流程 入门指南
第 1 步:在 Chartboost 界面中设置配置
注册 Chartboost 账号并 在您的账号通过验证后,请登录。 然后,转到应用管理标签页。
点击 Add new app 按钮以创建您的应用。
填写表单的其余部分,然后点击添加应用按钮以完成创建 应用。
创建应用后,系统会将您定向到应用的信息中心。记录 应用的应用 ID 和应用签名。
Android
iOS
AdMob 要求提供 Chartboost 用户 ID 和 用于设置 AdMob 广告的用户签名 单元 ID。如需查找这些参数,请在以下位置点击 Chartboost 中介: Chartboost 界面。
导航到资源 >API Explorer 标签页中,并记下您的 用户 ID 和用户签名,位于身份验证部分下。
开启测试模式
您可以前往应用管理部分,为应用启用测试模式 标签,从列表中选择您的应用,然后点击 修改应用设置。
Android
iOS
在应用的设置中,您可以开启/关闭测试模式。
启用测试模式后,您就可以使用所创建的广告单元 ID 来请求广告 并收到一个 Chartboost 测试广告。
在您能够收到 Chartboost 测试广告后,您的应用将会放置 发布在 Chartboost 的发布商应用审核上。 为了让 Chartboost 上的创收功能正常发挥作用,发布商应用审核将 需要经过 Chartboost 批准。
第 2 步:在界面中设置 Chartboost 需求 AdMob
为广告单元配置中介设置
您需要将 Chartboost 添加到广告单元的中介配置。
首先,登录您的 AdMob 帐号。接下来,前往中介标签页。如果您想修改现有的中介组,请点击该中介组的名称进行修改,然后直接跳转到添加 Chartboost 作为广告来源。
要创建新的中介组,请选择创建中介组。
输入您的广告格式和平台,然后点击继续。
为中介组命名,然后选择要定位到的地理位置。接下来,将中介组的状态设置为已启用,然后点击添加广告单元。
将此中介组与您的一个或多个现有AdMob 广告单元相关联。接着,点击完成。
现在,您应该会看到广告单元卡片内填充了您选择的广告单元:
添加为广告来源 Chartboost
在广告来源部分的广告瀑布流卡片下,选择添加广告来源。然后选择 Chartboost。
选择 Chartboost 并启用优化开关。输入在上一部分获得的 User ID and User Signature,为Chartboost设置广告来源优化。 然后,为Chartboost 输入有效每千次展示费用值,并点击继续。如果您已有 Chartboost的映射,则可以选择它。否则,请点击添加映射。
接下来,输入在上一部分中获取的 App ID, App Signature and Ad Location。接着,点击完成。
Chartboost 广告位置(已命名的位置)是一些简单的名称,用于表示您要在应用中展示广告的位置。AdMob 会向设置中指定的位置发送请求。请求发送后,Chartboost 会将该位置信息添加到其平台中,以用于生成报告。用户还可以先直接在 Chartboost 平台中创建新的广告位置,然后再在游戏中调用他们。
在 Chartboost 界面中,通过点击 Advanced Settings,您可以在 Basic Settings 页面中查看您的广告位置。如需了解详情,请参阅 Chartboost 的命名位置指南。
最后,点击 Done(完成)以将 Chartboost 添加为广告来源,然后点击 Save(保存)。
将 Chartboost 添加到 GDPR 和美国州级法规广告合作伙伴列表
第 3 步:导入 Chartboost SDK 和适配器
使用 CocoaPods(推荐)
将以下代码行添加到项目的 Podfile 中:
pod 'GoogleMobileAdsMediationChartboost'
在命令行中运行以下命令:
pod install --repo-update
手动集成
下载最新版本的 Chartboost SDK 和链接 Chartboost.framework 和 CHAMoatMobileAppKit.framework。
通过更新日志中的下载链接下载最新版本的 Chartboost 适配器, 在您的项目中关联 ChartboostAdapter.framework。
将以下框架添加到您的项目中:
StoreKit
Foundation
CoreGraphics
WebKit
AVFoundation
UIKit
第 4 步:在 Chartboost SDK 上实现隐私设置
欧盟地区用户意见征求和 GDPR
根据 Google 欧盟地区用户意见征求 政策,因此您必须确保向 Google 披露特定信息,并且 针对欧洲经济区 (EEA) 境内用户就 设备标识符和个人数据的使用。此政策反映了 欧盟《电子隐私指令》和《一般数据保护条例》的要求 条例 (GDPR)。在征求用户意见时,您必须指明每个广告联盟 可能会收集、接收或使用个人数据的中介链 提供有关每个网络使用情况的信息。Google 目前无法 自动将用户的意见选择传递给此类广告网络。
在 SDK 版本 8.2.0 中,Chartboost 添加了 addDataUseConsent
方法。通过
以下示例代码将同意情况设为 CHBGDPRConsentNonBehavioral
。如果
选择调用此方法时,建议您在调用
通过 Google 移动广告 SDK 请求广告。
Swift
let dataUseConsent = CHBDataUseConsent.GDPR(CHBDataUseConsent.GDPR.Consent.nonBehavioral)
Chartboost.addDataUseConsent(dataUseConsent)
Objective-C
CHBGDPRDataUseConsent *dataUseConsent = [CHBGDPRDataUseConsent gdprConsent:CHBGDPRConsentNonBehavioral];
[Chartboost addDataUseConsent:dataUseConsent];
查看 Chartboost 的 GDPR 文章及其 iOS 隐私保护方法 了解更多详细信息以及每种方法中提供的值。
美国州级隐私保护法律
美国州级隐私保护法 要求向用户提供 来退出“促销”的“个人信息”(因为法律规定 这些条款),同时在其页面上以醒目方式显示“Do Not Sell My Personal 信息”请点击“销售”链接主页。通过 美国州/省/自治区/直辖市隐私权 法律合规指南提供了一项新功能, 受限的数据处理 用于 Google 广告投放,但 Google 无法对每个广告应用此设置 您的中介链中的广告联盟。因此,您必须找出每个广告联盟 可能参与销售个人数据或 并遵循每个广告联盟提供的指导, 合规性。
在 SDK 版本 8.2.0 中,Chartboost 添加了 addDataUseConsent
方法。通过
以下示例代码将同意情况设为 CHBCCPAConsentOptInSale
。如果您
选择调用此方法,建议您先调用,然后再请求
Google 移动广告 SDK。
Swift
let dataUseConsent = CHBDataUseConsent.CCPA(CHBDataUseConsent.CCPA.Consent.optInSale)
Chartboost.addDataUseConsent(dataUseConsent)
Objective-C
CHBCCPADataUseConsent *dataUseConsent = [CHBCCPADataUseConsent ccpaConsent:CHBCCPAConsentOptInSale];
[Chartboost addDataUseConsent:dataUseConsent];
查看 Chartboost 的 CCPA 文章及其 iOS 隐私保护方法 了解更多详细信息以及每种方法中提供的值。
错误代码
如果适配器无法接收来自 Chartboost 的广告,您可以检查
使用
GADResponseInfo.adNetworkInfoArray
分为以下类:
GADMAdapterChartboost
GADMediationAdapterChartboost
以下是 Chartboost 适配器抛出的代码和附带消息 当广告加载失败时:
错误代码 | 原因 |
---|---|
101 | 界面中配置的 Chartboost 服务器参数 AdMob 缺失/无效。 |
102 | Chartboost SDK 返回了初始化错误。 |
103 | Chartboost 广告在显示时未进行缓存。 |
104 | 请求的广告尺寸与 Chartboost 支持的横幅广告尺寸不匹配。 |
105 | 设备的操作系统版本低于 Chartboost SDK 支持的最低操作系统版本。 |
200-299 | Chartboost SDK 缓存错误。请参阅代码 了解详情。 |
300-399 | Chartboost SDK 会显示错误。请参阅代码 了解详情。 |
400-499 | Chartboost SDK 点击错误。请参阅代码 了解详情。 |
Chartboost iOS 中介适配器更新日志
版本 9.7.0.0
- 已验证与 Chartboost SDK 9.7.0 版本的兼容性。
构建和测试时所用平台:
- Google 移动广告 SDK 11.2.0 版。
- Chartboost SDK 版本 9.7.0。
版本 9.6.0.1
- 现在要求最低 iOS 版本为 12.0。
- 现在需要 Google 移动广告 SDK 11.0 或更高版本。
- 在
ChartboostAdapter.xcframework
的框架中添加了Info.plist
。
构建和测试时所用平台:
- Google 移动广告 SDK 11.0.1 版。
- Chartboost SDK 版本 9.6.0。
版本 9.6.0.0
- 已验证与 Chartboost SDK 9.6.0 版本的兼容性。
- 将已弃用的
GADMobileAds.sharedInstance.sdkVersion
方法替换为了GADMobileAds.sharedInstance.versionNumber
。 - 添加了
GADMediationInterstitialAd
实现。
构建和测试时所用平台:
- Google 移动广告 SDK 10.14.0 版。
- Chartboost SDK 版本 9.6.0。
版本 9.5.1.0
- 已验证与 Chartboost SDK 9.5.1 版的兼容性。
构建和测试时所用平台:
- Google 移动广告 SDK 10.12.0 版。
- Chartboost SDK 9.5.1 版。
版本 9.4.0.0
- 已验证与 Chartboost SDK 9.4.0 版本的兼容性。
构建和测试时所用平台:
- Google 移动广告 SDK 10.7.0 版。
- Chartboost SDK 版本 9.4.0。
版本 9.3.1.0
- 已验证与 Chartboost SDK 9.3.1 版的兼容性。
构建和测试时所用平台:
- Google 移动广告 SDK 10.7.0 版。
- Chartboost SDK 9.3.1 版。
版本 9.3.0.0
- 已验证与 Chartboost SDK 9.3.0 版本的兼容性。
- 现在要求最低 iOS 版本为 11.0。
- 现在需要 Google 移动广告 SDK 10.4.0 或更高版本。
构建和测试时所用平台:
- Google 移动广告 SDK 10.4.0 版。
- Chartboost SDK 版本 9.3.0。
版本 9.2.0.0
- 移除了
ChartboostAdapter
头文件中的GADMChartboostExtras
导入。 - 已验证与 Chartboost SDK 9.2.0 版本的兼容性。
- 现在需要 Google 移动广告 SDK 10.0.0 或更高版本。
- 移除了对
armv7
架构的支持。 - 现在要求 iOS 最低版本为 11.0。
构建和测试时所用平台:
- Google 移动广告 SDK 10.0.0 版。
- Chartboost SDK 版本 9.2.0。
版本 9.1.0.0
- 已验证与 Chartboost SDK 9.1.0 版本的兼容性。
构建和测试时所用平台:
- Google 移动广告 SDK 9.11.0 版。
- Chartboost SDK 版本 9.1.0。
版本 9.0.0.0
- 已验证与 Chartboost SDK 9.0.0 版本的兼容性。
- 已验证与 Google 移动广告 SDK 9.10.0 版兼容。
- 更新了适配器以使用
didRewardUser
API。 - 现在需要 Google 移动广告 SDK 9.8.0 或更高版本。
构建和测试时所用平台:
- Google 移动广告 SDK 9.10.0 版。
- Chartboost SDK 版本 9.0.0。
版本 8.5.0.2
- 已验证与 Google 移动广告 SDK 9.0.0 版兼容。
- 现在需要 Google 移动广告 SDK 9.0.0 或更高版本。
构建和测试时所用平台:
- Google 移动广告 SDK 9.0.0 版。
- Chartboost SDK 8.5.0 版。
版本 8.5.0.1.0
- 已验证与 CocoaPods 中的 Chartboost SDK 8.5.0(引用版本 8.5.0.1)兼容。
构建和测试所用的
- Google 移动广告 SDK 8.13.0 版。
- Chartboost SDK 8.5.0 版。
版本 8.5.0.0
- 已验证与 Chartboost SDK 8.5.0 的兼容性。
构建和测试所用的
- Google 移动广告 SDK 8.12.0 版。
- Chartboost SDK 8.5.0 版。
版本 8.4.2.0
- 已验证与 Chartboost SDK 8.4.2 的兼容性。
构建和测试所用的
- Google 移动广告 SDK 8.6.0 版。
- Chartboost SDK 版本 8.4.2。
版本 8.4.1.1
- 放宽了对 Google 移动广告 SDK 8.0.0 或更高版本的依赖。
构建和测试所用的
- Google 移动广告 SDK 8.4.0 版。
- Chartboost SDK 版本 8.4.1。
版本 8.4.1.0
- 已验证与 Chartboost SDK 8.4.1 的兼容性。
- 现在需要 Google 移动广告 SDK 8.1.0 或更高版本。
构建和测试所用的
- Google 移动广告 SDK 8.1.0 版。
- Chartboost SDK 版本 8.4.1。
版本 8.4.0.1
- 添加了标准化的适配器错误代码和消息。
- 将适配器更新为使用
.xcframework
格式。 - 现在需要 Google 移动广告 SDK 8.0.0 或更高版本。
构建和测试所用的
- Google 移动广告 SDK 8.0.0 版。
- Chartboost SDK 版本 8.4.0。
版本 8.4.0.0
- 已验证与 Chartboost SDK 8.4.0 的兼容性。
- 现在需要 Google 移动广告 SDK 7.68.0 或更高版本。
构建和测试所用的
- Google 移动广告 SDK 7.68.0 版。
- Chartboost SDK 版本 8.4.0。
版本 8.3.1.0
- 已验证与 Chartboost SDK 8.3.1 的兼容性。
- 现在需要 Google 移动广告 SDK 7.66.0 或更高版本。
- 现在要求 iOS 最低版本为 10.0。
- 更新了适配器,以支持自适应横幅广告请求。
构建和测试所用的
- Google 移动广告 SDK 7.66.0 版。
- Chartboost SDK 版本 8.3.1。
版本 8.2.1.0
- 已验证与 Chartboost SDK 8.2.1 的兼容性。
- 现在需要 Google 移动广告 SDK 7.64.0 或更高版本。
- 现在要求 iOS 最低版本为 9.0。
构建和测试所用的
- Google 移动广告 SDK 7.64.0 版。
- Chartboost SDK 版本 8.2.1。
版本 8.2.0.0
- 已验证与 Chartboost SDK 8.2.0 的兼容性。
- 现在需要 Google 移动广告 SDK 7.61.0 或更高版本。
构建和测试所用的
- Google 移动广告 SDK 7.61.0 版。
- Chartboost SDK 版本 8.2.0。
版本 8.1.0.1
- 将要求的最低 Google 移动广告 SDK 版本更新为 7.60.0。
- 更新了适配器以使用 Chartboost 的新 API,并移除了已废弃的 API。
- Adapter 现在支持使用同一 Chartboost 位置加载相同格式的多个广告。
- 如果未在 AdMob 或 Ad Manager 界面中替换奖励,则激励广告的奖励值现在为 Chartboost 界面中指定的值,而非
0
。
构建和测试所用的
- Google 移动广告 SDK 7.60.0 版。
- Chartboost SDK 版本 8.1.0。
版本 8.1.0.0
- 已验证与 Chartboost SDK 8.1.0 的兼容性。
- 将要求的最低 Google 移动广告 SDK 版本更新为 7.59.0。
- 取消了对 i386 架构的支持。
构建和测试所用的
- Google 移动广告 SDK 7.59.0 版。
- Chartboost SDK 版本 8.1.0。
版本 8.0.4.0
- 已验证与 Chartboost SDK 8.0.4 的兼容性。
构建和测试所用的
- Google 移动广告 SDK 7.52.0 版。
- Chartboost SDK 版本 8.0.4。
版本 8.0.1.1
- 修复了请求横幅广告时不返回任何填充操作的问题。
版本 8.0.1.0
- 已验证与 Chartboost SDK 8.0.1 的兼容性。
- 添加了对请求横幅广告的支持。
7.5.0.1 版
- 添加了用于正确初始化 Chartboost SDK 的代码。
7.5.0.0 版
- 已验证与 Chartboost SDK 7.5.0 的兼容性。
- 更新了适配器,以使用新的激励广告 API。
- 更新了适配器,可处理多个插页式广告请求。
- 现在需要 Google 移动广告 SDK 7.42.2 或更高版本。
7.3.0.0 版
- 已验证与 Chartboost SDK 7.3.0 的兼容性。
7.2.0.1 版
- 向适配器添加了
adapterDidCompletePlayingRewardBasedVideoAd:
回调。
7.2.0.0 版
- 已验证与 Chartboost SDK 7.2.0 的兼容性。
7.1.2.0 版
- 已验证与 Chartboost SDK 7.1.2 的兼容性。
7.1.1.0 版
- 已验证与 Chartboost SDK 7.1.1 的兼容性。
7.1.0.0 版
- 已验证与 Chartboost SDK 7.1.0 的兼容性。
版本 7.0.4.0
- 已验证与 Chartboost SDK 7.0.4 的兼容性。
版本 7.0.3.0
- 已验证与 Chartboost SDK 7.0.3 的兼容性。
7.0.2.0 版
- 已验证与 Chartboost SDK 7.0.2 的兼容性。
- 添加了对两个新的 Chartboost 错误代码的支持。
7.0.1.0 版
- 已验证与 Chartboost SDK 7.0.1 的兼容性。
7.0.0.0 版
- 已验证与 Chartboost SDK 7.0.0 的兼容性。
版本 6.6.3.0
- 已验证与 Chartboost SDK 6.6.3 的兼容性。
- 移除了对“armv7s”的支持架构。
- 修复了以下 bug:导入时发布商在 Swift 中遇到编译问题
ChartboostAdapter.framework
作为导入非模块化模块的模块 Chartboost SDK。
版本 6.6.2.0
- 已验证与 Chartboost SDK 6.6.2 的兼容性。
版本 6.6.1.0
- 已验证与 Chartboost SDK 6.6.1 的兼容性。
版本 6.6.0.0
- 已验证与 Chartboost SDK 6.6.0 的兼容性。
版本 6.5.2.1
- 已启用位码支持。
- 现在以框架的形式分发 Chartboost 适配器。
- 如需在项目中导入
ChartboostAdapter.framework
,请务必将 从Allow Non-modular Includes in Framework Modules
更改为YES
(在 build 下) 目标的设置。
版本 6.5.2.0
- 已将版本命名系统更改为 [Chartboost SDK version].[adapter patch version]。
- 将所需的最低 Chartboost SDK 更新到了 v6.5.1。
- 将要求的最低 Google 移动广告 SDK 更新到了 v7.10.1。
- 修复了一个错误,以支持多个 Chartboost 广告位置。
- 现在,在调用
interstitialWillDismissScreen:
即将关闭插页式广告。 - 现在,当基于奖励的奖励发生时,应用会获得
rewardBasedVideoAdDidOpen:
回调 视频广告。
版本 1.1.0
- 从 Chartboost extra 中移除了 Chartboost 广告位置。“广告位置”现为 (在 AdMob 控制台中为中介配置 Chartboost 时指定)。
版本 1.0.0
- 初始版本。支持基于奖励的视频广告和插页式广告。