Chartboost 集成
按照提供的分步说明,将 Chartboost 集成为 Unity LevelPlay 上的广告网络。
阅读时间4 分钟最后更新于 2 天前
本指南将逐步说明如何在 Unity LevelPlay 上将 Chartboost Live 设置为广告网络。
先决条件
- 确保将奖励广告服务、插页式广告服务或横幅广告服务正确集成到应用程序中。请参阅以下指定的于平台的指南以了解集成说明:
- Chartboost 支持使用 iOS 11+ 的设备。
步骤 1.创建 Chartboost 帐户
步骤 2.在 Chartboost 中创建应用程序
如果这是第一时间设置 Chartboost 帐户,请继续下面的操作。
- 首次登录时,选择 Start make money!。

- 定义 app Chartboost 将根据您在注册过程中提供的公司名称自动尝试在 App Store 中识别您的应用程序。如果此过程成功,只需选择要运行 LevelPlay 聚合的应用程序。如果此过程不能立即运行,则有两种选择:
- 手动搜索您的公司。

- 如果您的应用尚未在任何 Appstore 上发布,则可以手动输入详细信息。您将需要每个平台(iOS Android)的唯一 Chartboost 应用程序,就像您使用 Ironsource 帐户一样。

- 定义应用程序后,选择相关的应用程序并选择 Add Selected (x of x)。

- 如果有兴趣在 Unity LevelPlay 平台上提供 Chartboost 奖励广告服务,请选择 Rewarded Ads 并选择 Create Campaign。

- 如果有兴趣在 LevelPlay Mediation 平台上提供 Chartboost 插页式广告服务,请选择 Static Interstitial Ads 并选择 Create Campaign(s)。

- 您将被重定向到下一页,在其中找到新创建的应用程序的摘要。在此处可具体找到 app ID 和 app Signature。应将这些参数输入到网络设置模块下的 ironSource Admin 帐户中。

- 如果对 Unity LevelPlay 上的 Chartboost 奖励广告服务感兴趣,则需要关闭 Chartboost 的播放前/播放后视频消息。导航到 app,选择 Basic Settings(基本设置)> Rewarded ads(奖励广告服务)> Advanced(高级),然后会看到两个复选框。确保取消选中它们,然后选择 保存。

注册用户进程
如果您以前设置过 Chartboost 帐户,并且正在添加新的应用程序以便在 LevelPlay 的 Mediation 平台上使用,请遵循本节。
- 登录后,选择 Dashboard > Publishing > Add app。

- 定义应用程序的详细信息:
- 平台 -- -- iOS 或 Android。
- app Nickname - 用于在 Chartboost Reporting UI 中代表 app。
- Orientation - 选择“Landscape”或“Portrait”。
- 测试模式 - 选择“已禁用”。完成后,选择“保存”。 您将需要每个平台(iOS Android)的唯一 Chartboost 应用程序,就像您使用 Ironsource 帐户一样。

- 您将被重定向到下一页,在其中找到新创建的应用程序的摘要。在此处可以找到 app ID 和 app Signature。应将这些参数输入到网络设置模块下的 ironSource Admin 帐户中。

- 如果对 Unity LevelPlay 上的 Chartboost 奖励广告服务感兴趣,则需要关闭 Chartboost 的播放前/播放后视频消息。导航到 app,选择 Basic Settings(基本设置)> Rewarded ads(奖励广告服务)> Advanced(高级),然后会看到两个复选框。确保取消选中它们,然后选择 保存。

步骤 3.创建 Chartboost 发布广告系列
要通过 Unity LevelPlay 在app中投放 Chartboost 的广告库存,必须在 Chartboost 上创建发布广告系列。
- 在 Chartboost 后台中,单击左下角的 Add a Campaign,然后单击 Network Publishing。

- 在 Simple Settings 部分中,在 Ad Type 下拉选单中指明要投放的广告类型(奖励广告服务或 Static Interstitial)。如果要通过 Unity LevelPlay 同时提供奖励广告服务和插页式广告服务,必须创建两个不同的广告系列。
- 单击 **Save(保存)。**广告系列可能需要最多 20 分钟才能上线。
要为应用程序定义定向投放选项,请遵循 Chartboost 上的说明。
步骤 4.在 LevelPlay SDK Networks 模块上激活 Chartboost
Chartboost 帐户中有 5 条数据需要插入到 ironSource 网络设置模块中,才能使 Chartboost 与 ironSource 正常工作:
App ID(应用 ID) | 应用程序在 Chartboost 系统中的唯一标识符。 |
|---|---|
| 应用签名 | 用于验证指定的 Chartboost 应用程序的广告请求的唯一签名。 |
| 检测到的位置 | 应用程序中在 Chartboost 系统中检测到的指定的位置的唯一标识符符。 |
| 用户 ID | Chartboost 帐户的唯一标识符,允许 Unity LevelPlay 从 Chartboost 帐户导入性能数据以用于报告和优化。 |
| 用户签名 | Chartboost 帐户的唯一标识符,用于验证 ironSource 代表您发出的报告请求。 |
获取此信息后,必须在 LevelPlay 帐户中配置 Chartboost 的参数。正确添加上述信息后,您将能够充分利用 IronSource 聚合平台上的 Chartboost 广告库存和报告数据。
从 Chartboost 平台检索 Chartboost 的参数
- app ID & app Signature 导航回 Dashboard > app Settings > Basic Settings,然后填写列出的 app ID 和 app Signature。

