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

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

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

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

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

要件

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

  • 最新の Google Mobile Ads SDK

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

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

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

Chartboost アプリ ダッシュボード

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

アプリの管理

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

新しいアプリのフォーム

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

アプリの設定

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

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

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

Chartboost API Explorer

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

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

アプリの設定を編集する

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

Chartboost のテストモード

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

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

ステップ 2: AdMob UI で Chartboost デマンドを設定する

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

広告ユニットのメディエーション設定に Chartboost を追加する必要があります。

まず、AdMob アカウントにログインします。次に、[メディエーション] タブに移動します。既存のメディエーション グループを変更する場合は、そのメディエーション グループの名前をクリックして編集し、Chartboost を広告ソースとして追加するに進みます。

新しいメディエーション グループを作成するには、[メディエーション グループを作成] を選択します。

広告フォーマットとプラットフォームを入力し、[続行] をクリックします。

メディエーション グループに名前を付け、ターゲットとする地域を選択します。次に、メディエーション グループのステータスを [有効] に設定し、[広告ユニットを追加] をクリックします。

このメディエーション グループを、既存の AdMob 広告ユニットに関連付けます。次に [完了] をクリックします。

選択した広告ユニットが広告ユニットカードに表示されます。

Chartboost を広告ソースとして追加する


[広告ソース] セクションの [ウォーターフォール] カードで、[広告ソースを追加] を選択します。[Chartboost] を選択します。

[Chartboost] を選択し、[最適化] スイッチをオンにします。前のセクションで取得したユーザー ID とユーザー署名を入力して、Chartboost の広告ソースの最適化を設定します。次に、Chartboost の eCPM 値を入力し、[続行] をクリックします。



Chartboost のマッピングがすでにある場合は、それを選択できます。それ以外の場合は、[マッピングを追加] をクリックします。

次に、前のセクションで取得したアプリ ID、アプリ署名、広告の場所を入力します。[完了] をクリックします。

Chartboost の広告掲載地域（名前付きの広告掲載地域）は、アプリ内で広告を表示する場所を表す簡単な名前です。AdMob は、設定で指定されたロケーションにリクエストを送信します。リクエストが送信されると、Chartboost はレポート作成の目的でその場所をプラットフォームに追加します。また、ゲームで呼び出す前に、Chartboost プラットフォームで直接新しい広告枠を作成することもできます。

Chartboost UI の [基本設定] ページで [詳細設定] をクリックすると、広告の掲載場所を確認できます。詳しくは、Chartboost の [Named Locations](//docs.chartboost.com/en/monetization/publishing/ad-locations/) ガイドをご覧ください。
最後に、[完了] をクリックして Chartboost を広告ソースとして追加し、[保存] をクリックします。

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

GDPR 設定と米国の州規制の設定の手順に沿って、AdMob 管理画面の 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 AdMob 管理画面で設定された 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

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