# ChartBoostインテグレーション

> Unity LevelPlay プラットフォームで Chartboost をメディエーションネットワークとして設定するには、Chartboost アカウントの作成、アプリケーションの追加、広告ユニットの設定を行います。

> **Important:**
>
> 以下のドキュメントでは、Unity が開発、所有、または運用するものではない製品またはサービス ("サードパーティ製品") を取り上げます。
> その情報は、古かったり、不完全であったりする可能性がありますが、利便性のために提供しています。
> サードパーティ製品を使用する際は、その製品の規約に従うものとします。
> Unity はそれらの製品に関して一切保証を行わず、その使用によって生じた損害や損失 (サードパーティプロバイダーのコンテンツ、広告、製品、資料に関する問題を含む) について責任を負いません。

このガイドでは、Unity LevelPlayでChartBoostを広告ネットワークとして稼働させる方法についてステップ バイ ステップで説明します。

## 前提条件

* リワード広告、インタースティシャル広告、またはバナー広告をアプリケーションに正しく統合していることを確認します。インテグレーション手順については、以下のプラットフォーム固有のガイドを参照してください。

**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)
* [フラッター](/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)
* [フラッター](/grow/levelplay/sdk/flutter/interstitial-integration.md.md)
* [React ネイティブ](/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)
* [フラッター](/grow/levelplay/sdk/flutter/banner-integration.md.md)
* [React ネイティブ](/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. 初めてログインするときは、**開始!** を選択します。

![収益化の開始](/api/media?file=/grow/media/images/Chartboost-integration-with-Supersonic-Mediation-01.png)

2. **アプリケーションの定義** Chartboostは、サインアッププロセスで入力した会社名に基づいて、Appstoreでアプリケーションを自動的に識別しようとします。このプロセスが成功したら、LevelPlay の Mediation を実行したいアプリケーションを選択します。このプロセスがすぐに機能しない場合は、2 つのオプションがあります。
   1. 会社を手動で検索。

![会社の検索](/api/media?file=/grow/media/images/Chartboost-integration-with-Supersonic-Mediation-02.png)

2. アプリがまだどのアプリストアにも公開されていない場合は、詳細を手動で入力できます。ironsource アカウントの場合と同様に、プラットフォーム (iOS + Android) ごとに一意の Chartboost アプリケーションが必要です。

![アプリケーション詳細の手動入力](/api/media?file=/grow/media/images/Chartboost-integration-with-Supersonic-Mediation-03.png)

3. アプリケーションを定義したら、関連するアプリケーションを選択し、**Add Selected (x of x)** (選択済みを追加 (x of x)) を選択します。

![選択したアプリケーションの追加](/api/media?file=/grow/media/images/Chartboost-integration-with-Supersonic-Mediation-04.png)
3\. 次に、アプリケーションで提供する広告を選択する必要があります。

1. Unity LevelPlayプラットフォームでChartBoostリワード広告を配信する場合は、**リワード広告**を選択し、\*\*Create Campaign(s)\*\*を選択します。

![リワード広告の選択](/api/media?file=/grow/media/images/Chartboost-integration-with-Supersonic-Mediation-05.png)

2. LevelPlay Mediation プラットフォームで Chartboost インタースティシャル広告を配信する場合は、**静的インタースティシャル広告**を選択し、**Create Campaign(s)** を選択します。

![静的インタースティシャル広告の選択](/api/media?file=/grow/media/images/Chartboost-IS-Mediation-Interstitial-Ads.png)

4. 下のページにリダイレクトされ、新しく作成したアプリケーションのサマリーが表示されます。**App ID** と**アプリケーション署名**はここに記載されています。これらのパラメータは、**ネットワーク設定**モジュールで ironsource 管理者アカウントに入力する必要があります。

![App ID とアプリケーション署名](/api/media?file=/grow/media/images/Chartboost-integration-with-Supersonic-Mediation-10.png)

5. Unity LevelPlayでのChartboostのリワード広告に関心がある場合は、Chartboostのプレロール/ポストロール ビデオ メッセージを**オフ**にする必要があります。アプリケーションを操作し、**Basic Settings** >**リワード広告** >**Advanced**を選択すると、2つのチェックボックスが表示されます。これらがチェックされて**いない**ことを確認し、**Save (保存**) を選択します。

![プレロール/ポストロール メッセージングをオフにする](/api/media?file=/grow/media/images/Chartboost-integration-with-Supersonic-Mediation-11.png)

## 登録ユーザープロセス

以前に Chartboost アカウントを設定し、LevelPlay の Mediation プラットフォームで使用する新しいアプリケーションを追加する場合は、このセクションに従ってください。

1. ログインしたら、**ダッシュボード**> **公開**> **アプリケーションの追加** を選択します。
   ![アプリケーション追加](/api/media?file=/grow/media/images/Chartboost-integration-with-Supersonic-Mediation-08.png)
2. アプリケーションの詳細を定義します。
   1. **プラットフォーム** - iOS または Android。
   2. **アプリケーション ニックネーム** - Chartboost Reporting UIでアプリケーションを表すために使用されます。
   3. **Orientation** (向き) - 「横向き」または「縦向き」を選択します。
   4. **Test Mode** (テストモード) - 'Disabled' (無効) を選択します。完了したら、'Save' を選択します。 ironsource アカウントの場合と同様に、プラットフォーム (iOS + Android) ごとに一意の Chartboost アプリケーションが必要です。

![アプリケーション詳細の定義](/api/media?file=/grow/media/images/Chartboost-integration-with-Supersonic-Mediation-09.png)

3. 下のページにリダイレクトされ、新しく作成したアプリケーションのサマリーが表示されます。**App ID** と**アプリケーション署名**の両方がここに表示されます。これらのパラメータは、**ネットワーク設定**モジュールで ironsource 管理者アカウントに入力する必要があります。

![App ID とアプリケーション署名](/api/media?file=/grow/media/images/Chartboost-integration-with-Supersonic-Mediation-10.png)

4. Unity LevelPlayでのChartboostのリワード広告に関心がある場合は、Chartboostのプレロール/ポストロール ビデオ メッセージを**オフ**にする必要があります。アプリケーションを操作し、**Basic Settings** >**リワード広告** >**Advanced**を選択すると、2つのチェックボックスが表示されます。これらがチェックされて**いない**ことを確認し、**Save (保存**) を選択します。

![プレロール/ポストロール メッセージングをオフにする](/api/media?file=/grow/media/images/Chartboost-integration-with-Supersonic-Mediation-11.png)
5.Unity LevelPlayでのChartboostのリワード広告に関心がある場合は、Chartboostのプレロール/ポストロール ビデオ メッセージを**オフ**にする必要があります。アプリケーションを操作し、**Basic Settings** >**リワード広告** >**Advanced**を選択すると、2つのチェックボックスが表示されます。これらがチェックされて**いない**ことを確認し、**Save (保存**) を選択します。
6.バナーを使用する場合は、Chartboost ダッシュボードでバナー公開キャンペーンを定義する必要はありません。バナー広告は Chartboost Exchange を通じて配信され、SDK を介して呼び出しだけです。

## ステップ 3. ChartBoost公開キャンペーンの作成

Unity LevelPlay を通じて Chartboost の広告インベントリをアプリケーションに提供するには、Chartboost で公開キャンペーンを作成する必要があります。

1. Chartboostダッシュボードの左下隅にある**Add a Campaign**をクリックし、**ネットワーク公開**をクリックします。

![ネットワーク公開](/api/media?file=/grow/media/images/Supersonic-IS-Mediation-Chartboost-Network-Publishing.png)

2. 「**Simple Settings**（シンプル設定）」セクションで、「**Ad Type（**広告タイプ）」ドロップダウンに配信する広告のタイプ（**リワード広告**または**静的インタースティシャル**）を指定します。Unity LevelPlay でリワード広告とインタースティシャル広告の両方を配信したい場合は、2 つの異なるキャンペーンを作成する必要があります。
3. ［**Save］ を**クリックしますキャンペーンの稼働には最大 20 分かかる場合があります。

アプリケーションのターゲティング オプションを定義するには、[Chartboost](https://docs.chartboost.com/en/) の説明に従ってください。

## ステップ 4. LevelPlay SDK Networks モジュールで Chartboost をアクティベートする

Chartboost アカウントから 5 つのデータがあり、Ironsource ネットワーク設定モジュールに挿入する必要があります。これは、Chartboost を Ironsource に接続して正しく機能させるために必要です。

| **App ID (アプリ ID)** | ChartBoost のシステムにおけるアプリケーションの一意の識別子。                                                            |
| ------------------- | ----------------------------------------------------------------------------------------------- |
| **App Signature**   | 特定のChartBoostアプリケーションへの広告リクエストを検証するために使用される一意の署名。                                               |
| **検出場所**            | ChartBoost のシステム内のアプリケーション内で検出された特定の場所の一意の識別子。                                                  |
| **ユーザー ID**         | ChartBoost アカウントの一意の識別子。Unity LevelPlay が ChartBoost アカウントからパフォーマンス データをインポートし、レポートと最適化に使用できます。 |
| ****ユーザー署名****      | ironsource によるレポートリクエストを代理で検証するための ChartBoost アカウントの一意の識別子。                                     |

この情報を取得したら、LevelPlay アカウントで ChartBoost のパラメータを設定する必要があります。上記の情報を正しく追加することで、Chartboost の広告インベントリと ironsource の Mediation プラットフォームのレポートデータを最大限に活用できるようになります。

### ChartBoost プラットフォームからの ChartBoost のパラメータの取得

1. **App ID** & アプリケーション署名**ダッシュボード**>**アプリケーション設定**>**基本設定**に戻り、リストされている**App ID**と**アプリケーション署名**を入力します。

![App ID とアプリケーション署名](/api/media?file=/grow/media/images/CB-app-Id-sign-1.png)

2. **ユーザーIDとユーザー署名** **ツール**に移動し、ドロップダウンから**APIエクスプローラー**を選択します。

![ユーザーIDとユーザー署名](/api/media?file=/grow/media/images/CB-user.png)

### LevelPlayアカウントにChartboostパラメーターを設定

これらのパラメータをすべて設定したら、LevelPlay アカウントにログインします。

* **Monetize**> **設定**> **SDK networks** に移動し、**manage networks** を選択します。

![SDK ネットワーク](/api/media?file=/grow/media/images/CB-1.png)

* 使用可能な広告ネットワークのリストから「Chartboost」を選択し、関連するフィールドに「Chartboost」の**ユーザーID**と**ユーザー署名**を入力します。

![ユーザー認証情報](/api/media?file=/grow/media/images/CB2.png)

* LevelPlay のメディエーションを Chartboost で実行するアプリケーションを選択し、Chartboost ネットワークの横にある**設定**を選択します。

![設定ボタン](/api/media?file=/grow/media/images/CB3.png)

* Chartboost **App ID**、**アプリケーション署名**、**場所ユーザーID**を関連するフィールドに入力します。

![アプリケーション認証情報](/api/media?file=/grow/media/images/CB4.png)

* Reporting API とのインテグレーションを確認します。この列では、Reporting API を通じたインテグレーションを確認し、次の 3 つの応答を返します。検証済み、失敗、無反応。インテグレーションと上で入力した情報を再確認し、**検証済み**(Verified) が表示されるまで 再試行(**Retry**) を選択します。

## ステップ 5. ビルドへの ChartBoost Adapter の追加##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)用のネイティブ アダプターを使用して、インテグレーションを継続します。

## インテグレーションヘルパーの使用##use-the-integration-helper

テストデバイスでアプリケーションの開発ビルドをビルドして実行し、[LevelPlay インテグレーションヘルパー](/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 以降でサポートされます。アプリケーションをリリースする前に、この呼び出しを削除します。

## ChartBoost COPPA動作の設定##configure-chartboost-coppa-behavior

ChartBoost では、アプリケーションが子指向かどうかを指定する必要があります。

アプリケーションの初期化コードで、Unity LevelPlay SDKを初期化する前に、`CHARTBOOST_COPPA`メタデータ キーを設定して、アプリケーションがChartBoostの子指向性かどうかを設定します。

**児童指導**

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

**子プロセスではない:**

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

Chartboost ダッシュボードでアプリケーションを追加するときは、COPPA 設定も指定する必要があります。アプリケーション内メタデータと Chartboost ダッシュボードボードの設定が、アプリケーションの実際のオーディエンスと一致していることを確認します。

詳細については、[ChartboostのCOPPAドキュメント](https://docs.chartboost.com/en/)を参照してください。

## 次のステップ##next-steps

Unity LevelPlay を通じて追加の広告ネットワークを活用するには、[アダプタ](/grow/levelplay/sdk/flutter/mediation-networks.md)を統合し、インテグレーションガイドに従ってください。
