このガイドでは、Google Mobile Ads SDK を使用して、 AdMob メディエーション、 ウォーターフォール統合を使用して、Chartboost の広告を読み込んで表示する方法について説明します。ここでは、Chartboost を広告ユニットのメディエーション構成に追加する方法と、Chartboost SDK とアダプタをアプリに統合する方法について説明します。 Android
サポートされている統合と広告フォーマット
Chartboost のメディエーション アダプタには、次の機能があります。
統合 | |
---|---|
単価設定 | |
滝 | |
フォーマット | |
バナー | |
インタースティシャル | |
特典 | |
ネイティブ |
要件
- Android API レベル 21 以降
最新の Google Mobile Ads SDK
メディエーションのスタートガイドを完了していること
ステップ 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 デマンドを設定する
広告ユニットのメディエーション設定を構成する
広告ユニットのメディエーション設定に Chartboost を追加する必要があります。
まず、AdMob アカウントにログインします。次に、[メディエーション] タブに移動します。既存のメディエーション グループを変更する場合は、そのメディエーション グループの名前をクリックして編集し、Chartboost を広告ソースとして追加するに進みます。
新しいメディエーション グループを作成するには、[メディエーション グループを作成] を選択します。
広告フォーマットとプラットフォームを入力し、[続行] をクリックします。
メディエーション グループに名前を付け、ターゲットとする地域を選択します。次に、メディエーション グループのステータスを [有効] に設定し、[広告ユニットを追加] をクリックします。
このメディエーション グループを、既存の AdMob 広告ユニットに関連付けます。次に [完了] をクリックします。
選択した広告ユニットが広告ユニットカードに表示されます。
Chartboost を広告ソースとして追加する
[広告ソース] セクションの [ウォーターフォール] カードで、[広告ソースを追加] を選択します。[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 を追加
GDPR 設定と米国の州規制の設定の手順に沿って、AdMob 管理画面の GDPR と米国の州規制の広告パートナー リストに Chartboost を追加します。
ステップ 3: Chartboost SDK とアダプターをインポートする
Android Studio との統合(推奨)
プロジェクト レベルの settings.gradle.kts
ファイルに、次のリポジトリを追加します。
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://cboost.jfrog.io/artifactory/chartboost-ads/")
}
}
}
次に、アプリレベルの build.gradle.kts
ファイルで、次の実装依存関係と構成を追加します。Chartboost SDK とアダプタの最新バージョンを使用します。
dependencies {
implementation("com.google.android.gms:play-services-ads:23.5.0")
implementation("com.google.ads.mediation:chartboost:9.8.0.0")
}
手動による統合
Maven Central から Chartboost SDK の最新バージョンの
.aar
ファイルをダウンロードし、プロジェクトに追加します。Google の Maven リポジトリで Chartboost アダプター アーティファクトに移動します。最新バージョンを選択し、Chartboost アダプターの
.aar
ファイルをダウンロードしてプロジェクトに追加します。
ステップ 4: Chartboost SDK にプライバシー設定を実装する
EU ユーザーの同意と GDPR
Google の EU ユーザーの同意ポリシーに基づき、デバイス ID と個人データの使用について、欧州経済領域(EEA)のユーザーに対して特定の情報を開示し、同意を得る必要があります。このポリシーには、EU の e プライバシー指令と一般データ保護規則(GDPR)の要件が反映されています。同意を求める際は、メディエーション チェーン内の個人データを収集、受領、または使用する可能性がある各広告ネットワークを特定し、各ネットワークの使用に関する情報を提供する必要があります。現在のところ、Google はユーザーの同意に関する選択を自動的にこのようなネットワークに渡すことはできません。
SDK バージョン 8.1.0 で、Chartboost に addDataUseConsent()
メソッドが追加されました。次のサンプルコードは、データ使用の同意を NON_BEHAVIORAL
に設定します。このメソッドを呼び出す場合は、Google Mobile Ads 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
に設定します。このメソッドを呼び出す場合は、Google Mobile Ads 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: 必要なコードを追加する
AndroidManifest を変更する
その他の要素
Chartboost 広告を表示し、さまざまな画面の向きをサポートする AndroidManifest.xml
ファイル内の各アクティビティに、次の属性を追加します。
android:configChanges="keyboardHidden|orientation|screenSize"
ライフサイクル イベント
Chartboost の推奨に従い、Chartboost 広告を表示するアクティビティのライフサイクル イベントすべてに次のコードを追加します。
Java
import com.chartboost.sdk.Chartboost;
// ...
@Override
public void onBackPressed() {
// If an interstitial is on screen, close it.
if (Chartboost.onBackPressed()) {
return;
} else {
super.onBackPressed();
}
}
Kotlin
import com.chartboost.sdk.Chartboost
// ...
@Override
fun onBackPressed() {
// If an interstitial is on screen, close it.
if (Chartboost.onBackPressed())
return
else
super.onBackPressed()
}
ステップ 6: 実装をテストする
テスト広告を有効にする
AdMob にテストデバイスを登録し、Chartboost の管理画面でテストモードを有効にしてください。
テスト広告を確認する
Chartboost からテスト広告が配信されていることを確認するには、広告インスペクタで Chartboost(ウォーターフォール)広告ソースを使用して単一の広告ソースのテストを有効にします。
省略可能なステップ
権限
パフォーマンスを最適化するため、Chartboost では、アプリの AndroidManifest.xml
ファイルに次のオプションの権限を追加することをおすすめします。
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
エラーコード
アダプターが Chartboost から広告を受信できない場合は、
ResponseInfo.getAdapterResponses()
次のクラスで、広告レスポンスの基盤となるエラーを確認できます。
com.google.ads.mediation.chartboost.ChartboostAdapter
com.google.ads.mediation.chartboost.ChartboostMediationAdapter
広告の読み込みに失敗したときに Chartboost アダプターからスローされるコードと付随するメッセージは次のとおりです。
エラーコード | 理由 |
---|---|
0-99 | Chartboost SDK がエラーを返しました。詳しくは、Chartboost のドキュメントをご覧ください。 |
101 | リクエストされた広告サイズが、Chartboost でサポートされているバナーサイズと一致しません。 |
102 | Chartboost では、一度に読み込める広告は 1 つの場所につき 1 つだけです。 |
103 | AdMob UI で構成された Chartboost サーバー パラメータが欠落しているか、無効です。 |
104 | Chartboost のインタースティシャル広告またはリワード広告を表示する準備ができていない。 |
Chartboost Android メディエーション アダプターの変更履歴
バージョン 9.8.0.0
- Chartboost SDK バージョン 9.8.0 との互換性が確認されました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 23.4.0。
- Chartboost SDK バージョン 9.8.0。
バージョン 9.7.0.0
- Chartboost SDK バージョン 9.7.0 との互換性が確認されました。
- 必須の Google Mobile Ads SDK バージョンを 23.0.0 に更新しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 23.0.0。
- Chartboost SDK バージョン 9.7.0。
バージョン 9.6.1.0
- Chartboost SDK バージョン 9.6.1 との互換性が確認されました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 22.6.0。
- Chartboost SDK バージョン 9.6.1。
バージョン 9.6.0.0
- Chartboost SDK バージョン 9.6.0 との互換性が確認されました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 22.5.0。
- Chartboost SDK バージョン 9.6.0。
バージョン 9.5.0.0
- Chartboost SDK バージョン 9.5.0 との互換性が確認されました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 22.3.0。
- Chartboost SDK バージョン 9.5.0。
バージョン 9.4.1.0
- Chartboost SDK バージョン 9.4.1 との互換性が確認されました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 22.2.0。
- Chartboost SDK バージョン 9.4.1。
バージョン 9.4.0.0
- Chartboost SDK バージョン 9.4.0 との互換性が確認されました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 22.1.0。
- Chartboost SDK バージョン 9.4.0。
バージョン 9.3.1.0
- Chartboost SDK バージョン 9.3.1 との互換性が確認されました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 22.1.0。
- Chartboost SDK バージョン 9.3.1。
バージョン 9.3.0.0
- Chartboost SDK バージョン 9.3.0 との互換性が確認されました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 22.0.0。
- Chartboost SDK バージョン 9.3.0。
バージョン 9.2.1.1
- 新しい
VersionInfo
クラスを使用するようにアダプターを更新しました。 - 必須の Google Mobile Ads SDK バージョンを 22.0.0 に更新しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 22.0.0。
- Chartboost SDK バージョン 9.2.1。
バージョン 9.2.1.0
- Chartboost SDK 9.2.1 との互換性が確認されました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 21.5.0。
- Chartboost SDK バージョン 9.2.1。
バージョン 9.2.0.0
- Chartboost SDK 9.2.0 との互換性を確認しました。
- 必要最小限の Google Mobile Ads SDK バージョンを 21.5.0 に更新しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 21.5.0。
- Chartboost SDK バージョン 9.2.0。
バージョン 9.1.1.0
- Chartboost SDK の初期化に使用するアプリ ID とアプリ署名をハードコードするオプションの方法として、
ChartboostMediationAdapter.setAppParams(String, String)
メソッドを追加しました。 - Chartboost SDK 9.1.1 との互換性が確認されました。
- 必須の Google Mobile Ads SDK バージョンを 21.3.0 に更新しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 21.3.0。
- Chartboost SDK バージョン 9.1.1。
バージョン 8.4.3.1
- 必須の Google Mobile Ads SDK バージョンを 21.0.0 に更新しました。
- 必要最小限の Android API レベルを 19 に更新しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 21.0.0。
- Chartboost SDK バージョン 8.4.3。
バージョン 8.4.3.0
- Chartboost SDK 8.4.3 との互換性が確認されました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 20.6.0。
- Chartboost SDK バージョン 8.4.3。
バージョン 8.4.2.0
- Chartboost SDK 8.4.2 との互換性が確認されました。
compileSdkVersion
とtargetSdkVersion
を API 31 に更新しました。- 必須となる Google Mobile Ads SDK のバージョンを 20.6.0 に更新しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 20.6.0。
- Chartboost SDK バージョン 8.4.2。
バージョン 8.4.1.0
- Chartboost SDK 8.4.1 との互換性が確認されました。
- 必須となる Google Mobile Ads SDK のバージョンを 20.6.0 に更新しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 20.6.0。
- Chartboost SDK バージョン 8.4.1。
バージョン 8.3.1.0
- Chartboost SDK 8.3.1 との互換性が確認されました。
- 新しい
AdError
API を使用するようにアダプターを更新しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 20.5.0。
- Chartboost SDK バージョン 8.3.1。
バージョン 8.3.0.0
- Chartboost SDK 8.3.0 との互換性が確認されました。
- 必須となる Google Mobile Ads SDK のバージョンを 20.5.0 に更新しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 20.5.0。
- Chartboost SDK バージョン 8.3.0。
バージョン 8.2.1.0
- Chartboost SDK 8.2.1 との互換性が確認されました。
- 必要最小限の Google Mobile Ads SDK バージョンを 20.1.0 に更新しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 20.1.0。
- Chartboost SDK バージョン 8.2.1。
バージョン 8.2.0.1
- 必要最小限の Google Mobile Ads SDK バージョンを 20.0.0 に更新しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 20.0.0。
- Chartboost SDK バージョン 8.2.0。
バージョン 8.2.0.0
- Chartboost SDK 8.2.0 との互換性を確認しました。
- 必須となる Google Mobile Ads SDK のバージョンを 19.5.0 に更新しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 19.5.0。
- Chartboost SDK バージョン 8.2.0。
バージョン 8.1.0.0
- Chartboost SDK 8.1.0 との互換性が確認されました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 19.2.0。
- Chartboost SDK バージョン 8.1.0。
バージョン 8.0.3.2
- アダプターの読み込み/表示の失敗に関するわかりやすいエラーコードと理由を追加しました。
- 必須の Google Mobile Ads SDK のバージョンを 19.2.0 に更新しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 19.2.0。
- Chartboost SDK バージョン 8.0.3。
バージョン 8.0.3.1
- Chartboost バナー広告のサポートを追加しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 19.1.0。
- Chartboost SDK バージョン 8.0.3。
バージョン 8.0.3.0
- Chartboost SDK 8.0.3 との互換性が確認されました。
- 必須となる Google Mobile Ads SDK のバージョンを 19.1.0 に更新しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 19.1.0。
- Chartboost SDK バージョン 8.0.3。
バージョン 8.0.2.0
- Chartboost SDK 8.0.2 との互換性を確認しました。
- 必須の Google Mobile Ads SDK バージョンを 19.0.1 に更新しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 19.0.1。
- Chartboost SDK バージョン 8.0.2。
バージョン 8.0.1.0
- Chartboost SDK 8.0.1 との互換性が確認されました。
- Chartboost SDK 8.0.1 以降が必要です。
- 広告の読み込みにアクティビティ コンテキストが必要ではなくなりました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 18.3.0。
- Chartboost SDK バージョン 8.0.1。
バージョン 7.5.0.1
- Chartboost アダプタが広告イベントを呼び出せないバグを修正しました。
- 必要最小限の Google Mobile Ads SDK バージョンを 18.3.0 に更新しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 18.3.0。
- Chartboost SDK バージョン 7.5.0。
バージョン 7.5.0.0
- Chartboost SDK 7.5.0 との互換性が確認されました。
- AndroidX 依存関係を使用するようにアダプタを移行しました。
- 必要最小限の Google Mobile Ads SDK バージョンを 18.1.1 に更新しました。
バージョン 7.3.1.1
- 新しいオープンベータ版の Rewarded API をサポートするようにアダプターを更新しました。
- 必須となる Google Mobile Ads SDK のバージョンを 17.2.0 に更新しました。
バージョン 7.3.1.0
- Chartboost SDK 7.3.1 との互換性が確認されました。
バージョン 7.3.0.0
- Chartboost SDK 7.3.0 との互換性が確認されました。
バージョン 7.2.1.0
- Chartboost SDK 7.2.1 との互換性が確認されました。
バージョン 7.2.0.1
onRewardedVideoComplete()
広告イベントを呼び出すようにアダプターを更新しました。
バージョン 7.2.0.0
- Chartboost SDK 7.2.0 との互換性が確認されました。
バージョン 7.1.0.0
- Chartboost SDK 7.1.0 との互換性が確認されました。
バージョン 7.0.1.0
- Chartboost SDK 7.0.1 との互換性が確認されました。
- 新しい Chartboost エラーコードのサポートを追加しました。
- Android Studio 3.0 用のアダプター プロジェクトを更新しました
バージョン 7.0.0.0
- Chartboost SDK 7.0.0 との互換性を確保するためにアダプターを更新しました。
バージョン 6.6.3.0
- Chartboost SDK 6.6.3 との互換性が確認されました。
バージョン 6.6.2.0
- Chartboost SDK 6.6.2 との互換性が確認されました。
バージョン 6.6.1.0
- Chartboost SDK 6.6.1 との互換性を確認しました。
バージョン 6.6.0.0
- バージョン命名システムを [Chartboost SDK バージョン].[アダプター パッチ バージョン] に変更しました。
- アダプターをコンパイル依存関係として追加するには、build.gradle ファイルの dependencies タグに次の行を追加します。
compile 'com.google.ads.mediation:chartboost:6.6.0.0'
- アダプターを jar ファイルではなく aar として配布するように変更しました(詳細な手順については、README をご覧ください)。
バージョン 1.1.0
- Chartboost の追加機能から Chartboost 広告の場所を削除しました。メディエーション用に Chartboost を構成する際に、AdMob コンソールで広告の場所を指定できるようになりました。
バージョン 1.0.0
- 初版リリース。リワード ベースの動画広告とインタースティシャル広告に対応しています。