Chartboostインテグレーション
React ネイティブ アプリケーションで Chartboost を Unity LevelPlay と統合します。このガイドでは、アカウント設定、アプリケーション設定、広告ロケーションの作成、キャンペーン設定、パラメーター取得、Unity Dashboard でのアクティベーション、アダプターのインテグレーション、COPPA 設定について説明します。
読み終わるまでの所要時間 8 分最終更新 7日前
重要
以下のドキュメントでは、Unity が開発、所有、または運用するものではない製品またはサービス ("サードパーティ製品") を取り上げます。
その情報は、古かったり、不完全であったりする可能性がありますが、利便性のために提供しています。
サードパーティ製品を使用する際は、その製品の規約に従うものとします。
Unity はそれらの製品に関して一切保証を行わず、その使用によって生じた損害や損失 (サードパーティプロバイダーのコンテンツ、広告、製品、資料に関する問題を含む) について責任を負いません。
このガイドでは、React ネイティブ アプリケーションで Chartboost を Unity LevelPlay と統合する方法について説明します。アカウント設定からChartboostアダプターとSDKをプロジェクトに統合するまでの全プロセスをカバーします。
トピック | 説明 |
|---|---|
| Create and set up your account | Chartboostにサインアップして、アカウント、支払い、通知、ユーザー設定を完了します。 |
| Add your app to the dashboard | Chartboost ダッシュボードで各アプリケーションを登録し、フォーマットと COPPA 状態を設定します。 |
| Create ad location. | 形式ごとに入札広告の場所を定義し、Chartboost広告がアプリケーション内で配信される場所をコントロールします。 |
| Create a campaign | 指定したターゲットでのリワード広告とインタースティシャル広告の公開キャンペーンを設定します。 |
| Retrieve required parameters | LevelPlay 設定のために App ID、アプリケーション署名、ユーザー ID、ユーザー署名、場所 ID を収集します。 |
| Activate Chartboost | Unity DashboardでChartboostの認証情報を入力し、レポートAPIの接続を確認します。 |
| Add the Chartboost adapter | AndroidおよびiOSのネイティブ ガイドを使用して、ChartboostアダプターとSDKを統合します。 |
| Configure COPPA behavior | アプリケーションの子指向状態に一致するようにChartboost COPPAメタデータを設定します。 |
前提条件
Unity LevelPlay で Chartboost をアクティベートする前に、アプリケーションとプロジェクトで以下の前提条件を満たしていることを確認してください。
- アプリケーションに動画リワード広告、インタースティシャル広告、またはバナー広告が統合されている。
- プロジェクトに LevelPlay SDK が含まれている。
- アプリケーションは Chartboost の Android OS 要件の API 19 (Android 4.4 KitKat) を満たしています。詳細については、Android 入門ドキュメントを参照してください。
- Chartboost は iOS 11 以降を使用するデバイスをサポートします。
動画リワード広告、インタースティシャル広告、またはバナー広告をアプリケーションに正しく統合していることを確認します。インテグレーション手順については、以下のプラットフォーム固有のガイドを参照してください。
ChartBoostアカウントの作成と設定
Chartboostアカウントを作成および設定して、アプリケーションの追加、支払いの詳細の設定、Unity LevelPlayによるメディエーションの広告掲載場所の準備を行うことができます。
- Chartboostアカウントにサインアップします。
- Eメール検証を通じてChartboostアカウントを作成および検証します。
- Chartboostダッシュボードにサインインし、次のステップに従ってアカウントを設定します。
- 支払詳細の追加 - Chartboost が収益の送金先を把握していることを確認します。
- 通知の設定
- 必要に応じてユーザーを追加する。
Chartboost ダッシュボードにアプリケーションを追加する
Chartboost ダッシュボードにアプリケーションを登録し、SDK のインテグレーションとキャンペーンの設定を開始します。ChartBoostを初めて使用する場合は、初回設定の手順に従ってください。そうでない場合は、登録済みの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 とユーザー署名を入力します。
注
検証では以下が返されます。検証済み、失敗、無反応
ビルドにChartboostアダプターを追加する
Reactネイティブ アプリケーションでChartboost SDKをUnity LevelPlayと統合するには、ネイティブ プラットフォーム ガイドを使用してChartboostアダプターを追加します。
インテグレーションヘルパーの使用
テストデバイスでアプリケーションの開発ビルドをビルドして実行し、LevelPlay インテグレーションヘルパー画面を開きます。これを使用して、LevelPlay SDK、Chartboost SDK、Chartboost アダプターがすべてエラーなしで統合されたように表示されることを確認します。
開発ビルドでは、LevelPlay SDK を初期化する前に以下のメソッドを呼び出してアダプターのデバッグを有効にします。
「Unity-levelplay-mediation」からのインポート{ LevelPlay }LevelPlay.setAdaptersDebug(true)
注
アダプタ デバッグ ログは SDK バージョン 6.5.2 以降でサポートされます。アプリケーションをリリースする前に、この呼び出しを削除します。
Chartboost COPPA動作の設定
ChartBoost では、アプリケーションが子指向かどうかを指定する必要があります。
アプリケーションの初期化コードで、LevelPlay SDK を初期化する前に、 メタデータ キーを設定して、アプリケーションが Chartboost の子指向かどうかを設定します。
CHARTBOOST_COPPA児童指導
「Unity-levelplay-mediation」からのインポート{ LevelPlay }LevelPlay.setMetaData('CHARTBOOST_COPPA', ['YES'])
子プロセスではない:
「Unity-levelplay-mediation」からのインポート{ LevelPlay }LevelPlay.setMetaData('CHARTBOOST_COPPA', ['NO'])
Chartboost ダッシュボードでアプリケーションを追加するときは、COPPA 設定も指定する必要があります。アプリケーション内メタデータと Chartboost ダッシュボードボードの設定が、アプリケーションの実際のオーディエンスと一致していることを確認します。
詳細については、ChartboostのCOPPAドキュメントを参照してください。
次のステップ
Unity LevelPlay を通じて Chartboost 広告を配信できるようになりました。
Unity LevelPlay を通じて追加の広告ネットワークを活用するには、アダプタを統合し、インテグレーションガイドに従ってください。