このガイドでは、Google Mobile Ads SDK を使用して、Google Mobile Ads SDK を読み込んで表示する方法を説明します。 メディエーション、 ウォーターフォール統合に対応しています広告ユニットのページに Chartboost を Chartboost SDK とアダプタを統合する方法 組み込むことが重要です。 Android
サポートされている統合と広告フォーマット
Chartboost のメディエーション アダプタの機能は次のとおりです。
統合 | |
---|---|
単価設定 | |
滝 | |
フォーマット | |
バナー | |
インタースティシャル | |
特典 | |
ネイティブ |
要件
- Android API レベル 21 以降
最新の Google Mobile Ads SDK
メディエーションを完了する スタートガイド
ステップ 1: Chartboost UI で構成を設定する
Chartboost アカウントに登録し、アカウントの確認が完了したらログインします。[アプリの管理] タブに移動します。
[Add new app] ボタンをクリックしてアプリを作成します。
フォームの残りの部分に記入し、[Add App] ボタンをクリックしてアプリを完成させます。
アプリが作成されると、そのアプリのダッシュボードが表示されます。アプリのアプリ ID とアプリ署名をメモします。
Ad Manager では、 Ad Manager 広告ユニット ID を設定するために、Chartboost のユーザー ID とユーザーの署名が必要です。これらのパラメータを確認するには、Chartboost UI で [Chartboost メディエーション] をクリックします。
[リソース] > [API Explorer] タブに移動し、[認証] セクションの下にあるユーザー ID とユーザー署名をメモします。
テストモードをオンにする
アプリでテストモードを有効にするには、Chartboost UI から [Apps management] タブに移動し、リストからアプリを選択して [Edit app settings] をクリックします。
アプリの設定から、アプリの [テストモード] を切り替えることができます。
テストモードを有効にしたら、前に作成した広告ユニット 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 とアダプタをインポートする
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.2.0")
implementation("com.google.ads.mediation:chartboost:9.7.0.0")
}
手動による統合
最新バージョンの
.aar
ファイルをダウンロードします。 Chartboost SDK(提供元: Maven Central に移動してプロジェクトに追加します。Chartboost アダプターのアーティファクトに移動します。 Google の Maven リポジトリにあります最新バージョンを選択し、Chartboost をダウンロードしてください アダプタの
.aar
ファイルを開き、プロジェクトに追加します。
ステップ 4: Chartboost SDK にプライバシー設定を実装する
EU ユーザーの同意と GDPR
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 との互換性を検証しました。
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 ファイルの依存関係タグに追加します。
compile 'com.google.ads.mediation:chartboost:6.6.0.0'
- アダプターを jar ファイルではなく AAR として配布するように移行しました (詳細な手順については、README をご覧ください)。
バージョン 1.1.0
- Chartboost 補足情報から Chartboost 広告の掲載場所を削除しました。現在の場所: メディエーション向け Chartboost 設定時に、AdMob コンソールで指定した値を指定します。
バージョン 1.0.0
- 初版リリース。報酬ベースの動画広告とインタースティシャル広告をサポートします。