Esta página foi traduzida pela API Cloud Translation.

Integrar o Chartboost à mediação

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

支持的集成和广告格式

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

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

要求

Unity 4 或更高版本
最新版 Google 移动广告 SDK
在 Android 上部署
- Android API 级别 21 或更高级别
在 iOS 上部署
- iOS 部署目标为 12.0 或更高版本
使用 Google 移动广告 SDK 配置的有效 Unity 项目。如需了解详情，请参阅开始使用。
看完中介服务入门指南

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

Inscreva-se em uma conta do Chartboost e faça login depois que sua conta for verificada. Acesse a guia Gerenciamento de apps.

Painel de apps do Chartboost

Clique no botão Add new app para criar o app.

Gerenciamento de apps

Preencha o restante do formulário e clique no botão Adicionar app para finalizar o app.

Formulário do novo app

Depois que seu aplicativo for criado, você será direcionado para o painel dele. Anote o ID e a Assinatura do app.

Android

Configurações do app

iOS

Configurações do app

OAdMob requer o ID do usuário e a assinatura do usuário do Chartboost para configurar o AdMob ID do bloco de anúncios. Para encontrar esses parâmetros, clique em Mediação do Chartboost na interface do Chartboost.

Painel de mediação do Chartboost

Navegue até a guia Recursos > API Explorer e anote o ID do usuário e a Assinatura do usuário localizados na seção Autenticação.

Explorador da API Chartboost

Ativar modo de teste

Para ativar o modo de teste no app, acesse a guia Gerenciamento de apps na interface do Chartboost, selecione o app na lista e clique em Edit app settings.

Android

Editar configurações do app

iOS

Editar configurações do app

Nas configurações do app, é possível ativar ou desativar o Modo de teste.

Modo de teste do Chartboost

Quando o modo de teste está ativado, é possível solicitar anúncios usando o ID do bloco de anúncios criado anteriormente e receber um anúncio de teste do Chartboost.

Depois que você puder receber anúncios de teste do Chartboost, seu aplicativo será colocado na Publisher App Review do Chartboost. Para que a monetização no Chartboost funcione, a análise do app do editor precisa ser aprovada pelo Chartboost.

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

Definir as configurações de mediação para seu bloco de anúncios

Android

Para conferir instruções, consulte a etapa 2 no guia para Android.

iOS

Para instruções, consulte a etapa 2 no guia para iOS.

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

Siga as etapas em Configurações do GDPR e Configurações das regulamentações estaduais dos EUA para adicionar Chartboost à lista de parceiros de anúncios do GDPR e das regulamentações estaduais dos EUA na AdMob IU.

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

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

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

然后，依次选择 Assets > Play Services Resolver > Android Resolver > Force Resolve。Unity Play Services Resolver 库将从头开始执行依赖项解析，并将声明的依赖项复制到 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 步：测试实现效果

Ativar anúncios de teste

Registre seu dispositivo de teste em AdMob e ative o modo de teste na Chartboost interface.

Verificar anúncios de teste

Para verificar se você está recebendo anúncios de teste do Chartboost, ative os testes de uma única origem no Ad Inspector usando as Chartboost (Waterfall) origens de anúncios.

可选步骤

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 服务器参数 AdMob 缺失/无效。
104	Chartboost 插页式广告或激励广告尚未准备好展示。

iOS

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