Chartboost とメディエーションの統合

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

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

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

統合
単価設定
滝
フォーマット
バナー
インタースティシャル
特典
ネイティブ

要件

  • iOS デプロイ ターゲットが 12.0 以降

  • 最新の Google Mobile Ads SDK

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

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

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

Chartboost アプリ ダッシュボード

[新しいアプリを追加] ボタンをクリックしてアプリを作成します。

アプリの管理

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

新しいアプリのフォーム

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

アプリの設定

アド マネージャーの広告ユニット ID を設定するには、Chartboost のユーザー ID とユーザー署名が必要です。これらのパラメータは、Chartboost UI で [Chartboost メディエーション] をクリックすると確認できます。

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

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

Chartboost API Explorer

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

アプリでテストモードを有効にするには、Chartboost UI の [アプリ管理] タブに移動し、リストからアプリを選択して [アプリ設定を編集] をクリックします。

アプリの設定を編集する

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

Chartboost のテストモード

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

Chartboost のテスト広告を受け取れる状態になると、アプリは Chartboost のパブリッシャー アプリ審査に掲載されます。Chartboost で収益化を有効にするには、パブリッシャーのアプリの審査が Chartboost によって承認されている必要があります。

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

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

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

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

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

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

Chartboost の収益パートナーをすでにご利用の場合は、そのパートナーを選択できます。そうでない場合は、[新しい収益パートナーを作成] を選択します。

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

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

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

Chartboost の広告掲載場所（名前付きの場所）は、アプリ内で広告を表示する場所を表す簡単な名前です。アド マネージャーは、設定で指定されたロケーションにリクエストを送信します。リクエストが送信されると、Chartboost はレポート用に位置情報を UI に追加します。

Chartboost UI では、[基本設定] ページで [詳細設定] をクリックすると、広告の掲載場所を確認できます。詳しくは、Chartboost の名前付きロケーション ガイドをご覧ください。

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

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

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

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

  • プロジェクトの Podfile に次の行を追加します。

    pod 'GoogleMobileAdsMediationChartboost'

  • コマンドラインから次のコマンドを実行します。

    pod install --repo-update

手動による統合

  • 最新バージョンの Chartboost SDK をダウンロードし、プロジェクトで Chartboost.framework と CHAMoatMobileAppKit.framework をリンクします。

  • 変更ログのダウンロード リンクから Chartboost アダプターの最新バージョンをダウンロードし、プロジェクトに ChartboostAdapter.framework をリンクします。

  • 次のフレームワークをプロジェクトに追加します。

    • StoreKit
    • Foundation
    • CoreGraphics
    • WebKit
    • AVFoundation
    • UIKit

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

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

SDK バージョン 8.2.0 で、Chartboost に addDataUseConsent メソッドが追加されました。次のサンプルコードは、データ使用の同意を CHBGDPRConsentNonBehavioral に設定します。このメソッドを呼び出す場合は、Google Mobile Ads SDK で広告をリクエストする前に呼び出すことをおすすめします。

Swift

let dataUseConsent = CHBDataUseConsent.GDPR(CHBDataUseConsent.GDPR.Consent.nonBehavioral)
Chartboost.addDataUseConsent(dataUseConsent)

Objective-C

CHBGDPRDataUseConsent *dataUseConsent = [CHBGDPRDataUseConsent gdprConsent:CHBGDPRConsentNonBehavioral];
[Chartboost addDataUseConsent:dataUseConsent];

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

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

米国の州のプライバシー法では、ユーザーに「個人情報」の「販売」を拒否する権利を付与することが義務付けられています（用語は法律の定義に基づく）。「販売」を行う事業者はホームページに「個人情報を販売しない」リンクをわかりやすく表示することが求められます。米国の州のプライバシー関連法の遵守ガイドでは、Google 広告配信で制限付きデータ処理を有効にできますが、Google はメディエーション チェーン内の各広告ネットワークにこの設定を適用することはできません。そのため、個人情報の販売に関与する可能性があるメディエーション チェーンの各広告ネットワークを特定し、各ネットワークのガイダンスに沿ってコンプライアンスを確保する必要があります。

SDK バージョン 8.2.0 で、Chartboost に addDataUseConsent メソッドが追加されました。次のサンプルコードは、データ使用の同意を CHBCCPAConsentOptInSale に設定します。このメソッドを呼び出す場合は、Google Mobile Ads SDK で広告をリクエストする前に呼び出すことをおすすめします。

Swift

