# Chartboostインテグレーション

> React ネイティブ アプリケーションで Chartboost を Unity LevelPlay と統合します。このガイドでは、アカウント設定、アプリケーション設定、広告ロケーションの作成、キャンペーン設定、パラメーター取得、Unity Dashboard でのアクティベーション、アダプターのインテグレーション、COPPA 設定について説明します。

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

このガイドでは、React ネイティブ アプリケーションで Chartboost を Unity LevelPlay と統合する方法について説明します。アカウント設定からChartboostアダプターとSDKをプロジェクトに統合するまでの全プロセスをカバーします。

| トピック                                                                         | 説明                                                              |
| ---------------------------------------------------------------------------- | --------------------------------------------------------------- |
| [Create and set up your account](#create-and-set-up-your-chartboost-account) | Chartboostにサインアップして、アカウント、支払い、通知、ユーザー設定を完了します。                  |
| [Add your app to the dashboard](#add-your-app-in-the-chartboost-dashboard)   | Chartboost ダッシュボードで各アプリケーションを登録し、フォーマットと COPPA 状態を設定します。        |
| [Create ad location](#create-ad-locations).                                  | 形式ごとに入札広告の場所を定義し、Chartboost広告がアプリケーション内で配信される場所をコントロールします。      |
| [Create a campaign](#create-a-chartboost-publishing-campaign)                | 指定したターゲットでのリワード広告とインタースティシャル広告の公開キャンペーンを設定します。                  |
| [Retrieve required parameters](#retrieve-required-parameters)                | LevelPlay 設定のために App ID、アプリケーション署名、ユーザー ID、ユーザー署名、場所 ID を収集します。 |
| [Activate Chartboost](#activate-chartboost-in-the-unity-dashboard)           | Unity DashboardでChartboostの認証情報を入力し、レポートAPIの接続を確認します。           |
| [Add the Chartboost adapter](#add-the-chartboost-adapter-to-your-build)      | AndroidおよびiOSのネイティブ ガイドを使用して、ChartboostアダプターとSDKを統合します。         |
| [Configure COPPA behavior](#configure-chartboost-coppa-behavior)             | アプリケーションの子指向状態に一致するようにChartboost COPPAメタデータを設定します。              |

## 前提条件##prerequisites

Unity LevelPlay で Chartboost をアクティベートする前に、アプリケーションとプロジェクトで以下の前提条件を満たしていることを確認してください。

* アプリケーションに動画リワード広告、インタースティシャル広告、またはバナー広告が統合されている。
* プロジェクトに LevelPlay SDK が含まれている。
* アプリケーションは Chartboost の Android OS 要件の API 19 (Android 4.4 KitKat) を満たしています。詳細については、[Android 入門ドキュメント](https://docs.chartboost.com/en/)を参照してください。
* Chartboost は iOS 11 以降を使用するデバイスをサポートします。

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

**Rewarded Video integration:**

* [React ネイティブ](/grow/levelplay/sdk/react/rewarded-ads-integration.md)
* [Android](/grow/levelplay/sdk/android/rewarded-ads-integration.md)
* [Unity](/grow/levelplay/sdk/unity/rewarded-ad-integration-package.md)
* [iOS](/grow/levelplay/sdk/ios/rewarded-ads-integration.md)
* [Adobe AIR](/grow/levelplay/sdk/adobe/rewarded-ads-integration.md)
* [Flutter](/grow/levelplay/sdk/flutter/rewarded-ads-integration.md)

**Interstitial integration:**

* [React ネイティブ](/grow/levelplay/sdk/react/interstitial-integration.md)
* [Android](/grow/levelplay/sdk/android/interstitial-integration.md)
* [Unity](/grow/levelplay/sdk/unity/interstitial-integration.md)
* [iOS](/grow/levelplay/sdk/ios/interstitial-integration.md)
* [Adobe AIR](/grow/levelplay/sdk/adobe/interstitial-integration.md)
* [Flutter](/grow/levelplay/sdk/flutter/interstitial-integration.md)

**Banner integration:**

* [React ネイティブ](/grow/levelplay/sdk/react/banner-integration.md)
* [Android](/grow/levelplay/sdk/android/banner-integration.md)
* [Unity](/grow/levelplay/sdk/unity/banner-integration.md)
* [iOS](/grow/levelplay/sdk/ios/banner-integration.md)
* [Adobe AIR](/grow/levelplay/sdk/adobe/banner-integration.md)
* [Flutter](/grow/levelplay/sdk/flutter/banner-integration.md)

## ChartBoostアカウントの作成と設定##create-and-set-up-your-chartboost-account

Chartboostアカウントを作成および設定して、アプリケーションの追加、支払いの詳細の設定、Unity LevelPlayによるメディエーションの広告掲載場所の準備を行うことができます。

1. [Chartboostアカウントにサイン](https://www.chartboost.com/sign-up/)アップします。
2. Eメール検証を通じてChartboostアカウントを作成および検証します。
3. [Chartboostダッシュボードにサインイン](https://dashboard.chartboost.com/login)し、次のステップに従ってアカウントを設定します。
   * 支払詳細の追加 - Chartboost が収益の送金先を把握していることを確認します。
   * 通知の設定
   * 必要に応じてユーザーを追加する。

## Chartboost ダッシュボードにアプリケーションを追加する##add-your-app-in-the-chartboost-dashboard

Chartboost ダッシュボードにアプリケーションを登録し、SDK のインテグレーションとキャンペーンの設定を開始します。ChartBoostを初めて使用する場合は、**初回設定**の手順に従ってください。そうでない場合は、登録済みのChartBoost**ユーザー**としてのアプリケーションの追加 に進みます。

> **Note:**
>
> サポートするプラットフォームごとに一意の Chartboost アプリケーションエントリーを作成する必要があります。

### 初回設定

Chartboost ダッシュボードに最初にログインしたとき:

1. **Start making money!**(収益化の開始)を選択します

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

2. Chartboost はライブアプリを自動的に検出しようとします。アプリケーションが検出されない場合は、以下のいずれかを選択します。
   * 会社を手動で検索

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

* アプリケーションの手動追加 (アプリケーションがまだ公開されていない場合)

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

3. 追加するアプリケーションを選択し、**Add Selected を**選択します。

![選択したアプリケーションの追加](/api/media?file=/grow/media/images/Chartboost-integration-with-Supersonic-Mediation-04.png)
4\. 配信する広告タイプ(動画リワード広告/静的インタースティシャル広告)を選択し、**Create Campaign(キャンペーン**の作成)を選択します。

### 登録済みChartBoostユーザーとしてのアプリケーションの追加

すでに ChartBoost アカウントがあり、新しいアプリケーションを追加する場合:

1. **ダッシュボード**> **公開**> **アプリケーションの追加** の順に移動します。

![アプリケーション追加](/api/media?file=/grow/media/images/Chartboost-integration-with-Supersonic-Mediation-08.png)

2. アプリケーションの詳細を入力します。
   * **Platform** (プラットフォーム): アプリケーションを実行するオペレーティングシステムを選択します (iOS または Android)。
   * **アプリケーション ニックネーム**：ダッシュボードボードでアプリケーションを識別するためのディスプレイ名を入力します。
   * **向き**:アプリケーションがサポートするデフォルトの画面方向を選択します。
   * **テストモード設定**:設定とQA中にテスト広告を配信するテストモードを有効にします。

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

3. アプリケーションを保存して、App ID とアプリケーション署名を取得します。

![App ID と署名](/api/media?file=/grow/media/images/Chartboost-integration-with-Supersonic-Mediation-10.png)

### 動画リワードのプレロール/ポストロール メッセージを無効に

LevelPlayを通じてChartBoostのリワード型ビデオを配信する場合は、ChartBoostのプレロールおよびポストロール メッセージを無効にします。

1. Chartboost ダッシュボードで、アプリケーションを開きます。
2. **Basic Settings** (基本設定)> \*\*Rewarded Video (\*\*動画リワード)> **Advanced (詳細**) に移動します。
3. プレロールとポストロールの両方のメッセージオプションのチェックを外します。
4. **Save** (保存) を選択します。

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

\*\*バナー広告：\*\*バナー広告では、ChartBoostでの公開キャンペーンは必要ありません。これらはChartboost Exchangeを通じて提供され、Unity LevelPlayアダプターを使用してSDKから直接呼び出されます。

## 広告ロケーションの作成##create-ad-locations

広告の場所は、ChartBoostがアプリケーションで広告を表示する場所とタイミングを定義します。広告ロケーションの作成と管理は Chartboost ダッシュボード で行います。アプリケーションとロケーションタイプごとに最大 100 個の一意のの場所名を追加できます。

広告ロケーションの作成および管理の詳細な手順については、[Chartboost広告ロケーション ドキュメント](https://docs.chartboost.com/en/)を参照してください。

広告ロケーション名は大文字と小文字が区別され、以下のルールに従う必要があります。

* 最大 80 文字
* 大文字または小文字を使用できます
* 数字 0 \~ 9 が使用可能
* 使用できる特殊文字: `$ & - _ , + / \`
* スペースは使用できません

\*\*重要:\*\*Unity LevelPlay をアプリケーション内入札で使用する場合は、**入札**広告ロケーションのみを作成します。固定 CPM の場所を使用すると、アプリケーション内入札が正しく機能しなくなります。Bidding (入札) 広告の場所タイプは、Chartboost のリアルタイム入札ソリューションである In-アプリケーション Bidding (アプリ内入札) を使用して Chartboost Exchange に入札するパブリッシャー向けです。

## ChartBoost公開キャンペーンの作成##create-a-chartboost-publishing-campaign

インタースティシャル広告とリワード広告の場合は、Chartboost ダッシュボードで公開キャンペーンを作成します。

1. Chartboostダッシュボードで、**Add a Campaign** >**ネットワーク公開**を選択します。

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

2. **Rewarded Video** または **静的 Interstitial** を選択します。
3. 両方の形式でサービスを提供している場合は、別々のキャンペーンを作成します。
4. 必要例えばデバイスユーザー)。ユーザーデバイス
5. キャンペーンを保存します。稼働するまで最大 20 分かかる場合があります。

## 必要なパラメーターの取得##retrieve-required-parameters

Unity LevelPlay が ChartBoost に広告リクエストを送信し、レポート データをインポートできるようにするには、Unity LevelPlay に以下の ChartBoost パラメータが必要です。

* App ID (アプリ ID)
* App Signature
* 位置情報
* ユーザー ID
* ユーザー署名

### これらのパラメーターの場所

以下のダッシュボードパスを使用して、各パラメーターを見つけます。

* **App ID and アプリケーション署名**：**ダッシュボード**> **アプリケーション設定**> **基本設定**
* **ユーザーIDとユーザー署名**:**「ツール**」>「**API エクスプローラー**」

## Unity DashboardでChartBoostをアクティベート##activate-chartboost-in-the-unity-dashboard

Chartboostでアプリケーションとキャンペーンを設定し、必要なパラメーターを取得したら、Unity LevelPlayでChartboostをアクティベートします。

まず、Chartboost からパラメーターを取得します。

\*\*App ID & アプリケーション署名:\*\***ダッシュボード**>**アプリケーション設定**>**基本設定**の順に移動します。

![App ID と署名](/api/media?file=/grow/media/images/CB-app-Id-sign-1.png)

**ユーザーIDとユーザー署名:\*\*\*\*［Tools**］＞ **API Explorer** に移動します。

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

次に、LevelPlay アカウントで Chartboost を設定します。

1. Unity Dashboard にサインインします。
2. **［Grow**］＞ **［LevelPlay**］＞ ［**設定**］＞ ［**SDK Networks］** に移動します。

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

3. ネットワークのリストから、**Chartboost** を選択します。
4. **ユーザー ID** と**ユーザー署名**を入力します。

![ユーザー ID と署名の入力](/api/media?file=/grow/media/images/CB2.png)
5.アプリケーションを選択し、**設定**を選択します。
6.関連する各広告単位の**App ID**、**アプリケーション署名**、**ロケーションID**(ロケーション識別子)を入力します。
7\. **Reporting API 検証**を実行します。失敗した場合は、間違った値を更新し、状態が **Verified** になるまで再試行します。

> **Note:**
>
> 検証では以下が返されます。検証済み、失敗、無反応

## ビルドにChartboostアダプターを追加する##add-the-chartboost-adapter-to-your-build

Reactネイティブ アプリケーションでChartboost SDKをUnity LevelPlayと統合するには、ネイティブ プラットフォーム ガイドを使用してChartboostアダプターを追加します。

* [Android](/grow/levelplay/sdk/android/networks/guides/chartboost.md) — Gradle または手動インストール
* [iOS](/grow/levelplay/sdk/ios/networks/guides/chartboost.md) — CocoaPods または手動インストール

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

テストデバイスでアプリケーションの開発ビルドをビルドして実行し、[LevelPlay インテグレーションヘルパー](/grow/levelplay/sdk/react/integration-helper.md)画面を開きます。これを使用して、LevelPlay SDK、Chartboost SDK、Chartboost アダプターがすべてエラーなしで統合されたように表示されることを確認します。

開発ビルドでは、LevelPlay SDK を初期化する前に以下のメソッドを呼び出してアダプターのデバッグを有効にします。

```js
「Unity-levelplay-mediation」からのインポート{ LevelPlay }

LevelPlay.setAdaptersDebug(true)
```

> **Note:**
>
> アダプタ デバッグ ログは SDK バージョン 6.5.2 以降でサポートされます。アプリケーションをリリースする前に、この呼び出しを削除します。

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

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

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

**児童指導**

```js
「Unity-levelplay-mediation」からのインポート{ LevelPlay }

LevelPlay.setMetaData('CHARTBOOST_COPPA', ['YES'])
```

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

```js
「Unity-levelplay-mediation」からのインポート{ LevelPlay }

LevelPlay.setMetaData('CHARTBOOST_COPPA', ['NO'])
```

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

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

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

Unity LevelPlay を通じて Chartboost 広告を配信できるようになりました。

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