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

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

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

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

統合
入札
ウォーターフォール
形式
バナー
インタースティシャル
特典
ネイティブ

要件

  • Android API レベル 21 以降

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

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

Chartboost アプリのダッシュボード

[Add new app] ボタンをクリックしてアプリを作成します。

アプリの管理

フォームの残りの部分に記入し、[Add App] ボタンをクリックしてアプリを完成させます。

新しいアプリフォーム

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

アプリの設定

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

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

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

Chartboost API エクスプローラ

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

アプリでテストモードを有効にするには、Chartboost UI から [Apps management] タブに移動し、リストからアプリを選択して [Edit app settings] をクリックします。

アプリの設定を編集する

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

Chart Boost テストモード

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

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

ステップ 2: 管理画面で Chartboost のデマンドを Ad Manager 設定する

広告ユニットのメディエーション設定を行う

アド マネージャー アカウントにログインします。

[配信] > [収益グループ] に移動して、[新しい収益グループ] ボタンをクリックします。

収益グループの一意の名前を入力し、[ステータス] を [有効] に設定して [広告フォーマット] を選択し、[広告枠のタイプ] を [モバイルアプリ] に設定します。[ターゲティング] > [広告枠] で、[広告枠] と [モバイル アプリケーション] でメディエーションを追加する広告ユニットを選択します。

次に、[収益パートナーを追加] ボタンをクリックします。

「Chartboost」の収益パートナーがすでにある場合は、そのパートナーを選択できます。それ以外の場合は、[新しい収益パートナーを作成] を選択します。

[広告ネットワーク] として Chartboost を選択し、固有の名前を入力して [メディエーション] を有効にします。

[自動データ収集] をオンにして、前のセクションで取得したUser ID and User Signature を入力します。

[収益パートナー] を選択したら、[統合タイプ] として [モバイル SDK メディエーション]、[プラットフォーム] として [Android]、[ステータス] として [有効] を選択します。前のセクションで取得したApp ID, App Signature and Ad Location を入力します。[デフォルト CPM] の値を入力します。

Chartboost Ad Locations(Named Locations)は、広告を表示するアプリ内の場所を表すシンプルな名前です。Ad Manager は、設定で指定された場所にリクエストを送信します。リクエストが送信されると、レポート用にビジネス情報が UI に追加されます。

Chartboost UI で [Basic Settings] ページの [Advanced Settings] をクリックすると、広告掲載位置が表示されます。詳しくは、Chartboost の名前付きロケーションのガイドをご覧ください。

完了したら、ページの下部にある [保存] をクリックします。

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

GDPR 設定 米国の州規制の設定 の手順に沿って、 Ad Manager UI の GDPR および米国の州規制の広告パートナーのリストに Chartboost を追加します。

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

プロジェクト レベルの 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.0.0")
    implementation("com.google.ads.mediation:chartboost:9.6.1.0")
}

手動による統合

  1. Maven Central から Chartboost SDK の最新バージョンの .aar ファイルをダウンロードして、プロジェクトに追加します。

  2. Google の Maven リポジトリの Chartboost アダプタ アーティファクトに移動します。最新バージョンを選択し、Chartboost アダプターの .aar ファイルをダウンロードしてプロジェクトに追加します。

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

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

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: 実装をテストする

テスト広告を有効にする

Ad Manager にテストデバイスを登録し、 Chartboost UI でテストモードを有効にします。

テスト広告を確認する

Chartboostからテスト広告を受信していることを確認するには、広告インスペクタで Chartboost (Waterfall) 広告ソースを使用して単独の広告ソースのテストを有効にします。

省略可能なステップ

権限

最適なパフォーマンスを実現するために、アプリの AndroidManifest.xml ファイルに次のオプションの権限を追加することをおすすめします。

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

エラーコード

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

次のクラスの
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 UI で設定されている Chartboost サーバー パラメータが見つからないか、無効です。 Ad Manager
104 Chartboost のインタースティシャル広告またはリワード広告を表示する準備ができていません。
101 UI で設定されている Chartboost サーバー パラメータが見つからないか、無効です。 Ad Manager
102 Chartboost SDK から初期化エラーが返されました。
103 Chartboost 広告は表示時にキャッシュされません。
104 リクエストされた広告サイズが、Chartboost でサポートされているバナーサイズと一致しません。
105 デバイスの OS バージョンが、Chartboost SDK でサポートされている最小 OS バージョンよりも低くなっています。
200-299 Chartboost SDK のキャッシュ エラーです。詳しくは、コードをご覧ください。
300-399 Chartboost SDK にエラーが表示されます。詳しくは、コードをご覧ください。
400-499 Chartboost SDK のクリックエラー。詳しくは、コードをご覧ください。

Chartboost Android メディエーション アダプタに関する変更履歴

バージョン 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 との互換性が確認されました。
  • compileSdkVersiontargetSdkVersion を 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 version].[アダプタ パッチ バージョン] に変更しました。
  • これで、build.gradle ファイルの依存関係タグに compile 'com.google.ads.mediation:chartboost:6.6.0.0' を追加することで、アダプタをコンパイル依存関係として追加できるようになりました。
  • アダプターを jar ファイルではなく AAR として配布するよう移行しました(詳細については README をご覧ください)。

バージョン 1.1.0

  • Chartboost のエクストラから Chartboost 広告の場所を削除しました。メディエーション用に Chartboost を設定する際に、AdMob コンソールで広告の位置を指定できるようになりました。

バージョン 1.0.0

  • 初版リリース。リワードベースの動画広告とインタースティシャル広告をサポートします。