let dataUseConsent = CHBDataUseConsent.CCPA(CHBDataUseConsent.CCPA.Consent.optInSale)
Chartboost.addDataUseConsent(dataUseConsent)

Objective-C

CHBCCPADataUseConsent *dataUseConsent = [CHBCCPADataUseConsent ccpaConsent:CHBCCPAConsentOptInSale];
[Chartboost addDataUseConsent:dataUseConsent];

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

エラーコード

アダプターが Chartboost から広告を受信できない場合は、次のクラスの GADResponseInfo.adNetworkInfoArray を使用して、広告レスポンスから基盤となるエラーを確認できます。

GADMAdapterChartboost
GADMediationAdapterChartboost

広告の読み込みに失敗したときに Chartboost アダプターからスローされるコードと付随するメッセージは次のとおりです。

エラーコード 理由
101 アド マネージャーの管理画面で設定した Chartboost サーバー パラメータがないか、無効です。
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 iOS メディエーション アダプターの変更履歴

バージョン 9.8.0.0

  • Chartboost SDK バージョン 9.8.0 との互換性が確認されました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 11.11.0。
  • Chartboost SDK バージョン 9.8.0。

バージョン 9.7.0.1

  • CFBundleShortVersionString を更新し、4 つではなく 3 つのコンポーネントを使用するようにしました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 11.10.0。
  • Chartboost SDK バージョン 9.7.0。

バージョン 9.7.0.0

  • Chartboost SDK バージョン 9.7.0 との互換性が確認されました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 11.2.0。
  • Chartboost SDK バージョン 9.7.0。

バージョン 9.6.0.1

  • iOS の最小バージョンが 12.0 に引き上げられました。
  • Google Mobile Ads SDK バージョン 11.0 以降が必要になりました。
  • ChartboostAdapter.xcframework 内のフレームワークに Info.plist を含めました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 11.0.1。
  • Chartboost SDK バージョン 9.6.0。

バージョン 9.6.0.0

  • Chartboost SDK バージョン 9.6.0 との互換性が確認されました。
  • 非推奨のメソッド GADMobileAds.sharedInstance.sdkVersion を GADMobileAds.sharedInstance.versionNumber に置き換えました。
  • GADMediationInterstitialAd の実装を追加しました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 10.14.0。
  • Chartboost SDK バージョン 9.6.0。

バージョン 9.5.1.0

  • Chartboost SDK バージョン 9.5.1 との互換性が確認されました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 10.12.0。
  • Chartboost SDK バージョン 9.5.1。

バージョン 9.4.0.0

  • Chartboost SDK バージョン 9.4.0 との互換性が確認されました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 10.7.0。
  • Chartboost SDK バージョン 9.4.0。

バージョン 9.3.1.0

  • Chartboost SDK バージョン 9.3.1 との互換性が確認されました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 10.7.0。
  • Chartboost SDK バージョン 9.3.1。

バージョン 9.3.0.0

  • Chartboost SDK バージョン 9.3.0 との互換性が確認されました。
  • iOS の最小バージョンが 11.0 に引き上げられました。
  • Google Mobile Ads SDK バージョン 10.4.0 以降が必要になりました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 10.4.0。
  • Chartboost SDK バージョン 9.3.0。

バージョン 9.2.0.0

  • ChartboostAdapter ヘッダー ファイルから GADMChartboostExtras インポートを削除しました。
  • Chartboost SDK バージョン 9.2.0 との互換性が確認されました。
  • Google Mobile Ads SDK バージョン 10.0.0 以降が必要になりました。
  • armv7 アーキテクチャのサポートを削除しました。
  • iOS の最小バージョンが 11.0 に引き上げられました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 10.0.0。
  • Chartboost SDK バージョン 9.2.0。

バージョン 9.1.0.0

  • Chartboost SDK バージョン 9.1.0 との互換性が確認されました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 9.11.0。
  • Chartboost SDK バージョン 9.1.0。

バージョン 9.0.0.0

  • Chartboost SDK バージョン 9.0.0 との互換性が確認されました。
  • Google Mobile Ads SDK バージョン 9.10.0 との互換性が確認済み。
  • didRewardUser API を使用するようにアダプターを更新しました。
  • Google Mobile Ads SDK バージョン 9.8.0 以降が必要になりました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 9.10.0。
  • Chartboost SDK バージョン 9.0.0。

バージョン 8.5.0.2

  • Google Mobile Ads SDK バージョン 9.0.0 との互換性が確認済み。
  • Google Mobile Ads SDK バージョン 9.0.0 以降が必要になりました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 9.0.0。
  • Chartboost SDK バージョン 8.5.0。

