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

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

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

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

要件

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

• 最新の Google Mobile Ads SDK

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

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

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

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

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

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

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

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

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

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

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

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

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

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

広告ユニットのメディエーション設定を行う

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

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

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

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

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

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

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

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

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

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

次に、前のセクションで取得した App ID, App Signature and Ad Locationを入力します。[完了] をクリックします。

Chartboost Ad Locations（Named Locations）は、広告を表示するアプリ内の場所を表すシンプルな名前です。AdMob は、設定で指定された場所にリクエストを送信します。リクエストが送信されると、Chartboost はレポート用にビジネス情報をプラットフォームに追加します。ユーザーは、新しい広告場所をゲーム内で呼び出す前に、Chartboost プラットフォームで直接作成することもできます。

Chartboost UI で [Basic Settings] ページの [Advanced Settings] をクリックすると、広告の位置を確認できます。詳しくは、Chartboost の名前付きロケーションのガイドをご覧ください。

最後に、[完了] をクリックして Chartboost を広告ソースとして追加し、[保存] をクリックします。

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

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

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

CocoaPods を使用する（推奨）

• プロジェクトの 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 にプライバシー設定を実装する

EU ユーザーの同意と GDPR

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

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

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

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

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

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

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

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

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

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

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

エラーコード

アダプターが Chartboost から広告を受信できない場合は、 GADResponseInfo.adNetworkInfoArray 次のクラスに追加します。

GADMAdapterChartboost
GADMediationAdapterChartboost

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

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 Kubernetes Engine

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

バージョン 8.4.1.1

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

Google Kubernetes Engine

• 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 Kubernetes Engine

• 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 Kubernetes Engine

• 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 Kubernetes Engine

• 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 Kubernetes Engine

• 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

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