このガイドでは、GMA Next-Gen SDK を使用して AdMob メディエーションで Chartboost の広告を読み込んで表示する方法とウォーターフォール統合について説明します。また、広告ユニットのメディエーション設定に Chartboost を追加する方法と、Chartboost SDK とアダプタを Android アプリに統合する方法についても取り上げます。
サポートされている統合と広告フォーマット
Chartboost 用のメディエーション アダプタには、次の機能があります。
| 統合 | |
|---|---|
| 入札 | |
| ウォーターフォール | |
| フォーマット | |
| バナー | |
| インタースティシャル | |
| リワード | |
| ネイティブ | |
要件
- Android API レベル 24 以降
GMA Next-Gen SDK の最新動画
メディエーションのスタートガイドの手順を完了していること
ステップ 1: Chartboost UI で構成を設定する
Chartboost アカウントに登録し、アカウントが確認されたらログインします。[アプリの管理] タブに移動します。
[Add new app] ボタンをクリックしてアプリを作成します。
フォームの残りの部分を入力し、[アプリを追加] ボタンをクリックしてアプリを確定します。
アプリが作成されると、アプリのダッシュボードに移動します。アプリのアプリ ID とアプリ署名をメモします。
AdMob の広告ユニット ID を設定するには、Chartboost のユーザー ID とユーザー署名が必要です。これらのパラメータは、Chartboost UI で [Chartboost mediation] をクリックすると確認できます。
[リソース] > [API Explorer] タブに移動し、[認証] セクションにある [ユーザー ID] と [ユーザー署名] をメモします。
app-ads.txt を更新する
アプリの認定販売者 app-ads.txt は、IAB Tech Lab が推進するイニシアチブで、承認されたチャネルでのみアプリ広告枠を販売できるようにするものです。広告収入の大幅な減少を防ぐためには、app-ads.txt ファイルを実装する必要があります。まだ設定していない場合は、アプリの app-ads.txt ファイルを設定します。
Chartboost に app-ads.txt を実装するには、app-ads.txt をご覧ください。
テストモードをオンにする
アプリのテストモードを有効にするには、Chartboost UI の [Apps management] タブに移動し、リストからアプリを選択して [Edit app settings] をクリックします。
アプリの設定で、アプリのテストモードを切り替えることができます。
テストモードを有効にすると、先ほど作成した広告ユニット ID を使用して広告をリクエストし、Chartboost のテスト広告を受け取ることができます。
Chartboost のテスト広告を受信できるようになると、アプリは Chartboost のパブリッシャー アプリ審査に登録されます。Chartboost で収益化を行うには、パブリッシャー アプリの審査が Chartboost によって承認される必要があります。
ステップ 2: AdMob の UI で Chartboost のデマンドを設定する
広告ユニットのメディエーション設定を構成する
広告ユニットのメディエーション設定に Chartboost を追加する必要があります。
まず、AdMob アカウントにログインします。次に、[メディエーション] タブに移動します。変更したい既存のメディエーション グループがある場合は、そのメディエーション グループの名前をクリックして編集し、広告ソースとして Chartboost を追加するに進みます。
新しいメディエーション グループを作成するには、[メディエーション グループを作成] を選択します。
広告フォーマットとプラットフォームを入力し、[続行] をクリックします。
メディエーション グループに名前を付け、ターゲットとする地域を選択します。次に、メディエーション グループのステータスを [有効] に設定し、[広告ユニットを追加] をクリックします。
このメディエーション グループを、1 つ以上の既存の AdMob 広告ユニットに関連付けます。次に [完了] をクリックします。
広告ユニット カードに選択した広告ユニットが表示されます。
広告ソースとして Chartboost を追加する
[広告のソース] セクションの [ウォーターフォール] カードで、[広告ソースを追加] を選択します。
[Chartboost] を選択し、[最適化] スイッチをオンにします。前のセクションで取得したユーザー ID とユーザー シグネチャを入力して、Chartboost の広告ソース最適化を設定します。次に、Chartboost の eCPM 値を入力し、[続行] をクリックします。
Chartboost のマッピングがすでに存在する場合は、それを選択できます。それ以外の場合は、[マッピングを追加] をクリックします。
次に、前のセクションで取得したアプリ ID、アプリ署名、広告の場所を入力します。[完了] をクリックします。
Chartboost の広告の場所（名前付きの場所）は、アプリ内で広告を表示する場所を表すシンプルな名前です。AdMob は、設定で指定された場所にリクエストを送信します。リクエストが送信されると、Chartboost はレポート作成のためにプラットフォームに位置情報を追加します。また、ゲームで呼び出す前に、Chartboost プラットフォームで新しい広告掲載場所を直接作成することもできます。
Chartboost UI で広告の掲載場所を確認するには、[詳細設定] をクリックして [基本設定] ページを開きます。詳しくは、Chartboost の [Named Locations](//docs.chartboost.com/en/monetization/publishing/ad-locations/) ガイドをご覧ください。
最後に、[完了] をクリックして Chartboost を広告ソースとして追加し、[保存] をクリックします。
GDPR と米国の州規制の広告パートナー リストに Chartboost を追加する
欧州の規制に関する設定と米国の州の規制に関する設定の手順に沿って、AdMob 管理画面の欧州および米国の州の規制に関する広告パートナーのリストに Chartboost を追加します。
ステップ 3: Chartboost の SDK とアダプタをインポートする
Android Studio の統合（推奨）
プロジェクト レベルの settings.gradle.kts ファイルに、次のリポジトリを追加します。
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://cboost.jfrog.io/artifactory/chartboost-ads/")
}
}
}
アプリレベルの Gradle ファイルに、次の実装依存関係と構成を追加します。
Kotlin
dependencies { implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02") implementation("com.google.ads.mediation:chartboost:9.11.1.0") } configurations.configureEach { exclude(group = "com.google.android.gms", module = "play-services-ads") exclude(group = "com.google.android.gms", module = "play-services-ads-lite") }
Groovy
dependencies { implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02' implementation 'com.google.ads.mediation:chartboost:9.11.1.0' } configurations.configureEach { exclude group: 'com.google.android.gms', module: 'play-services-ads' exclude group: 'com.google.android.gms', module: 'play-services-ads-lite' }
手動による統合
Maven Central から Chartboost SDK の最新バージョンの
.aarファイルをダウンロードし、プロジェクトに追加します。Google の Maven リポジトリで Chartboost アダプタ アーティファクトに移動します。最新バージョンを選択し、Chartboost アダプタの
.aarファイルをダウンロードして、プロジェクトに追加します。
ステップ 4: Chartboost SDK にプライバシー設定を実装する
EU ユーザーからの同意と GDPR
Google の EU ユーザーの同意ポリシーに準拠するには、欧州経済領域（EEA）、英国、スイスのユーザーに対して特定の情報を開示し、法律で義務付けられている場合は、Cookie やその他のローカル ストレージの使用、広告のパーソナライズを目的とした個人データの収集、共有、使用についてユーザーの同意を得る必要があります。このポリシーには、EU の e プライバシー指令と一般データ保護規則（GDPR）の要件が反映されています。パブリッシャー様には、同意がメディエーション チェーン内の各広告ソースに反映されていることを確認する責任があります。 Google は、同意に関するユーザーの選択をそのようなネットワークに自動的に渡すことはできません。
SDK バージョン 8.1.0 で、Chartboost は addDataUseConsent() メソッドを追加しました。次のサンプルコードでは、データ使用の同意を NON_BEHAVIORAL に設定します。このメソッドを呼び出す場合は、GMA Next-Gen SDK を通じて広告をリクエストする前に呼び出すことをおすすめします。
Java
DataUseConsent dataUseConsent = new GDPR(GDPR.GDPR_CONSENT.NON_BEHAVIORAL);
Chartboost.addDataUseConsent(context, dataUseConsent);
Kotlin
val dataUseConsent = GDPR(GDPR.GDPR_CONSENT.NON_BEHAVIORAL)
Chartboost.addDataUseConsent(context, dataUseConsent)
詳細と各メソッドで指定できる値については、Chartboost の GDPR に関する記事と Android のプライバシー メソッドをご覧ください。
米国のプライバシー関連州法
米国のプライバシー関連州法では、ユーザーが「個人情報」の「販売」をオプトアウトする権利を付与することが義務付けられています（用語は法律の定義に基づく）。「販売者」のホームページには、「個人情報を第三者に売却しない」ことを明記したリンクを目立つように表示することによってオプトアウトの手段を提供する必要があります。米国のプライバシー関連州法遵守ガイドでは、Google 広告の配信で制限付きデータ処理を有効にできますが、Google がこの設定をメディエーション チェーン内の各広告ネットワークに適用することはできません。そのため、メディエーション チェーン内で個人情報の販売に関与する可能性のある広告ネットワークを特定し、各ネットワークのガイダンスに沿って州法を遵守する必要があります。
SDK バージョン 8.1.0 で、Chartboost は addDataUseConsent() メソッドを追加しました。次のサンプルコードでは、データ使用の同意を OPT_IN_SALE に設定します。このメソッドを呼び出す場合は、GMA Next-Gen SDK を通じて広告をリクエストする前に呼び出すことをおすすめします。
Java
DataUseConsent dataUseConsent = new CCPA(CCPA.CCPA_CONSENT.OPT_IN_SALE);
Chartboost.addDataUseConsent(context, dataUseConsent);
Kotlin
val dataUseConsent = CCPA(CCPA.CCPA_CONSENT.OPT_IN_SALE)
Chartboost.addDataUseConsent(context, dataUseConsent)
各メソッドで指定できる値の詳細については、Chartboost の CCPA に関する記事と Android のプライバシー メソッドをご覧ください。
ステップ 5: 必要なコードを追加する
更新アクティビティの構成変更
Chartboost 広告を表示し、さまざまな向きに対応する AndroidManifest.xml ファイル内の各アクティビティに、次の属性を追加します。
android:configChanges="keyboardHidden|orientation|screenSize"
ステップ 6: 実装をテストする
テスト広告を有効にする
AdMob 用のテストデバイスを登録し、Chartboost の管理画面でテストモードを有効にしてください。
テスト広告を確認する
Chartboost からテスト広告を受信していることを確認するには、Chartboost（ウォーターフォール）の広告ソースを使用して、広告インスペクタで単一の広告ソースのテストを有効にします。
省略可能なステップ
権限
最適なパフォーマンスを得るため、Chartboost はアプリの AndroidManifest.xml ファイルに次のオプションの権限を追加することをおすすめします。
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
エラーコード
アダプタが Chartboost から広告を受信できなかった場合は、次のクラスの ResponseInfo.getAdSourceResponses() を使用して、広告レスポンスから根本原因のエラーを確認できます。
com.google.ads.mediation.chartboost.ChartboostAdapter
com.google.ads.mediation.chartboost.ChartboostMediationAdapter
広告の読み込みに失敗した場合に Chartboost アダプタがスローするコードとメッセージは次のとおりです。
| エラーコード | 理由 |
|---|---|
| 0-99 | Chartboost SDK がエラーを返しました。詳しくは、Chartboost のドキュメントをご覧ください。 |
| 101 | リクエストされた広告サイズが、Chartboost でサポートされているバナーサイズと一致していません。 |
| 102 | Chartboost では、一度に 1 つの広告しか読み込めません。 |
| 103 | AdMob 管理画面で設定された Chartboost サーバー パラメータがないか、無効です。 |
| 104 | Chartboost のインタースティシャル広告またはリワード広告を表示する準備ができていません。 |