このページは Cloud Translation API によって翻訳されました。

Chartboost とメディエーションの統合

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

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

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

統合
単価設定
滝
フォーマット
バナー
インタースティシャル
特典
ネイティブ

要件

Android API レベル 21 以降

最新の Google Mobile Ads SDK
メディエーションのスタートガイドを完了している。

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

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

Chartboost アプリダッシュボード

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

アプリの管理

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

新しいアプリのフォーム

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

アプリの設定

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

Chartboost メディエーションダッシュボード

[Resources] > [API Explorer] タブに移動し、[Authentication] セクションにある [User ID] と [User Signature] をメモします。

Chartboost API Explorer

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

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

アプリの設定を編集

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

Chartboost のテストモード

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

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

ステップ 2: Ad Manager UI で 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	Ad Manager 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

新しいオープンベータ版リワード 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 用の Adapter プロジェクトの更新

バージョン 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

初版リリース。リワードベースの動画広告とインタースティシャル広告に対応しています。

Chartboost とメディエーションの統合

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

要件

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

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

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

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

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

Android Studio との統合（推奨）

手動による統合

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

EU ユーザーの同意と GDPR

Java

Kotlin

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

Java

Kotlin

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

AndroidManifest を変更する

その他の要素

ライフサイクル イベント

Java

Kotlin

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

テスト広告を有効にする

テスト広告を確認する

省略可能なステップ

権限

エラーコード

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

バージョン 9.8.0.0

バージョン 9.7.0.0

バージョン 9.6.1.0

バージョン 9.6.0.0

バージョン 9.5.0.0

バージョン 9.4.1.0

バージョン 9.4.0.0

バージョン 9.3.1.0

バージョン 9.3.0.0

バージョン 9.2.1.1

バージョン 9.2.1.0

バージョン 9.2.0.0

バージョン 9.1.1.0

バージョン 8.4.3.1

バージョン 8.4.3.0

バージョン 8.4.2.0

バージョン 8.4.1.0

バージョン 8.3.1.0

バージョン 8.3.0.0

バージョン 8.2.1.0

バージョン 8.2.0.1

バージョン 8.2.0.0

バージョン 8.1.0.0

バージョン 8.0.3.2

バージョン 8.0.3.1

バージョン 8.0.3.0

バージョン 8.0.2.0

バージョン 8.0.1.0

バージョン 7.5.0.1

バージョン 7.5.0.0

バージョン 7.3.1.1

バージョン 7.3.1.0

バージョン 7.3.0.0

バージョン 7.2.1.0

バージョン 7.2.0.1

バージョン 7.2.0.0

バージョン 7.1.0.0

バージョン 7.0.1.0

バージョン 7.0.0.0

バージョン 6.6.3.0

バージョン 6.6.2.0

バージョン 6.6.1.0

バージョン 6.6.0.0

バージョン 1.1.0

バージョン 1.0.0

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

ライフサイクルイベント

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