# ChartBoostインテグレーション

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

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

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

> **Note:**
>
> このメディエーションネットワークのアダプタ変更ログを表示するには、[iOS 用メディエーションネットワーク](/grow/levelplay/sdk/ios/mediation-networks.md.md#integrate-network-adapters) を参照してください。

## 前提条件##prerequisites

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

* アプリケーションに動画リワード広告、インタースティシャル広告、またはバナー広告が統合されている。
* プロジェクトに LevelPlay SDK が含まれている。
* アプリケーションは iOS 11 以降に互換性のあるしています。

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

**Rewarded Video integration:**

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

**Interstitial integration:**

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

**Banner integration:**

* [iOS](/grow/levelplay/sdk/ios/banner-integration.md)
* [Unity](/grow/levelplay/sdk/unity/banner-integration.md)
* [Android](/grow/levelplay/sdk/android/banner-integration.md)
* [Adobe AIR](/grow/levelplay/sdk/adobe/banner-integration.md)
* [Flutter](/grow/levelplay/sdk/flutter/banner-integration.md)
* [React ネイティブ](/grow/levelplay/sdk/react/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:**
>
> 検証では以下が返されます。検証済み、失敗、無反応

## iOS プロジェクトに Chartboost アダプターを追加する##add-the-chartboost-adapter-to-your-ios-project

Chartboost SDK を iOS アプリケーションで Unity LevelPlay と統合するには、CocoaPods を使用してプロジェクトに Chartboost アダプタを追加するか、手動でインストールします。

### CocoaPods の使用##using-cocoapods

CocoaPods を使用して Chartboost アダプターを追加するには、以下を行います。

1. Podfile を開きます。

2. 以下のコード行を追加します。

   ```ruby
   pod 'IronSourceChartboostAdapter', '5.3.0'
   ```

3. `pod install` を実行してアダプタをインストールします。

サポートされている最新のアダプター バージョンを確認するには、[Chartboostアダプター変更ログ](/grow/levelplay/sdk/ios/networks/changelogs/chartboost.md)を参照してください。

### 手動インストール##manual-installation

以下のステップに従って、Chartboost SDKを手動でインストールおよび設定します。

1. [Chartboost Adapter と Chartboost SDK](/grow/levelplay/sdk/ios/mediation-networks.md) をダウンロードします。

   \*\*重要:\*\*Chartboost アダプターには、Chartboost SDK は含まれていません。Chartboost SDK もダウンロードしてプロジェクトに追加します。

2. Chartboost アダプターと SDK の両方を Xcode プロジェクトに追加します。

3. Xcodeビルド設定で、以下を確認します。
   * Base SDK が iOS 7.0 以降に設定されている。
   * armv6 アーキテクチャは含まれません。

## 広告ネットワークインテグレーションの確認##verify-your-ad-network-integration

[LevelPlay インテグレーション ヘルパー](/grow/levelplay/sdk/ios/integration-helper.md)を使用して、Unity LevelPlay SDK、Chartboost SDK、および Chartboost アダプタが正しく統合されていることを確認します。

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

1. **Objective-C**

   ```objective-c
   [LevelPlay setAdaptersDebug:YES];
   ```

2. **Swift**

   ```swift
   LevelPlay.setAdaptersDebug(true)
   ```

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

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

ChartBoost では、アプリケーションが子指向かどうかを指定する必要があります。ユーザーレベルのCOPPAサポートには、LevelPlay SDK 7.3.0以降とChartboost iOSアダプタ4.3.14以降が必要です。

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

**児童指導**

1. **Objective-C**

   ```objective-c
   [LevelPlay setMetaDataWithKey:@"CHARTBOOST_COPPA" value:@"YES"];
   ```

2. **Swift**

   ```swift
   LevelPlay.setMetaDataWithKey("CHARTBOOST_COPPA", value: "true")
   ```

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

1. **Objective-C**

   ```objective-c
   [LevelPlay setMetaDataWithKey:@"CHARTBOOST_COPPA" value:@"NO"];
   ```

2. **Swift**

   ```swift
   LevelPlay.setMetaDataWithKey("CHARTBOOST_COPPA", value: "false")
   ```

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

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

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

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

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