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

[プラットフォームを選択]: Android（ベータ版） Android iOS Unity Flutter

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

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

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

要件

• Android API レベル 24 以降

• 最新の GMA Next-Gen SDK

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

ステップ 1: Chartboost の管理画面で構成を設定する

登録して Chartboost アカウントを作成し、アカウントが確認されたらログインします。[Apps management] タブに移動します。

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

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

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

アド マネージャーの広告ユニット ID を設定するには、Chartboost の [User ID] と [User Signature] が必要です。これらのパラメータは、Chartboost の管理画面で [Chartboost mediation] をクリックすると確認できます。

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

app-ads.txt を更新する

アプリの認定販売者 app-ads.txt は、IAB Tech Lab が推進するイニシアチブで、承認されたチャネルでのみアプリ広告枠を販売できるようにするものです。広告収入の大幅な減少を防ぐためには、app-ads.txt ファイルを実装する必要があります。まだ設定していない場合は、 アド マネージャーの app-ads.txt ファイルを作成します。

Chartboost に app-ads.txt を実装するには、 app-ads.txt をご覧ください。

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

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

アプリの設定で、アプリの [Test mode] を切り替えることができます。

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

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

ステップ 2: アド マネージャーの管理画面で Chartboost のデマンドを設定する

広告ユニットのメディエーション設定を構成する

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

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

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

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

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

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

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

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

Chartboost の広告の場所 （名前付きの場所） は、広告を表示するアプリ内の場所を表すシンプルな名前です。アド マネージャーは、設定で指定された場所にリクエストを送信します。リクエストが送信されると、Chartboost はレポート作成のためにその場所を管理画面に追加します。

Chartboost の管理画面で、[Advanced Settings] をクリックすると、[Basic Settings] ページに広告の場所が表示されます。詳しくは、 Chartboost 名前付きの場所 ガイドをご覧ください。

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

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

欧州の規制に関する設定と米国の州の規制に関する設定の手順に沿って、アド マネージャーの管理画面で欧州および米国の州の規制に関する広告パートナーのリストにChartboostを追加します。

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

Android Studio の統合（推奨）

プロジェクト レベルの settings.gradle.kts ファイルに、次のリポジトリを追加します。

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://cboost.jfrog.io/artifactory/chartboost-ads/")
    }
  }
}

アプリレベルの gradle ファイルに、次の実装依存関係と構成を追加します。

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.google.ads.mediation:chartboost:9.11.1.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01'
    implementation 'com.google.ads.mediation:chartboost:9.11.1.1'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

手動による統合

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

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

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

EU ユーザーからの同意と GDPR

Google の EU ユーザーの同意ポリシーに準拠する には、欧州経済領域（EEA）、英国、スイスの ユーザーに対して特定の情報を開示し、法律で 義務付けられている場合は、Cookie やその他のローカル ストレージの使用、広告の パーソナライズを目的とした個人データの収集、共有、使用について ユーザーの同意を得る必要があります。このポリシーには、EU の e プライバシー指令と一般データ保護規則（GDPR）の要件が反映されています。パブリッシャー様には、同意がメディエーション チェーン内の各広告ソースに反映されていることを確認する責任があります。 Google は、同意に関するユーザーの選択をそのようなネットワークに自動的に渡すことはできません。

SDK バージョン 8.1.0 で、Chartboost は addDataUseConsent() メソッドを追加しました。次のサンプルコードでは、データ使用の同意を NON_BEHAVIORAL に設定しています。このメソッドを呼び出す場合は、GMA Next-Gen SDK を通じて広告をリクエストする前に呼び出すことをおすすめします。GMA Next-Gen SDK

DataUseConsent dataUseConsent = new GDPR(GDPR.GDPR_CONSENT.NON_BEHAVIORAL);
Chartboost.addDataUseConsent(context, dataUseConsent);

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 に設定しています。このメソッドを呼び出す場合は、 を通じて広告をリクエストする前に呼び出すことをおすすめします。 GMA Next-Gen SDK

DataUseConsent dataUseConsent = new CCPA(CCPA.CCPA_CONSENT.OPT_IN_SALE);
Chartboost.addDataUseConsent(context, dataUseConsent);

val dataUseConsent = CCPA(CCPA.CCPA_CONSENT.OPT_IN_SALE)
Chartboost.addDataUseConsent(context, dataUseConsent)

詳細と各メソッドで指定できる値については、Chartboost の CCPA に関する記事と Android プライバシー メソッド をご覧ください。

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

更新アクティビティの構成変更

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

android:configChanges="keyboardHidden|orientation|screenSize"

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

テスト広告を有効にする

アド マネージャー用のテストデバイスを 登録し 、Chartboost の管理画面でテストモードを有効にしてください。

テスト広告を確認する

Chartboost からテスト広告を受信していることを確認するには、 Chartboost（ウォーターフォール） の広告のソースを使用して、広告インスペクタで 単一の広告ソースのテスト を有効にします。

省略可能なステップ

権限

最適なパフォーマンスを得るため、Chartboost は、アプリの AndroidManifest.xml ファイルに次の省略可能な権限を追加することをおすすめします。

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

エラーコード

アダプタが Chartboost から広告を受信できなかった場合は、 広告レスポンスから ResponseInfo.getAdSourceResponses() 根本原因のエラーを確認できます。

com.google.ads.mediation.chartboost.ChartboostAdapter
com.google.ads.mediation.chartboost.ChartboostMediationAdapter

広告の読み込みに失敗した場合に Chartboost アダプタがスローするコードとメッセージは次のとおりです。