此页面由 Cloud Translation API 翻译。

将 Chartboost 与中介集成

本指南介绍了如何使用 Google 移动广告 SDK 使用中介加载和展示来自 Chartboost 的广告，涵盖广告瀑布流集成。其中介绍了如何将 Chartboost 添加到广告单元的中介配置，以及如何将 Chartboost SDK 和适配器集成到 Unity 应用中。

支持的集成和广告格式

适用于 Chartboost 的 Ad Manager 中介适配器具有以下功能：

集成
出价
瀑布
表现形式
横幅
插页式广告
激励广告

要求

Unity 4 或更高版本
最新版 Google 移动广告 SDK
如需在 Android 上部署，请执行以下操作：
- Android API 级别 21 或更高级别
要在 iOS 上部署，需具备以下条件：
- iOS 部署目标为 12.0 或更高版本
使用 Google 移动广告 SDK 配置的有效 Unity 项目。如需了解详情，请参阅开始使用。
完成中介入门指南

第 1 步：在 Chartboost 界面中设置配置

Chartboost 应用信息中心

点击添加新应用按钮以创建应用。

应用管理

填写表单的其余部分，然后点击添加应用按钮以最终确定应用。

新应用表单

创建应用后，您将进入其信息中心。记下应用的应用 ID 和应用签名。

Android

应用设置

iOS

应用设置

Ad Manager 要求您提供 Chartboost 用户 ID 和 用户签名，才能设置 Ad Manager 广告单元 ID。您可以在 Chartboost 界面中点击 Chartboost 中介，找到这些参数。

Chartboost Mediation 信息中心

前往 Resources > API Explorer 标签页，记下 Authentication 部分下的 User ID 和 User Signature。

Chartboost API Explorer

开启测试模式

如需为应用启用测试模式，请前往 Chartboost 界面的应用管理标签页，从列表中选择您的应用，然后点击修改应用设置。

Android

修改应用设置

iOS

修改应用设置

您可以在应用的设置中为应用切换测试模式。

Chartboost 测试模式

启用测试模式后，您可以使用之前创建的广告单元 ID 请求广告，并接收 Chartboost 测试广告。

在您能够接收 Chartboost 测试广告后，您的应用将被列入 Chartboost 的发布商应用审核名单。若要在 Chartboost 上创收，发布商应用审核需要获得 Chartboost 批准。

第 2 步：在 Ad Manager 界面中设置 Chartboost 需求来源

为广告单元配置中介设置

Android

如需查看相关说明，请参阅 Android 指南中的第 2 步。

iOS

如需了解相关说明，请参阅 iOS 指南中的第 2 步。

将 Chartboost 添加到 GDPR 和美国州级法规广告合作伙伴名单

请按照 GDPR 设置和美国州级法规设置中的步骤，将 Chartboost 添加到 Ad Manager 界面中的 GDPR 和美国州级法规广告合作伙伴名单中。

第 3 步：导入 Chartboost SDK 和适配器

OpenUPM-CLI

如果您已安装 OpenUPM-CLI，则可以从项目的根目录运行以下命令，将适用于 Unity 的 Google 移动广告 Chartboost 中介插件安装到您的项目中：

openupm add com.google.ads.mobile.mediation.chartboost

OpenUPM

在 Unity 项目编辑器中，依次选择 Edit（修改）> Project Settings（项目设置）> Package Manager（软件包管理器），以打开 Unity Package Manager Settings（Unity Package Manager 设置）。

在受限注册库标签页下，将 OpenUPM 添加为受限注册库，并提供以下详细信息：

名称：OpenUPM
URL：https://package.openupm.com
范围：com.google

OpenUPM 详情

然后，依次前往 Window > Package Manager 以打开 Unity Package Manager，然后从下拉菜单中选择 My Registries。

Unity 注册表

选择 Google 移动广告 Chartboost 中介软件包，然后点击 Install。

通过 OpenUPM 安装

Unity 软件包

从更新日志中的下载链接下载适用于 Chartboost 的最新版 Google 移动广告中介插件，然后从 ZIP 文件中提取 GoogleMobileAdsChartboostMediation.unitypackage。

在 Unity 项目编辑器中，依次选择 Assets > Import Package > Custom Package，然后找到您下载的 GoogleMobileAdsChartboostMediation.unitypackage 文件。确保选择所有文件，然后点击 Import（导入）。

从 Unity 导入

然后，依次选择 Assets > External Dependency Manager > Android Resolver > Force Resolve。外部依赖项管理器库将从头开始执行依赖项解析，并将声明的依赖项复制到 Unity 应用的 Assets/Plugins/Android 目录中。

强制解析

第 4 步：在 Chartboost SDK 中实现隐私设置

欧盟地区意见征求和 GDPR

根据 Google 《欧盟地区用户意见征求政策》，您必须确保向位于欧洲经济区 (EEA) 的用户披露相关信息并征得他们的同意，以便使用设备标识符和个人数据。此政策反映了欧盟《电子隐私指令》和《一般数据保护条例》(GDPR) 的要求。在征求用户意见时，您必须指明中介链中可能会收集、接收或使用个人数据的每个广告联盟，并提供有关每个广告联盟使用情况的信息。Google 目前无法自动将用户的意见征求选择传递给此类广告联盟。

适用于 Chartboost 版本 3.1.0 的 Google 移动广告中介插件包含 Chartboost.AddDataUseConsent() 方法。以下示例代码将数据使用意见征求设置为 NonBehavioral。如果您选择调用此方法，建议您先调用此方法，然后再使用 Google 移动广告 SDK 请求广告。

using GoogleMobileAds.Api.Mediation.Chartboost;
// ...

Chartboost.AddDataUseConsent(CBGDPRDataUseConsent.NonBehavioral);

美国州级隐私保护法律

根据美国各州隐私权法的规定，用户有权选择拒绝出售其“个人信息”（该法律对这些术语进行了定义）。“出售”方须在首页醒目位置提供“不出售我的个人信息”链接，以供这些用户选择。美国州级隐私保护法律合规指南提供了为 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（瀑布流）广告来源启用单一广告来源测试。

可选步骤

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	在 Ad Manager 界面中配置的 Chartboost 服务器参数缺失/无效。
104	Chartboost 插页式广告或激励广告尚未准备好展示。

iOS

错误代码	原因
101	在 Ad Manager 界面中配置的 Chartboost 服务器参数缺失/无效。
102	Chartboost SDK 返回了初始化错误。
103	Chartboost 广告不会在展示时缓存。
104	请求的广告尺寸与 Chartboost 支持的横幅广告尺寸不符。
105	设备的操作系统版本低于 Chartboost SDK 支持的最低操作系统版本。
200-299	Chartboost SDK 缓存错误。如需了解详情，请参阅代码。
300-399	Chartboost SDK 显示错误。如需了解详情，请参阅代码。
400-499	Chartboost SDK 点击错误。如需了解详情，请参阅代码。