Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。

将 Chartboost 与中介集成

请选择平台： Android iOS Unity Flutter Android（旧版）

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

支持的集成和广告格式

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

集成
出价
瀑布流
格式
开屏广告
横幅广告
插页式广告
已获得奖励
插页式激励广告
原生

前提条件

在继续操作之前，请验证以下事项：

最新 Google Mobile Ads Unity Plugin 版本。
Unity 编辑器 2019.4 或更高版本。
如需在 Android 上部署，则要求：
- Android API 级别 24 或更高级别。
如需在 iOS 上部署，则要求：
- iOS 部署目标版本为 13.0 或更高版本。
一个配置了 Google Mobile Ads Unity Plugin 的有效 Unity 项目。如需了解详情，请参阅设置 Google Mobile Ads Unity Plugin。

设置中介。

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

Chartboost 应用信息中心

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

应用管理

填写表单的其余部分，然后点击添加应用按钮以完成应用。

新应用表单

应用创建完成后，系统会将您定向到其信息中心。记下应用的 App ID 和 App Signature。

Android

应用设置

iOS

应用设置

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

Chartboost 中介信息中心

前往资源 > API Explorer 标签页，记下身份验证部分下的用户 ID 和用户签名。

Chartboost API Explorer

更新 app-ads.txt

应用授权卖方 (app-ads.txt) 是一项 IAB Tech Lab 计划，有助于确保只通过您认定的授权渠道销售您的应用广告资源。为避免损失大量广告收入，您需要实施 app-ads.txt 文件。如果您尚未创建 app-ads.txt 文件，请为 Ad Manager 创建一个 app-ads.txt 文件。

如需为 Chartboost 实现 app-ads.txt，请参阅 app-ads.txt。

启用测试模式

您可以在应用中启用测试模式，方法是从 Chartboost 界面中前往应用管理标签页，从列表中选择您的应用，然后点击修改应用设置。

Android

修改应用设置

iOS

修改应用设置

您可以在应用的设置中开启应用的测试模式。

Chartboost 测试模式

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

在您能够接收 Chartboost 测试广告后，您的应用将被列入 Chartboost 的发布商应用审核。为了让 Chartboost 上的创收功能正常运作，发布商应用审核需要获得 Chartboost 的批准。

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

为广告单元配置中介设置

Android

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

iOS

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

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

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

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

OpenUPM-CLI

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

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

OpenUPM

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

在 Scoped Registries 标签页下，将 OpenUPM 添加为限定范围的注册表，并提供以下详细信息：

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

OpenUPM 详情

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

Unity 注册表

选择 Google Mobile Ads Chartboost Mediation 软件包，然后点击 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)、英国和瑞士境内的用户披露相关信息；在法律有相应要求的情况下，您必须征得他们的同意才能使用 Cookie 或其他本地存储方式；您还必须征得他们的同意才能收集、分享和使用个人数据来投放个性化广告。此政策反映了欧盟《电子隐私指令》和《一般数据保护条例》(GDPR) 的要求。您要负责验证用户意见是否已传播到中介链中的每个广告来源。

美国州级隐私保护法律

美国州级隐私权法要求，用户有权选择退出“出售”其“个人信息”（该法律对这些术语进行了定义），“出售”方须在首页醒目位置提供“不出售我的个人信息”链接，以供这些用户选择退出。美国州级隐私保护法律合规性指南可让您为 Google 广告投放启用受限的数据处理，但 Google 无法将此设置应用于您的中介链中的每个广告联盟。因此，您必须确定中介链中可能参与个人信息出售的每个广告联盟，并遵循这些广告联盟的指南来确保合规性。

以下示例代码将数据使用情况意见征求设为 OptInSale。如果您选择调用此方法，建议您在使用 Google Mobile Ads Unity Plugin 请求广告之前进行调用。

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 点击错误。如需了解详情，请参阅代码。