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

このガイドでは、Google Mobile Ads SDK を使用して、Google Mobile Ads SDK を読み込んで表示する方法を説明します。 メディエーション、 ウォーターフォール統合に対応しています広告ユニットのページに Chartboost を Chartboost SDK とアダプタを統合する方法 組み込むことが重要です。 Android

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

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: 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. 最新バージョンの .aar ファイルをダウンロードします。 Chartboost SDK(提供元: Maven Central に移動してプロジェクトに追加します。

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

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

Google の EU ユーザーの同意 ポリシーに基づき、特定の情報開示が必ず行われるようにし、 欧州経済領域(EEA)のユーザーから、 デバイス ID と個人データの使用。このポリシーは、 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 のプライバシー メソッド をご覧ください。

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

米国プライバシー関連州法 は、ユーザーに対して適切な権限を 「セール」からオプトアウトする「個人情報」を(法律で定められているとおり、 これらの規約を参照)の「Do Not Sell My Personal」という目立つ位置で 情報」[販売]ページのリンクに表示されます。「 米国州のプライバシー 法令遵守ガイドに用意されている 制限付きデータ処理 設定されているが、この設定を各広告に適用することはできない 関連付けられますそのため各広告ネットワークを 個人の商品販売に参加するメディエーション チェーン 各ネットワークのガイダンスに従って 遵守する必要があります

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 を変更する

その他の要素

AndroidManifest.xml の各アクティビティに次の属性を追加します。 次のファイルは、Chartboost 広告を表示するもので、さまざまな向きに対応しています。

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

  • ChartboostMediationAdapter.setAppParams(String, String) メソッドを Chartboost SDK の初期化に使用するアプリ ID とアプリ署名をハードコードします。
  • 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 バージョン].[アダプタパッチバージョン]
  • 次のコードを追加することで、アダプターをコンパイルの依存関係として追加できるようになりました。 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

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