バージョン 8.5.0.1.0

  • CocoaPods のバージョン 8.5.0.1 を参照する Chartboost SDK 8.5.0 との互換性を確認しました。

構築およびテストに使用したバージョン

  • Google Mobile Ads SDK バージョン 8.13.0。
  • Chartboost SDK バージョン 8.5.0。

バージョン 8.5.0.0

  • Chartboost SDK 8.5.0 との互換性が確認されました。

構築およびテストに使用したバージョン

  • Google Mobile Ads SDK バージョン 8.12.0。
  • Chartboost SDK バージョン 8.5.0。

バージョン 8.4.2.0

  • Chartboost SDK 8.4.2 との互換性が確認されました。

構築およびテストに使用したバージョン

  • Google Mobile Ads SDK バージョン 8.6.0。
  • Chartboost SDK バージョン 8.4.2。

バージョン 8.4.1.1

  • Google Mobile Ads SDK バージョン 8.0.0 以降への依存関係を緩和。

構築およびテストに使用したバージョン

  • Google Mobile Ads SDK バージョン 8.4.0。
  • Chartboost SDK バージョン 8.4.1。

バージョン 8.4.1.0

  • Chartboost SDK 8.4.1 との互換性が確認されました。
  • Google Mobile Ads SDK バージョン 8.1.0 以降が必要になりました。

構築およびテストに使用したバージョン

  • Google Mobile Ads SDK バージョン 8.1.0。
  • Chartboost SDK バージョン 8.4.1。

バージョン 8.4.0.1

  • 標準化されたアダプタのエラーコードとメッセージを追加しました。
  • .xcframework 形式を使用するようにアダプターを更新しました。
  • Google Mobile Ads SDK バージョン 8.0.0 以降が必要になりました。

構築およびテストに使用したバージョン

  • Google Mobile Ads SDK バージョン 8.0.0。
  • Chartboost SDK バージョン 8.4.0。

バージョン 8.4.0.0

  • Chartboost SDK 8.4.0 との互換性が確認されました。
  • Google Mobile Ads SDK バージョン 7.68.0 以降が必要になりました。

構築およびテストに使用したバージョン

  • Google Mobile Ads SDK バージョン 7.68.0。
  • Chartboost SDK バージョン 8.4.0。

バージョン 8.3.1.0

  • Chartboost SDK 8.3.1 との互換性が確認されました。
  • Google Mobile Ads SDK バージョン 7.66.0 以降が必要になりました。
  • iOS の最小バージョンが 10.0 に引き上げられました。
  • アダプティブ バナー リクエストをサポートするようにアダプターを更新しました。

構築およびテストに使用したバージョン

  • Google Mobile Ads SDK バージョン 7.66.0。
  • Chartboost SDK バージョン 8.3.1。

バージョン 8.2.1.0

  • Chartboost SDK 8.2.1 との互換性が確認されました。
  • Google Mobile Ads SDK バージョン 7.64.0 以降が必要になりました。
  • iOS の最小バージョンが 9.0 に引き上げられました。

構築およびテストに使用したバージョン

  • Google Mobile Ads SDK バージョン 7.64.0。
  • Chartboost SDK バージョン 8.2.1。

バージョン 8.2.0.0

  • Chartboost SDK 8.2.0 との互換性を確認しました。
  • Google Mobile Ads SDK バージョン 7.61.0 以降が必要になりました。

構築およびテストに使用したバージョン

  • Google Mobile Ads SDK バージョン 7.61.0。
  • Chartboost SDK バージョン 8.2.0。

バージョン 8.1.0.1

  • 必要最小限の Google Mobile Ads SDK バージョンを 7.60.0 に更新しました。
  • Chartboost の新しい API を使用するようにアダプターを更新し、非推奨の API を削除しました。
  • アダプタで、同じ Chartboost のロケーションを使用して同じフォーマットの広告を複数読み込むことが可能になりました。
  • AdMob またはアド マネージャーの管理画面で報酬がオーバーライドされていない場合、リワード広告の報酬値は 0 ではなく、Chartboost の管理画面で指定された値になります。

構築およびテストに使用したバージョン

  • Google Mobile Ads SDK バージョン 7.60.0。
  • Chartboost SDK バージョン 8.1.0。

バージョン 8.1.0.0

  • Chartboost SDK 8.1.0 との互換性が確認されました。
  • 必須となる Google Mobile Ads SDK のバージョンを 7.59.0 に更新しました。
  • i386 アーキテクチャのサポートを削除しました。

