Chartboost をメディエーションと統合する

このガイドでは、Google Mobile Ads SDK を使用して、ウォーターフォール統合をカバーするメディエーションを使用して Chartboost の広告を読み込んで表示する方法について説明します。ここでは、Chartboost を広告ユニットのメディエーション構成に追加する方法と、Chartboost SDK とアダプターを Flutter アプリに統合する方法について説明します。

サポートされている統合と広告フォーマット

Chartboost 用の AdMob メディエーション アダプタには、次の機能があります。

要件

• 最新の Google Mobile Ads SDK
• Flutter 3.7.0 以降
• Android にデプロイするには
  • Android API レベル 21 以降
• iOS にデプロイするには
  • iOS デプロイ ターゲットが 12.0 以降
• Google Mobile Ads SDK で構成された、動作する Flutter プロジェクト。詳細については、スタートガイドをご覧ください。
• メディエーションのスタートガイドを完了していること

ステップ 1: Chartboost UI で設定を行う

Chartboost アカウントに登録し、アカウントの確認が完了したらログインします。次に、[アプリの管理] タブに移動します。

[新しいアプリを追加] ボタンをクリックしてアプリを作成します。

フォームの残りの部分に記入し、[アプリを追加] ボタンをクリックしてアプリを確定します。

アプリが作成されると、ダッシュボードに移動します。アプリのアプリ ID とアプリ署名をメモします。

AdMob 広告ユニット ID を設定するには、Chartboost のユーザー ID とユーザー署名が必要です。これらのパラメータは、Chartboost UI で [Chartboost メディエーション] をクリックすると確認できます。

[リソース > API Explorer] タブに移動し、[認証] セクションにある ユーザー ID と ユーザー署名をメモします。

テストモードをオンにする

アプリでテストモードを有効にするには、Chartboost UI の [アプリ管理] タブに移動し、リストからアプリを選択して [アプリ設定を編集] をクリックします。

アプリの設定で、アプリのテストモードを切り替えることができます。

テストモードを有効にすると、先ほど作成した広告ユニット ID を使用して広告をリクエストし、Chartboost のテスト広告を受け取ることができます。

Chartboost のテスト広告を受け取れる状態になると、アプリは Chartboost のパブリッシャー アプリの審査に登録されます。Chartboost で収益化を有効にするには、パブリッシャーのアプリ審査が Chartboost によって承認されている必要があります。

ステップ 2: AdMob UI で Chartboost デマンドを設定する

広告ユニットのメディエーション設定を構成する

GDPR と米国の州規制の広告パートナー リストに Chartboost を追加

GDPR 設定と米国の州規制の設定の手順に沿って、AdMob 管理画面の GDPR と米国の州規制の広告パートナー リストに Chartboost を追加します。

ステップ 3: Chartboost SDK とアダプターをインポートする

pub.dev を介した統合

パッケージの pubspec.yaml ファイルに、Chartboost SDK とアダプターの最新バージョンを含む次の依存関係を追加します。

dependencies:
  gma_mediation_chartboost: ^1.0.0

手動による統合

Chartboost 用の Google モバイル広告メディエーション プラグインの最新バージョンをダウンロードし、ダウンロードしたファイルを解凍して、解凍したプラグイン フォルダ（とその内容）を Flutter プロジェクトに追加します。次に、次の依存関係を追加して、pubspec.yaml ファイルでプラグインを参照します。

dependencies:
  gma_mediation_chartboost:
    path: path/to/local/package

ステップ 4: Chartboost SDK にプライバシー設定を実装する

EU の同意と GDPR

Google の EU ユーザーの同意ポリシーに基づき、デバイス ID と個人データの使用について、欧州経済領域（EEA）のユーザーに対して特定の情報を開示し、同意を得る必要があります。このポリシーには、EU の e プライバシー指令と一般データ保護規則（GDPR）の要件が反映されています。同意を求める際は、個人データを収集、受信、使用する可能性があるメディエーション チェーン内の各広告ネットワークを特定し、各ネットワークの使用に関する情報を提供する必要があります。現在のところ、Google はユーザーの同意に関する選択を自動的にこのようなネットワークに渡すことはできません。

Chartboost バージョン 3.1.0 用の Google Mobile Ads メディエーション プラグインには、Chartboost.AddDataUseConsent() メソッドが含まれています。次のサンプルコードでは、データ使用の同意を NonBehavioral に設定しています。このメソッドを呼び出す場合は、Google Mobile Ads SDK を使用して広告をリクエストする前に呼び出すことをおすすめします。

using GoogleMobileAds.Api.Mediation.Chartboost;
// ...

Chartboost.AddDataUseConsent(CBGDPRDataUseConsent.NonBehavioral);

米国のプライバシー関連州法

米国の州のプライバシー法 は、ユーザーに「個人情報」の「販売」を拒否する権利を保障する法律で、「販売者」パーティのホームページにある「個人情報を販売しない」リンクから販売を拒否することができます。米国の州のプライバシー関連法の遵守ガイドでは、Google 広告配信で制限付きデータ処理を有効にできますが、Google はメディエーション チェーン内の各広告ネットワークにこの設定を適用することはできません。そのため、個人情報の販売に関与する可能性があるメディエーション チェーンの各広告ネットワークを特定し、各ネットワークのガイダンスに沿ってコンプライアンスを確保する必要があります。

Chartboost バージョン 3.1.0 用の Google Mobile Ads メディエーション プラグインには、Chartboost.AddDataUseConsent() メソッドが含まれています。次のサンプルコードでは、データ使用の同意を OptInSale に設定しています。このメソッドを呼び出す場合は、Google Mobile Ads SDK を使用して広告をリクエストする前に呼び出すことをおすすめします。

using GoogleMobileAds.Api.Mediation.Chartboost;
// ...

Chartboost.AddDataUseConsent(CBCCPADataUseConsent.OptInSale);

ステップ 5: 必要なコードを追加する

ステップ 6: 実装をテストする

テスト広告を有効にする

AdMob にテストデバイスを登録し、Chartboost の管理画面でテストモードを有効にしてください。

テスト広告を確認する

Chartboost からテスト広告が配信されていることを確認するには、広告インスペクタで Chartboost（ウォーターフォール）広告ソースを使用して単一の広告ソースのテストを有効にします。

省略可能な手順

<uses-permission android:name="android.permission.READ_PHONE_STATE" />

エラーコード

アダプターが Chartboost から広告を受信できない場合、パブリッシャーは次のクラスの ResponseInfo を使用して、広告レスポンスから根本的なエラーを確認できます。

com.google.ads.mediation.chartboost.ChartboostAdapter
com.google.ads.mediation.chartboost.ChartboostMediationAdapter

GADMAdapterChartboost
GADMediationAdapterChartboost

広告の読み込みに失敗したときに Chartboost アダプタからスローされるコードとそれに付随するメッセージは次のとおりです。

Chartboost Flutter メディエーション アダプタの変更履歴

1.0.0

• 初回リリース。
• Chartboost Android アダプター バージョン 9.8.1.0 との互換性が確認済み
• Chartboost iOS アダプター バージョン 9.8.0.0 との互換性を確認しました
• Google Mobile Ads Flutter プラグイン バージョン 5.2.0 でビルド、テスト済み。