ChartBoostインテグレーション
iOS上でChartboostとUnity LevelPlayを統合します。このガイドでは、アカウント設定、アプリケーション設定、広告ロケーションの作成、キャンペーン設定、パラメーター取得、Unity Dashboard でのアクティベーション、アダプターのインテグレーション、COPPA 設定について説明します。
読み終わるまでの所要時間 8 分最終更新 6日前
このガイドでは、iOS で Chartboost を Unity LevelPlay と統合する方法について説明します。アカウント設定からChartBoostアダプターとSDKをプロジェクトに統合するまでの全プロセスをカバーします。
前提条件
Unity LevelPlay で Chartboost をアクティベートする前に、アプリケーションとプロジェクトで以下の前提条件を満たしていることを確認してください。
- アプリケーションに動画リワード広告、インタースティシャル広告、またはバナー広告が統合されている。
- プロジェクトに LevelPlay SDK が含まれている。
- アプリケーションは iOS 11 以降に互換性のあるしています。
動画リワード広告、インタースティシャル広告、またはバナー広告をアプリケーションに正しく統合していることを確認します。インテグレーション手順については、以下のプラットフォーム固有のガイドを参照してください。
ChartBoostアカウントの作成と設定
Chartboostアカウントを作成および設定して、アプリケーションの追加、支払いの詳細の設定、Unity LevelPlayによるメディエーションの広告掲載場所の準備を行うことができます。
- Chartboostアカウントにサインアップします。
- Eメール検証を通じてChartboostアカウントを作成および検証します。
- Chartboostダッシュボードにサインインし、次のステップに従ってアカウントを設定します。
- 支払詳細の追加 - Chartboost が収益の送金先を把握していることを確認します。
- 通知の設定
- 必要に応じてユーザーを追加する。
Chartboost ダッシュボードにアプリケーションを追加する
Chartboost ダッシュボードにアプリケーションを登録し、SDK のインテグレーションとキャンペーンの設定を開始します。ChartBoostを初めて使用する場合は、初回設定の手順に従ってください。そうでない場合は、登録済みのChartBoostユーザーとしてのアプリケーションの追加 に進みます。
初回設定
Chartboost ダッシュボードに最初にログインしたとき:
- Start making money!(収益化の開始)を選択します

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

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

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

登録済みChartBoostユーザーとしてのアプリケーションの追加
すでに ChartBoost アカウントがあり、新しいアプリケーションを追加する場合:
- ダッシュボード> 公開> アプリケーションの追加 の順に移動します。

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

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

動画リワードのプレロール/ポストロール メッセージを無効に
LevelPlayを通じてChartBoostのリワード型ビデオを配信する場合は、ChartBoostのプレロールおよびポストロール メッセージを無効にします。
- Chartboost ダッシュボードで、アプリケーションを開きます。
- Basic Settings (基本設定)> **Rewarded Video (**動画リワード)> Advanced (詳細) に移動します。
- プレロールとポストロールの両方のメッセージオプションのチェックを外します。
- Save (保存) を選択します。

**バナー広告:**バナー広告では、ChartBoostでの公開キャンペーンは必要ありません。これらはChartboost Exchangeを通じて提供され、Unity LevelPlayアダプターを使用してSDKから直接呼び出されます。
広告ロケーションの作成
広告の場所は、ChartBoostがアプリケーションで広告を表示する場所とタイミングを定義します。広告ロケーションの作成と管理は Chartboost ダッシュボード で行います。アプリケーションとロケーションタイプごとに最大 100 個の一意のの場所名を追加できます。
広告ロケーションの作成および管理の詳細な手順については、Chartboost広告ロケーション ドキュメントを参照してください。
広告ロケーション名は大文字と小文字が区別され、以下のルールに従う必要があります。
- 最大 80 文字
- 大文字または小文字を使用できます
- 数字 0 ~ 9 が使用可能
- 使用できる特殊文字:
$ & - _ , + / \ - スペースは使用できません
**重要:**Unity LevelPlay をアプリケーション内入札で使用する場合は、入札広告ロケーションのみを作成します。固定 CPM の場所を使用すると、アプリケーション内入札が正しく機能しなくなります。Bidding (入札) 広告の場所タイプは、Chartboost のリアルタイム入札ソリューションである In-アプリケーション Bidding (アプリ内入札) を使用して Chartboost Exchange に入札するパブリッシャー向けです。
ChartBoost公開キャンペーンの作成
インタースティシャル広告とリワード広告の場合は、Chartboost ダッシュボードで公開キャンペーンを作成します。
- Chartboostダッシュボードで、Add a Campaign >ネットワーク公開を選択します。