- User ID & User Signature 导航到 Tools,然后从下拉菜单中选择 API Explorer。

将 Chartboost 参数配置到您的 LevelPlay 帐户
获得所有这些参数后,日志 LevelPlay 帐户。
- 转到 Monetize > Setup > SDK networks,然后选择 Manage Network。

- 从可用广告网络列表中选择 Chartboost,然后在相关字段中输入 Chartboost User ID 和 User Signature。

- 选择要使用 Chartboost 运行 LevelPlay 的 Mediation 的应用程序,然后选择 Chartboost network 旁边的 Setup。

- 在相关字段中输入 Chartboost app ID、app Signature 和 location User ID。

- 验证与 Reporting API 的集成;此列将通过 Reporting API 检查您的集成,并返回三种可能的响应:Verified、Failed 和 No Response。仔细检查您的集成和上面输入的信息;然后选择 Retry(重试),直到看到 Verified(已验证)。
步骤 5。 将 Chartboost 适配器添加到构建中
Unity Integration Manager(推荐)
完成 SDK 集成后,可使用 Unity Integration Manager 下载 Chartboost 适配器。
在 Unity 开发平台中,转到 LevelPlay > Integration Manager
如果您已经拥有最新版本的适配器,则操作按钮将更改为 " Updated " 并已禁用。
Android(手动解析)
要应用更改,请确保使用“Resolve”过程。这将根据您的选择下载所有相关工件。有关详细信息,请参阅此处的说明。
仅适用于 Proguard 用户(Android)
如果将 ProGuard 与 Chartboost 适配器结合使用,必须将以下代码添加到 ProGuard 配置中(Android Studio:proguard-rules.pro 或 Eclipse:proguard-项目.txt):
-keep 类 com.chartboost。** { *; }
Android 插件手册集成
- **下载 Chartboost Android 适配器:**从此处下载适配器。
- 将 Chartboost 文件添加到 Unity 项目 将文件导入 Assets/Plugins/Android/。
Unity 插件 iOS 手动集成
- **下载 Chartboost iOS 适配器和 SDK:**请参阅 iOS 调解网络。
- **将 Chartboost 文件添加到 Unity 项目:**将适配器和 SDK 文件导入 Assets/Plugins/iOS。我们的 Unity 插件会自动将必要的框架添加到 Xcode 项目中。
验证广告网络集成
-
验证您的广告网络与我们的 Integration Helper 集成。LevelPlay SDK 提供了一个工具,可确保已成功集成我们的 SDK 以及任何其他网络适配器。
-
使用此布尔值管理集成的聚合广告网络的调试日志LevelPlay.SetAdaptersDebug(true);设置为 TRUE 时,这行代码将启用调试日志,以帮助您排除所有允许的聚合广告网络的问题。 在 app 与我们的广告单位上线之前,请删除此代码! SDK 6.5.2 及更高版本支持。
步骤 6。Chartboost 其他设置
用户级别 COPPA
Chartboost 要求如果 app 面向子项,则必须设置 true 或 false 值才能定义正确的行为。LevelPlay 的聚合功能允许发布者将 Chartboost 用户级别的 COPPA 设置直接传递到 Chartboost 网络。此功能是使用 LevelPlay SDK 7.2.4、Chartboost Adapter 4.3.14 已启用的。
使用以下语法设置参数为 True 的 Chartboost Chartboost_COPPA 标志,并报告这是面向子项的:
LevelPlay.SetMetaData("Chartboost_Coppa","true");
使用以下语法设置带有参数 False 的 Chartboost Chartboost_COPPA 标志,以报告这不是面向子项的:
LevelPlay.SetMetaData("Chartboost_Coppa","false");
在此处了解有关 Chartboost COPPA 要求的更多信息。
现在,您可以通过 Unity LevelPlay 提供 Chartboost 广告服务。
后续步骤
要通过 Unity LevelPlay 利用其他广告网络,请集成适配器并按照我们的集成指南进行操作。