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

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

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

Chartboost のメディエーション アダプタの機能は次のとおりです。

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

要件

  • Android API レベル 21 以降
  • 最新の Google Mobile Ads SDK

  • メディエーションのスタートガイドを完了している。

ステップ 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: UI で 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.2.0")
    implementation("com.google.ads.mediation:chartboost:9.7.0.0")
}

手動による統合

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

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

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

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 広告配信で制限付きデータ処理を有効にすることができますが、メディエーション チェーン内の各広告ネットワークにこの設定を適用することはできません。そのため、個人情報の販売に参加する可能性があるメディエーション チェーンの各広告ネットワークを特定し、各ネットワークのガイダンスに従ってコンプライアンスを確保する必要があります。

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) 広告ソースを使用して単独の広告ソースのテストを有効にします。

省略可能なステップ

権限

最適なパフォーマンスを得るため、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 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.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 との互換性を検証しました。
  • 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

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