# Chartboost 集成

> 通过创建 Chartboost 帐户、添加 app 和配置广告单位，在 Unity LevelPlay 平台中将 Chartboost 设置为聚合网络。

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

本指南将逐步说明如何在 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

使用适用于 [Android](/grow/levelplay/sdk/android/networks/guides/chartboost.md) 和 [iOS](/grow/levelplay/sdk/ios/networks/guides/chartboost.md) 的原生适配器继续集成。

## 使用集成 helper##use-the-integration-helper

在测试设备上构建并运行 app 的开发构建，然后打开 [LevelPlay Integration Helper](/grow/levelplay/sdk/android/integration-helper.md) 屏幕。使用此属性可以确认 Unity LevelPlay SDK、Chartboost SDK 和 Chartboost 适配器都显示为集成状态，没有错误。

在开发版中，在初始化 Unity LevelPlay SDK 之前，通过调用以下方法启用适配器调试日志：

```dart
LevelPlay.setAdaptersDebug(true);
```

> **Note:**
>
> SDK 6.5.2 及更高版本支持适配器调试日志。在发布 app 之前，请删除此调用。

## 配置 Chartboost COPPA 行为##configure-chartboost-coppa-behavior

Chartboost 要求您指示 app 是否为子项导向。

在 app 的初始化代码中，在初始化 Unity LevelPlay SDK 之前，通过设置 `CHARTBOOST_COPPA` 元数据键来配置 app 是否为 Chartboost 子项定向。

**子定向：**

```dart
LevelPlay.setMetaData({"CHARTBOOST_COPPA": ["YES"]});
```

**不面向子项：**

```dart
LevelPlay.setMetaData({"CHARTBOOST_COPPA": ["NO"]});
```

在 Chartboost Dashboard 中添加 app 时，还必须指定 COPPA 设置。确保您的app内元数据和 Chartboost Dashboard 设置与app的实际受众一致。

有关更多详细信息，请参阅 [Chartboost 的 COPPA 文档](https://docs.chartboost.com/en/)。

## 后续步骤##next-steps

要通过 Unity LevelPlay 利用其他广告网络，请集成[适配器](/grow/levelplay/sdk/flutter/mediation-networks.md)并按照我们的集成指南进行操作。