ChartBoostインテグレーション
表示されるステップ バイ ステップの指示に従うことで、ChartboostをUnity LevelPlayの広告ネットワークとして統合できます。
読み終わるまでの所要時間 7 分最終更新 7日前
このガイドでは、Unity LevelPlayでChartBoostを広告ネットワークとして稼働させる方法についてステップ バイ ステップで説明します。
前提条件
- リワード広告、インタースティシャル広告、またはバナー広告をアプリケーションに正しく統合していることを確認します。インテグレーション手順については、以下のプラットフォーム固有のガイドを参照してください。
- Chartboost iOS 11 以降を使用するデバイスをサポートします。
ステップ 1. ChartBoostアカウントの作成
ステップ 2. ChartBoost でのアプリケーションの作成
初めて Chartboost アカウントを設定する場合は、以下に進みます。
- 初めてログインするときは、開始! を選択します。

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

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

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

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

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

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

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

登録ユーザープロセス
以前に Chartboost アカウントを設定し、LevelPlay の Mediation プラットフォームで使用する新しいアプリケーションを追加する場合は、このセクションに従ってください。
- ログインしたら、ダッシュボード> 公開> アプリケーションの追加 を選択します。

- アプリケーションの詳細を定義します。
- プラットフォーム - iOS または Android。
- アプリケーション ニックネーム - Chartboost Reporting UIでアプリケーションを表すために使用されます。
- Orientation (向き) - 「横向き」または「縦向き」を選択します。
- Test Mode (テストモード) - 'Disabled' (無効) を選択します。完了したら、'Save' を選択します。 ironsource アカウントの場合と同様に、プラットフォーム (iOS + Android) ごとに一意の Chartboost アプリケーションが必要です。

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

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

ステップ 3. ChartBoost公開キャンペーンの作成
Unity LevelPlay を通じて Chartboost の広告インベントリをアプリケーションに提供するには、Chartboost で公開キャンペーンを作成する必要があります。
- Chartboostダッシュボードの左下隅にあるAdd a Campaignをクリックし、ネットワーク公開をクリックします。

- 「Simple Settings(シンプル設定)」セクションで、「Ad Type(広告タイプ)」ドロップダウンに配信する広告のタイプ(リワード広告または静的インタースティシャル)を指定します。Unity LevelPlay でリワード広告とインタースティシャル広告の両方を配信したい場合は、2 つの異なるキャンペーンを作成する必要があります。
- [Save] をクリックしますキャンペーンの稼働には最大 20 分かかる場合があります。
アプリケーションのターゲティング オプションを定義するには、Chartboost の説明に従ってください。
ステップ 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 のパラメータの取得
- App ID & アプリケーション署名ダッシュボード>アプリケーション設定>基本設定に戻り、リストされているApp IDとアプリケーション署名を入力します。

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

LevelPlayアカウントにChartboostパラメーターを設定
これらのパラメータをすべて設定したら、LevelPlay アカウントにログインします。
- Monetize> 設定> SDK networks に移動し、manage networks を選択します。

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

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

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

- Reporting API とのインテグレーションを確認します。この列では、Reporting API を通じたインテグレーションを確認し、次の 3 つの応答を返します。検証済み、失敗、無反応。インテグレーションと上で入力した情報を再確認し、検証済み(Verified) が表示されるまで 再試行(Retry) を選択します。
ステップ 5. ビルドへの ChartBoost Adapter の追加
Unity インテグレーション マネージャ(推奨)
SDK インテグレーションが完了したら、Unity インテグレーションマネージャーを使用して ChartBoost Adapter をダウンロードできます。
Unity Development プラットフォームで、LevelPlay > インテグレーションマネージャー に移動します。
すでに最新バージョンのアダプタがある場合は、アクション ボタンが「Updated」に変わり、無効になります。
Android (手動解決)
変更を適用するには、必ず「解決」プロセスを使用してください。これにより、選択に応じて関連するアーティファクトがすべてダウンロードされます。詳細については、こちらの手順を参照してください。
ProGuard ユーザーのみ (Android)
ProGuard を ChartBoost アダプタとともに使用する場合は、ProGuard 設定に以下のコードを追加する必要があります (Android Studio: proguard-rules.Pro または Eclipse: proguard-project.txt)。
-keep class com.chartboost.** { *; }
Android プラグイン手動インテグレーション
- Chartboost Androidアダプターをダウンロードします。ここからアダプタをダウンロードします。
- Chartboost ファイルを Unity プロジェクトに追加 Assets/Plugins/Android/ にファイルをインポートします。
Unity プラグイン iOS 手動インテグレーション
- Chartboost iOS アダプターと SDK をダウンロードします。iOS のメディエーションネットワーク を参照してください。
- Chartboost ファイルを Unity プロジェクトに追加します。アダプタと SDK ファイルを Assets/Plugins/iOS にインポート。Unity プラグインは、Xcode プロジェクトに必要なフレームワークを自動的に追加します。
広告ネットワークインテグレーションの確認
-
インテグレーションヘルパーを使用して広告ネットワークのインテグレーションを確認します。LevelPlay SDK は、SDK と追加のネットワークアダプタを正常に統合するためのツールを提供します。
-
このブーリアンを使用して統合メディエーション広告ネットワークのデバッグを管理するLevelPlay.SetAdaptersDebug(true);trueに設定すると、このコード行でデバッグログが有効になり、それが許可されているすべてのメディエーション広告ネットワークに関する問題のトラブルシューティングに役立ちます。 アプリケーションを広告ユニットで稼働させる前に、このコードを削除してください。 SDK バージョン 6.5.2 以降でサポートされます。
ステップ 6.Chartboost の追加設定
ユーザーレベルのCOPPA
ChartBoost では、アプリケーションが子指向の場合は、true または false の値を設定して適切な動作を定義する必要があります。LevelPlayのメディエーションにより、パブリッシャーはChartboostのユーザー レベルのCOPPA設定をChartboostネットワークに直接送信できます。この特徴は、LevelPlay SDK 7.2.4、Chartboost Adapter 4.3.14 を使用して有効化されます。
以下の構文を使用して、Chartboost Chartboost_COPPA フラグをパラメーター true で設定し、これが子ディレクテッドであることをレポートします。
LevelPlay.SetMetaData("Chartboost_Coppa","true");
以下の構文を使用して、Chartboost Chartboost_COPPA フラグをパラメーター false で設定し、これが子ディレクテッドでないことをレポートします。
LevelPlay.SetMetaData("Chartboost_Coppa","false");
ChartboostのCOPPA要件の詳細については、こちらを参照してください。
Unity LevelPlay を通じて Chartboost Ads を配信できるようになりました。
次のステップ
Unity LevelPlay を通じて追加の広告ネットワークを活用するには、アダプタを統合し、インテグレーションガイドに従います。