- Rewarded Video または 静的 Interstitial を選択します。
- 両方の形式でサービスを提供している場合は、別々のキャンペーンを作成します。
- 必要例えばデバイスユーザー)。ユーザーデバイス
- キャンペーンを保存します。稼働するまで最大 20 分かかる場合があります。
必要なパラメーターの取得
Unity LevelPlay が ChartBoost に広告リクエストを送信し、レポート データをインポートできるようにするには、Unity LevelPlay に以下の ChartBoost パラメータが必要です。
- App ID (アプリ ID)
- App Signature
- 位置情報
- ユーザー ID
- ユーザー署名
これらのパラメーターの場所
以下のダッシュボードパスを使用して、各パラメーターを見つけます。
- App ID and アプリケーション署名:ダッシュボード> アプリケーション設定> 基本設定
- ユーザーIDとユーザー署名:「ツール」>「API エクスプローラー」
Unity DashboardでChartBoostをアクティベート
Chartboostでアプリケーションとキャンペーンを設定し、必要なパラメーターを取得したら、Unity LevelPlayでChartboostをアクティベートします。
まず、Chartboost からパラメーターを取得します。
**App ID & アプリケーション署名:**ダッシュボード>アプリケーション設定>基本設定の順に移動します。

ユーザーIDとユーザー署名:****[Tools]> API Explorer に移動します。

次に、LevelPlay アカウントで Chartboost を設定します。
- Unity Dashboard にサインインします。
- [Grow]> [LevelPlay]> [設定]> [SDK Networks] に移動します。

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

iOS プロジェクトに Chartboost アダプターを追加する
Chartboost SDK を iOS アプリケーションで Unity LevelPlay と統合するには、CocoaPods を使用してプロジェクトに Chartboost アダプタを追加するか、手動でインストールします。
CocoaPods の使用
CocoaPods を使用して Chartboost アダプターを追加するには、以下を行います。
-
Podfile を開きます。
-
以下のコード行を追加します。pod 'IronSourceChartboostAdapter', '5.3.0'
-
を実行してアダプタをインストールします。
pod install
サポートされている最新のアダプター バージョンを確認するには、Chartboostアダプター変更ログを参照してください。
手動インストール
以下のステップに従って、Chartboost SDKを手動でインストールおよび設定します。
-
Chartboost Adapter と Chartboost SDK をダウンロードします。**重要:**Chartboost アダプターには、Chartboost SDK は含まれていません。Chartboost SDK もダウンロードしてプロジェクトに追加します。
-
Chartboost アダプターと SDK の両方を Xcode プロジェクトに追加します。
-
Xcodeビルド設定で、以下を確認します。
- Base SDK が iOS 7.0 以降に設定されている。
- armv6 アーキテクチャは含まれません。
広告ネットワークインテグレーションの確認
LevelPlay インテグレーション ヘルパーを使用して、Unity LevelPlay SDK、Chartboost SDK、および Chartboost アダプタが正しく統合されていることを確認します。
開発ビルドでは、Unity LevelPlay SDK を初期化する前に以下のメソッドを呼び出してアダプターのデバッグを有効にします。
[LevelPlay setAdaptersDebug:YES];
**ノート:**アダプタ デバッグ ログは SDK バージョン 6.5.2 以降でサポートされます。アプリケーションをリリースする前に、この呼び出しを削除します。
ChartBoost COPPA動作の設定
ChartBoost では、アプリケーションが子指向かどうかを指定する必要があります。ユーザーレベルのCOPPAサポートには、LevelPlay SDK 7.3.0以降とChartboost iOSアダプタ4.3.14以降が必要です。
アプリケーションのコードで、Unity LevelPlay SDKを初期化する前に、のメタデータ キーを設定して、アプリケーションがChartBoostの子指向かどうかを設定します。
CHARTBOOST_COPPA児童指導
[LevelPlay setMetaDataWithKey:@"CHARTBOOST_COPPA" value:@"YES"];
子プロセスではない:
[LevelPlay setMetaDataWithKey:@"CHARTBOOST_COPPA" value:@"NO"];
Chartboost ダッシュボードでアプリケーションを追加するときは、COPPA 設定も指定する必要があります。アプリケーション内メタデータと Chartboost ダッシュボードボードの設定が、アプリケーションの実際のオーディエンスと一致していることを確認します。
詳細については、ChartboostのCOPPAドキュメントを参照してください。
次のステップ
Unity LevelPlay を通じて ChartBoost 広告を配信できるようになりました。
Unity LevelPlay を通じて追加の広告ネットワークを活用するには、アダプタを統合し、インテグレーションガイドに従ってください。