本指南将向您介绍如何使用 Google 移动广告 SDK 加载和展示 使用中介功能从 Chartboost 投放广告, 包括广告瀑布流集成其中介绍了如何将 Chartboost 添加到 中介配置,以及如何集成 Chartboost SDK 和适配器 转换为 Unity 应用。
支持的集成和广告格式
Chartboost 的 Ad Manager 中介适配器具有 以下功能:
集成 | |
---|---|
出价 | |
瀑布 | |
表现形式 | |
横幅 | |
插页式广告 | |
激励广告 |
要求
- Unity 4 或更高版本
- 最新版 Google 移动广告 SDK
- 在 Android 上部署
<ph type="x-smartling-placeholder">
- </ph>
- Android API 级别 21 或更高级别
- 在 iOS 上部署
<ph type="x-smartling-placeholder">
- </ph>
- iOS 部署目标为 12.0 或更高版本
- 使用 Google 移动广告 SDK 配置的有效 Unity 项目。请参阅 如需了解详情,请开始使用。
- 完成中介流程 入门指南
第 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 需求 Ad Manager
为广告单元配置中介设置
将 Chartboost 添加到 GDPR 和美国州级法规广告合作伙伴列表中
第 3 步:导入 Chartboost SDK 和适配器
OpenUPM-CLI
如果您有 OpenUPM-CLI 安装 Google 移动广告 Chartboost, 运行以下命令,将适用于 Unity 的中介插件添加到您的项目中 从项目的根目录:
openupm add com.google.ads.mobile.mediation.chartboost
OpenUPM
在 Unity 项目编辑器中,选择 Edit(修改)>项目设置 > Package Manager 打开 Unity Package Manager 设置。
在 Scoped Registries 标签页下,将 OpenUPM 添加为作用域注册表,并执行以下操作: 以下详细信息:
- 名称:
OpenUPM
- URL:
https://package.openupm.com
- 范围:
com.google
然后,依次转到窗口 >Package Manager 打开 Unity Package Manager 和 从下拉菜单中选择 My Registries。
选择 Google 移动广告 Chartboost 中介软件包,然后 点击安装。
Unity 软件包
下载针对以下指标的最新版 Google 移动广告中介插件:
下载链接中的 Chartboost
更新日志
并提取
邮编中的 GoogleMobileAdsChartboostMediation.unitypackage
文件。
在 Unity 项目编辑器中,选择 Assets >导入软件包 >
自定义软件包,然后找到
GoogleMobileAdsChartboostMediation.unitypackage
文件。确保已选择所有文件,然后点击
导入。
然后,选择资产 >Play Services 解析器 >
Android 解析器 >Force Resolve。Unity Play Services Resolver
库将从头开始执行依赖项解析,并将
声明的依赖项的 Assets/Plugins/Android
目录
Unity 应用。
第 4 步:在 Chartboost SDK 上实现隐私设置
欧盟地区用户意见征求和 GDPR
根据 Google 欧盟地区用户意见征求 政策,因此您必须确保向 Google 披露特定信息,并且 针对欧洲经济区 (EEA) 境内用户就 设备标识符和个人数据的使用。此政策反映了 欧盟《电子隐私指令》和《一般数据保护条例》的要求 条例 (GDPR)。在征求用户意见时,您必须指明每个广告联盟 可能会收集、接收或使用个人数据的中介链 提供有关每个网络使用情况的信息。Google 目前无法 自动将用户的意见选择传递给此类广告网络。
适用于 Chartboost 3.1.0 版 Google 移动广告中介插件包含
Chartboost.AddDataUseConsent()
方法结合使用。以下示例代码设置数据的使用
同意NonBehavioral
。如果您选择调用此方法,建议您
,然后再使用 Google 移动广告 SDK 请求广告。
using GoogleMobileAds.Api.Mediation.Chartboost;
// ...
Chartboost.AddDataUseConsent(CBGDPRDataUseConsent.NonBehavioral);
美国州级隐私保护法律
美国州级隐私保护法律 要求向用户提供 来退出“促销”的“个人信息”(因为法律规定 这些条款),同时在其页面上以醒目方式显示“Do Not Sell My Personal 信息”请点击“销售”链接主页。通过 美国州/省/自治区/直辖市隐私权 法律合规指南提供了一项新功能, 受限的数据处理 用于 Google 广告投放,但 Google 无法对每个广告应用此设置 您的中介链中的广告联盟。因此,您必须找出每个广告联盟 可能参与销售个人数据或 并遵循每个广告联盟提供的指导, 合规性。
适用于 Chartboost 3.1.0 版 Google 移动广告中介插件包含
Chartboost.AddDataUseConsent()
方法结合使用。以下示例代码设置数据的使用
同意OptInSale
。如果您选择调用此方法,建议您
,然后再使用 Google 移动广告 SDK 请求广告。
using GoogleMobileAds.Api.Mediation.Chartboost;
// ...
Chartboost.AddDataUseConsent(CBCCPADataUseConsent.OptInSale);
第 5 步:添加所需的代码
Android
Chartboost 集成无需其他代码。
iOS
SKAdNetwork 集成
关注 Chartboost 的
文档
将 SKAdNetwork 标识符添加到项目的 Info.plist
文件中。
第 6 步:测试实现效果
启用测试广告
请务必为Ad Manager 注册您的测试设备,并在 Chartboost 界面中启用测试模式。
验证测试广告
如需验证您收到的是来自Chartboost的测试广告,请使用相应广告来源在广告检查器中启用单一广告来源测试。 Chartboost (Waterfall)
可选步骤
Android
权限
为了获得最佳性能,Chartboost 建议添加以下可选
对应用的 AndroidManifest.xml
文件的权限:
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
iOS
iOS 集成无需执行额外步骤。
错误代码
如果适配器无法从 Chartboost 接收广告,
发布商可以使用
ResponseInfo
,位于以下类下:
Android
com.google.ads.mediation.chartboost.ChartboostAdapter
com.google.ads.mediation.chartboost.ChartboostMediationAdapter
iOS
GADMAdapterChartboost
GADMediationAdapterChartboost
当广告加载失败时,Chartboost 适配器会抛出以下代码和随附的消息:
Android
错误代码 | 原因 |
---|---|
0-99 | Chartboost SDK 返回了错误。 |
101 | 请求的广告尺寸与 Chartboost 支持的横幅广告尺寸不匹配。 |
102 | Chartboost 一次只能在每个营业地点加载 1 个广告。 |
103 | 界面中配置的 Chartboost 服务器参数 Ad Manager 缺失/无效。 |
104 | Chartboost 插页式广告或激励广告尚未准备好展示。 |
iOS
错误代码 | 原因 |
---|---|
101 | 界面中配置的 Chartboost 服务器参数 Ad Manager 缺失/无效。 |
102 | Chartboost SDK 返回了初始化错误。 |
103 | Chartboost 广告在显示时未进行缓存。 |
104 | 请求的广告尺寸与 Chartboost 支持的横幅广告尺寸不匹配。 |
105 | 设备的操作系统版本低于 Chartboost SDK 支持的最低操作系统版本。 |
200-299 | Chartboost SDK 缓存错误。请参阅代码 了解详情。 |
300-399 | Chartboost SDK 会显示错误。请参阅代码 了解详情。 |
400-499 | Chartboost SDK 点击错误。请参阅代码 了解详情。 |
Chartboost Unity 中介插件更新日志
下一个版本
- 将
DummyClient
重命名为了PlaceholderClient
。
版本 4.6.0
- 支持 Chartboost Android 适配器版本 9.7.0.0。
- 支持 Chartboost iOS 适配器版本 9.7.0.0。
- 利用 Google 移动广告 Unity 插件 9.0.0 版进行制作和测试。
版本 4.5.0
- 支持 Chartboost Android 适配器版本 9.6.0.0。
- 支持 Chartboost iOS 适配器版本 9.6.0.0。
- 利用 Google 移动广告 Unity 插件 8.6.0 版进行制作和测试。
版本 4.4.0
- 支持 Chartboost Android 适配器版本 9.5.0.0。
- 支持 Chartboost iOS 适配器版本 9.5.1.0。
- 利用 Google 移动广告 Unity 插件 8.5.3 版进行制作和测试。
版本 4.3.0
- 支持 Chartboost Android 适配器版本 9.4.0.0。
- 支持 Chartboost iOS 适配器版本 9.4.0.0。
- 利用 Google 移动广告 Unity 插件 8.5.0 版进行制作和测试。
版本 4.2.0
- 支持 Chartboost Android 适配器版本 9.3.0.0。
- 支持 Chartboost iOS 适配器版本 9.3.0.0。
- 使用 Google 移动广告 Unity 插件 8.2.0 版进行构建和测试。
版本 4.1.1
- 将适配器内容移到了
GoogleMobileAds/Mediation/Chartboost/
。 - 重构了适配器命名空间,以使用
GoogleMobileAds.Mediation.Chartboost
。 - 支持 Chartboost Android 适配器版本 9.2.1.1。
- 支持 Chartboost iOS 适配器版本 9.2.0.0。
- 利用 Google 移动广告 Unity 插件 8.1.0 版进行制作和测试。
版本 4.1.0
- 支持 Chartboost Android 适配器版本 9.2.0.0。
- 支持 Chartboost iOS 适配器版本 9.2.0.0。
- 使用 Google 移动广告 Unity 插件 7.4.1 版进行构建和测试。
版本 4.0.0
- 支持 Chartboost Android 适配器版本 9.1.1.0。
- 支持 Chartboost iOS 适配器版本 9.1.0.0。
- 使用 Google 移动广告 Unity 插件 7.3.0 版进行构建和测试。
版本 3.5.1
- 支持 Chartboost Android 适配器版本 8.4.3.1。
- 支持 Chartboost iOS 适配器版本 8.5.0.2。
- 使用 Google 移动广告 Unity 插件 7.0.2 版进行构建和测试。
版本 3.5.0
- 支持 Chartboost Android 适配器版本 8.4.2.0。
- 支持 Chartboost iOS 适配器版本 8.5.0.2。
- 使用 Google 移动广告 Unity 插件 7.0.0 版进行制作和测试。
版本 3.4.1
- 支持 Chartboost Android 适配器版本 8.3.1.0。
- 支持 Chartboost iOS 适配器版本 8.5.0.2。
- 使用 Google 移动广告 Unity 插件 7.0.0 版进行制作和测试。
版本 3.4.0
版本 3.3.1
版本 3.3.0
版本 3.2.0
版本 3.1.0
- 从
Chartboost
类中移除了RestrictDataCollection()
方法。 - 添加了
AddDataUseConsent()
辅助方法,用于将 GDPR 和 CCPA 信息传递给 Chartboost。 - 支持 Chartboost Android 适配器版本 8.1.0.0。
- 支持 Chartboost iOS 适配器版本 8.2.0.0。
版本 3.0.1
版本 3.0.0
版本 2.0.1
版本 2.0.0
- 支持 Chartboost Android 适配器版本 7.5.0.0。
- 支持 Chartboost iOS 适配器版本 8.0.1.1。
版本 1.3.0
- 更新了插件以支持新的激励广告 API。
- 支持 Chartboost Android 适配器版本 7.3.1.1。
- 支持 Chartboost iOS 适配器版本 7.5.0.0。
版本 1.2.0
- 支持 Chartboost Android 适配器版本 7.3.0.0。
- 支持 Chartboost iOS 适配器版本 7.3.0.0。
版本 1.1.1
- 支持 Chartboost Android 适配器版本 7.2.0.1。
- 支持 Chartboost iOS 适配器版本 7.2.0.1。
版本 1.1.0
- 支持 Chartboost Android SDK 7.2.0 版。
- 支持 Chartboost iOS SDK 7.2.0 版。
- 添加了
Chartboost.RestrictDataCollection()
方法,以便为 Chartboost SDK 启用 GDPR 数据收集限制。
版本 1.0.0
- 第一个版本!
- 支持 Chartboost Android SDK 7.0.1 版。
- 支持 Chartboost iOS SDK 7.1.2 版。