構築およびテストに使用したバージョン

  • Google Mobile Ads SDK バージョン 7.59.0。
  • Chartboost SDK バージョン 8.1.0。

バージョン 8.0.4.0

  • Chartboost SDK 8.0.4 との互換性が確認されました。

構築およびテストに使用したバージョン

  • Google Mobile Ads SDK バージョン 7.52.0。
  • Chartboost SDK バージョン 8.0.4。

バージョン 8.0.1.1

  • バナー広告をリクエストしてもフィドが返されない問題を修正しました。

バージョン 8.0.1.0

  • Chartboost SDK 8.0.1 との互換性が確認されました。
  • バナー広告のリクエストのサポートを追加しました。

バージョン 7.5.0.1

  • Chartboost SDK を正しく初期化するためのコードを追加しました。

バージョン 7.5.0.0

  • Chartboost SDK 7.5.0 との互換性が確認されました。
  • 新しいリワード広告用 API を使用するようにアダプタを更新しました。
  • 複数のインタースティシャル リクエストを処理するようにアダプタを更新しました。
  • Google Mobile Ads SDK バージョン 7.42.2 以降が必要になりました。

バージョン 7.3.0.0

  • Chartboost SDK 7.3.0 との互換性が確認されました。

バージョン 7.2.0.1

  • アダプターに adapterDidCompletePlayingRewardBasedVideoAd: コールバックを追加しました。

バージョン 7.2.0.0

  • Chartboost SDK 7.2.0 との互換性が確認されました。

バージョン 7.1.2.0

  • Chartboost SDK 7.1.2 との互換性を確認しました。

バージョン 7.1.1.0

  • Chartboost SDK 7.1.1 との互換性を確認しました。

バージョン 7.1.0.0

  • Chartboost SDK 7.1.0 との互換性が確認されました。

バージョン 7.0.4.0

  • Chartboost SDK 7.0.4 との互換性が確認されました。

バージョン 7.0.3.0

  • Chartboost SDK 7.0.3 との互換性が確認されました。

バージョン 7.0.2.0

  • Chartboost SDK 7.0.2 との互換性が確認されました。
  • 2 つの新しい Chartboost エラーコードのサポートを追加しました。

バージョン 7.0.1.0

  • Chartboost SDK 7.0.1 との互換性が確認されました。

バージョン 7.0.0.0

  • Chartboost SDK 7.0.0 との互換性が確認されました。

バージョン 6.6.3.0

  • Chartboost SDK 6.6.3 との互換性が確認されました。
  • 「armv7s」アーキテクチャのサポートを削除しました。
  • モジュラー以外の Chartboost SDK をインポートするモジュールとして ChartboostAdapter.framework をインポートする際に、パブリッシャーが Swift でコンパイルの問題に直面するバグを修正しました。

バージョン 6.6.2.0

  • Chartboost SDK 6.6.2 との互換性が確認されました。

バージョン 6.6.1.0

  • Chartboost SDK 6.6.1 との互換性を確認しました。

バージョン 6.6.0.0

  • Chartboost SDK 6.6.0 との互換性が確認されました。

バージョン 6.5.2.1

  • ビットコードのサポートを有効にしました。
  • Chartboost アダプターをフレームワークとして配布するようになりました。
  • プロジェクトに ChartboostAdapter.framework をインポートするには、ターゲットの [Build Settings] で Allow Non-modular Includes in Framework Modules を YES に設定します。

バージョン 6.5.2.0

  • バージョン命名システムを [Chartboost SDK バージョン].[アダプター パッチ バージョン] に変更しました。
  • 必要な最小 Chartboost SDK を v6.5.1 に更新しました。
  • 必須の Google Mobile Ads SDK の最小バージョンを v7.10.1 に更新しました。
  • 複数の Chartboost 広告プレースメントをサポートするようにバグを修正しました。
  • インタースティシャル広告が閉じようとしているときに、アプリが interstitialWillDismissScreen: コールバックを受け取るようになりました。
  • リワード ベースの動画広告が開かれたときに、アプリが rewardBasedVideoAdDidOpen: コールバックを受け取るようになりました。

バージョン 1.1.0

  • Chartboost の追加機能から Chartboost 広告の場所を削除しました。メディエーション用に Chartboost を構成する際に、AdMob コンソールで広告の場所を指定できるようになりました。

バージョン 1.0.0

  • 初版リリース。リワード ベースの動画広告とインタースティシャル広告に対応しています。