# Chartboost 集成

> 按照提供的分步说明，将 Chartboost 集成为 Unity LevelPlay 上的广告网络。

> **Important:**
>
> 以下文档涉及非 Unity 开发、拥有或运营的产品或服务（“第三方产品”）。
> 这些信息可能已过时或不完整，仅为方便您参考才提供。
> 您对任何第三方产品的使用均受产品自身条款的约束。
> Unity 对这些产品不提供任何担保，也不对因使用这些产品而造成的任何损害或损失负责，包括与第三方供应商提供的内容、广告或材料有关的问题。

> **Note:**
>
> 要查看此聚合网络的适配器更改日志，请参阅 [Unity 聚合网络](/grow/levelplay/sdk/unity/mediation-networks.md.md#integrate-network-adapters)。

本指南将逐步说明如何在 Unity LevelPlay 上将 Chartboost Live 设置为广告网络。

## 先决条件

* 确保将奖励广告服务、插页式广告服务或横幅广告服务正确集成到应用程序中。请参阅以下指定的于平台的指南以了解集成说明：

**Rewarded ads integration:**

* [Unity](/grow/levelplay/sdk/unity/rewarded-ad-integration-package.md.md)
* [Android](/grow/levelplay/sdk/android/rewarded-ads-integration.md.md)
* [iOS](/grow/levelplay/sdk/ios/rewarded-ads-integration.md.md)
* [Adobe Air](/grow/levelplay/sdk/adobe/rewarded-ads-integration.md.md)
* [Flutter](/grow/levelplay/sdk/flutter/rewarded-ads-integration.md.md)
* [原生反应](/grow/levelplay/sdk/react/rewarded-ads-integration.md.md)

**Interstitial integration:**

* [Unity](/grow/levelplay/sdk/unity/interstitial-integration.md.md)
* [Android](/grow/levelplay/sdk/android/interstitial-integration.md.md)
* [iOS](/grow/levelplay/sdk/ios/interstitial-integration.md.md)
* [Adobe Air](/grow/levelplay/sdk/adobe/interstitial-integration.md.md)
* [Flutter](/grow/levelplay/sdk/flutter/interstitial-integration.md.md)
* [原生反应](/grow/levelplay/sdk/react/interstitial-integration.md.md)

**Banner integration:**

* [Unity](/grow/levelplay/sdk/unity/banner-integration.md.md)
* [Android](/grow/levelplay/sdk/android/banner-integration.md.md)
* [iOS](/grow/levelplay/sdk/ios/banner-integration.md.md)
* [Adobe Air](/grow/levelplay/sdk/adobe/banner-integration.md.md)
* [Flutter](/grow/levelplay/sdk/flutter/banner-integration.md.md)
* [原生反应](/grow/levelplay/sdk/react/banner-integration.md.md)

- Chartboost 支持使用 iOS 11+ 的设备。

## 步骤 1.创建 Chartboost 帐户

1. 使用 Chartboost 创建帐户。您可以在[此处](https://www.chartboost.com/sign-up/)执行此操作。
2. 在验证您的帐户后，您可以在[此处](https://dashboard.chartboost.com/login)登录他们的合作伙伴。

## 步骤 2.在 Chartboost 中创建应用程序

如果这是第一时间设置 Chartboost 帐户，请继续下面的操作。

1. 首次登录时，选择 **Start make money!**。

![开始赚钱](/api/media?file=/grow/media/images/Chartboost-integration-with-Supersonic-Mediation-01.png)

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

![搜索您的公司](/api/media?file=/grow/media/images/Chartboost-integration-with-Supersonic-Mediation-02.png)

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

![手动输入 app 详细信息](/api/media?file=/grow/media/images/Chartboost-integration-with-Supersonic-Mediation-03.png)

3. 定义应用程序后，选择相关的应用程序并选择 **Add Selected (x of x)**。

![添加选定的应用程序](/api/media?file=/grow/media/images/Chartboost-integration-with-Supersonic-Mediation-04.png)
3.现在，您必须选择要在 app 中投放的广告服务。

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

![选择奖励广告服务](/api/media?file=/grow/media/images/Chartboost-integration-with-Supersonic-Mediation-05.png)

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

![选择 Static Interstitial 广告服务](/api/media?file=/grow/media/images/Chartboost-IS-Mediation-Interstitial-Ads.png)

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

![app ID 和 app Signature](/api/media?file=/grow/media/images/Chartboost-integration-with-Supersonic-Mediation-10.png)

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

![关闭滚动前/滚动后消息](/api/media?file=/grow/media/images/Chartboost-integration-with-Supersonic-Mediation-11.png)

## 注册用户进程

如果您以前设置过 Chartboost 帐户，并且正在添加新的应用程序以便在 LevelPlay 的 Mediation 平台上使用，请遵循本节。

1. 登录后，选择 **Dashboard** > **Publishing** > **Add app**。
   ![添加 app](/api/media?file=/grow/media/images/Chartboost-integration-with-Supersonic-Mediation-08.png)
2. 定义应用程序的详细信息：
   1. **平台** -- -- iOS 或 Android。
   2. **app Nickname** - 用于在 Chartboost Reporting UI 中代表 app。
   3. **Orientation** - 选择“Landscape”或“Portrait”。
   4. **测试模式** - 选择“已禁用”。完成后，选择“保存”。 您将需要每个平台（iOS Android）的唯一 Chartboost 应用程序，就像您使用 Ironsource 帐户一样。

![定义 app 详细信息](/api/media?file=/grow/media/images/Chartboost-integration-with-Supersonic-Mediation-09.png)

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

![app ID 和 app Signature](/api/media?file=/grow/media/images/Chartboost-integration-with-Supersonic-Mediation-10.png)

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

![关闭滚动前/滚动后消息](/api/media?file=/grow/media/images/Chartboost-integration-with-Supersonic-Mediation-11.png)
5.如果对 Unity LevelPlay 上的 Chartboost 奖励广告服务感兴趣，则需要**关闭** Chartboost 的播放前/播放后视频消息。导航到 app，选择 **Basic Settings**（基本设置）> **Rewarded ads**（奖励广告服务）> **Advanced**（高级），然后会看到两个复选框。确保**取消选中**它们，然后选择 **保存**。
6.如果您有兴趣使用横幅，则无需在 Chartboost Dashboard 上定义横幅发布广告系列。横幅广告服务通过 Chartboost Exchange 提供，您只需通过 SDK 调用即可。

## 步骤 3.创建 Chartboost 发布广告系列

要通过 Unity LevelPlay 在app中投放 Chartboost 的广告库存，必须在 Chartboost 上创建发布广告系列。

1. 在 Chartboost 后台中，单击左下角的 **Add a Campaign**，然后单击 **Network Publishing**。

![网络发布](/api/media?file=/grow/media/images/Supersonic-IS-Mediation-Chartboost-Network-Publishing.png)

2. 在 **Simple Settings** 部分中，在 **Ad Type** 下拉选单中指明要投放的广告类型（**奖励广告**服务或 **Static Interstitial**）。如果要通过 Unity LevelPlay 同时提供奖励广告服务和插页式广告服务，必须创建两个不同的广告系列。
3. 单击 \*\*Save（保存）。\*\*广告系列可能需要最多 20 分钟才能上线。

要为应用程序定义定向投放选项，请遵循 [Chartboost](https://docs.chartboost.com/en/) 上的说明。

## 步骤 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 的参数

1. **app ID & app Signature** 导航回 **Dashboard** > **app Settings** > **Basic Settings**，然后填写列出的 **app ID** 和 **app Signature**。

![app ID 和 app Signature](/api/media?file=/grow/media/images/CB-app-Id-sign-1.png)

2. **User ID & User Signature** 导航到 **Tools**，然后从下拉菜单中选择 **API Explorer**。

![用户 ID 和用户签名](/api/media?file=/grow/media/images/CB-user.png)

### 将 Chartboost 参数配置到您的 LevelPlay 帐户

获得所有这些参数后，日志 LevelPlay 帐户。

* 转到 **Monetize** > **Setup** > **SDK networks**，然后选择 **Manage Network**。

![SDK 网络](/api/media?file=/grow/media/images/CB-1.png)

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

![用户凭据](/api/media?file=/grow/media/images/CB2.png)

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

![设置按钮](/api/media?file=/grow/media/images/CB3.png)

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

![app 凭据](/api/media?file=/grow/media/images/CB4.png)

* 验证与 Reporting API 的集成；此列将通过 Reporting API 检查您的集成，并返回三种可能的响应：Verified、Failed 和 No Response。仔细检查您的集成和上面输入的信息；然后选择 **Retry**（重试），直到看到 **Verified（已验证**）。

## 步骤 5。 将 Chartboost 适配器添加到构建中##step-5.add-the-chartboostadapter-to-your-build

### Unity Integration Manager（推荐）##unity-integration-manager-(recommended)

完成 SDK 集成后，可使用 Unity Integration Manager 下载 Chartboost 适配器。

在 Unity 开发平台中，转到 LevelPlay > Integration Manager

如果您已经拥有最新版本的适配器，则**操作**按钮将更改为 " Updated " 并已禁用。

### Android（手动解析）##android-(manual-resolve)

要应用更改，请确保使用“Resolve”过程。这将根据您的选择下载所有相关工件。有关详细信息，请参阅[此处](/grow/levelplay/sdk/unity/package-integration.md)的说明。 

#### 仅适用于 Proguard 用户（Android）##for-proguard-users-only-(android)

如果将 ProGuard 与 Chartboost 适配器结合使用，必须将以下代码添加到 ProGuard 配置中（Android Studio：proguard-rules.pro 或 Eclipse：proguard-项目.txt）：

```text
-keep 类 com.chartboost。** { *; }
```

#### Android 插件手册集成##android-plugin-manual-integration

1. \*\*下载 Chartboost Android 适配器：\*\*从[此处](/grow/levelplay/sdk/android/mediation-networks.md)下载适配器。
2. 将 Chartboost 文件**添加到 Unity 项目** 将文件导入 **Assets/Plugins/Android/**。

> **Note:**
>
> 为了适应 Unity 版本 5.5 中的更改，LevelPlay 插件版本 6.7.1 要求为插件和聚合适配器单独添加 Android 清单。如果要更新插件或当前在6.7.1上运行，请务必添加[Android 文档](/grow/levelplay/sdk/android/networks/guides/chartboost.md)中注明的清单活动。

#### Unity 插件 iOS 手动集成##unity-plugin-ios-manual-integration

1. \*\*下载 Chartboost iOS 适配器和 SDK：\*\*请参阅 [iOS 调解网络](/grow/levelplay/sdk/ios/mediation-networks.md)。
2. \*\*将 Chartboost 文件添加到 Unity 项目：\*\*将适配器和 SDK 文件导入 **Assets/Plugins/iOS**。我们的 Unity 插件会自动将必要的框架添加到 Xcode 项目中。

## 验证广告网络集成##verify-your-ad-network-integration

* 验证您的广告网络与我们的 [Integration Helper](/grow/levelplay/sdk/unity/integration-helper.md) 集成。LevelPlay SDK 提供了一个工具，可确保已成功集成我们的 SDK 以及任何其他网络适配器。
* 使用此布尔值管理集成的聚合广告网络的调试日志

  ```text
  LevelPlay.SetAdaptersDebug(true);
  ```

  设置为 **TRUE** 时，这行代码将启用调试日志，以帮助您排除所有允许的聚合广告网络的问题。 在 app 与我们的广告单位上线之前，请删除此代码！ SDK 6.5.2 及更高版本支持。

## 步骤 6。Chartboost 其他设置##step-6.-chartboost-additional-settings

### 用户级别 COPPA##user-level-coppa

Chartboost 要求如果 app 面向子项，则必须设置 true 或 false 值才能定义正确的行为。LevelPlay 的聚合功能允许发布者将 Chartboost 用户级别的 COPPA 设置直接传递到 Chartboost 网络。此功能是使用 LevelPlay SDK 7.2.4、Chartboost Adapter 4.3.14 已启用的。

使用以下语法设置参数为 True 的 Chartboost Chartboost\_COPPA 标志，并报告这是面向子项的：

```cs
LevelPlay.SetMetaData("Chartboost_Coppa","true");
```

使用以下语法设置带有参数 False 的 Chartboost Chartboost\_COPPA 标志，以报告这不是面向子项的：

```cs
LevelPlay.SetMetaData("Chartboost_Coppa","false");
```

在[此处](https://docs.chartboost.com/en/)了解有关 Chartboost COPPA 要求的更多信息。

现在，您可以通过 Unity LevelPlay 提供 Chartboost 广告服务。

## 后续步骤##next-steps

要通过 Unity LevelPlay 利用其他广告网络，请集成适配器并按照我们的集成指南进行操作。

**Platform adapters:**

* [Unity](/grow/levelplay/sdk/unity/mediation-networks.md)
* [Android](/grow/levelplay/sdk/android/mediation-networks.md)
* [iOS](/grow/levelplay/sdk/ios/mediation-networks.md)
* [Adobe AIR](/grow/levelplay/sdk/adobe/mediation-networks.md)
* [Flutter](/grow/levelplay/sdk/flutter/mediation-networks.md)
* [React Native](/grow/levelplay/sdk/react/mediation-networks.md)