このガイドでは、Google Mobile Ads SDK でメディエーションを使用して Chartboost の広告を読み込んで表示する方法を説明します。ウォーターフォールの統合についても説明します。また、広告ユニットのメディエーション設定に Chartboost を追加する方法と、Chartboost SDK とアダプタを iOS アプリに統合する方法についても取り上げます。
サポートされている統合と広告フォーマット
Chartboost 用のメディエーション アダプタには、次の機能があります。
統合 | |
---|---|
入札単価 | |
ウォーターフォール | |
フォーマット | |
バナー | |
インタースティシャル | |
特典 | |
ネイティブ |
要件
- iOS のデプロイ対象のバージョンが 12.0 以降であること
Google Mobile Ads SDK のバージョンが最新であること
メディエーションのスタートガイドの手順を完了していること
ステップ 1: Chartboost UI で構成を設定する
Chartboost アカウントに登録し、アカウントが確認されたらログインします。[アプリの管理] タブに移動します。
[新しいアプリを追加] ボタンをクリックしてアプリを作成します。
フォームの残りの部分を入力し、[アプリを追加] ボタンをクリックしてアプリを確定します。
アプリが作成されると、アプリのダッシュボードに移動します。アプリのアプリ ID とアプリ署名をメモします。
アド マネージャーの広告ユニット ID を設定するには、Chartboost のユーザー ID とユーザー署名が必要です。これらのパラメータは、Chartboost UI で [Chartboost mediation] をクリックすると確認できます。
[リソース] > [API Explorer] タブに移動し、[認証] セクションにある [ユーザー ID] と [ユーザー署名] をメモします。
app-ads.txt を更新する
Authorized Sellers for Apps app-ads.txt は、承認されたチャネルでのみアプリ広告枠を販売できるようにする IAB Tech Lab が推進しているイニシアチブです。広告収益の大幅な減少を防ぐためには、app-ads.txt
ファイルを実装する必要があります。まだ作成していない場合は、アド マネージャー用の app-ads.txt ファイルを作成します。
Chartboost に app-ads.txt
を実装するには、app-ads.txt をご覧ください。
テストモードをオンにする
アプリでテストモードを有効にするには、Chartboost UI の [Apps management] タブに移動し、リストからアプリを選択して [Edit app settings] をクリックします。
アプリの設定で、アプリのテストモードを切り替えることができます。
テストモードを有効にすると、先ほど作成した広告ユニット ID を使用して広告をリクエストし、Chartboost のテスト広告を受け取ることができます。
Chartboost のテスト広告を受信できるようになったら、アプリは Chartboost のパブリッシャー アプリ審査に登録されます。Chartboost で収益化を行うには、パブリッシャー アプリの審査が Chartboost によって承認される必要があります。
ステップ 2: アド マネージャーの管理画面で Chartboost のデマンドを設定する
広告ユニットのメディエーション設定を構成する
アド マネージャー アカウントにログインします。
[配信] > [収益グループ] に移動し、[新しい収益グループ] ボタンをクリックします。
収益グループの固有の名前を入力し、[ステータス] を [有効] に設定します。広告フォーマットを選択し、[広告枠タイプ] を [モバイルアプリ] に設定します。 [ターゲティング > 広告枠] セクションで、メディエーションを追加する [広告枠] と [モバイルアプリ] の広告ユニットを選択します。
次に、[収益パートナーを追加] ボタンをクリックします。
Chartboost の収益パートナーがすでにある場合は、それを選択できます。そうでない場合は、[新しい収益パートナーを作成] を選択します。
[広告ネットワーク] で [Chartboost] を選択し、一意の名前を入力して、[メディエーション] を有効にします。
[自動データ収集] をオンにして、前のセクションで取得したユーザー ID とユーザー署名を入力します。
[収益パートナー] を選択したら、[統合タイプ] で [モバイル SDK メディエーション]、[プラットフォーム] で [iOS]、[ステータス] で [有効] を選択します。前のセクションで取得したアプリ ID、アプリ署名、広告の場所を入力します。次に、[デフォルト CPM] の値を入力します。
Chartboost の広告の場所(名前付きの場所)は、アプリ内で広告を表示する場所を表すシンプルな名前です。アド マネージャーは、設定で指定された場所にリクエストを送信します。リクエストが送信されると、Chartboost はレポート作成のためにその場所を UI に追加します。
Chartboost UI で広告の掲載場所を確認するには、[詳細設定] をクリックして [基本設定] ページを開きます。詳しくは、Chartboost の名前付きロケーションのガイドをご覧ください。
完了したら、ページの下部にある [保存] をクリックします。
GDPR と米国の州規制の広告パートナー リストに Chartboost を追加する
欧州の規制に関する設定と米国の州の規制に関する設定の手順に沿って、アド マネージャーの管理画面で欧州および米国の州の規制に関する広告パートナーのリストに 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 ユーザーの同意ポリシーに準拠するには、欧州経済領域(EEA)、英国、スイスのユーザーに対して特定の情報を開示し、法律で義務付けられている場合は、Cookie やその他のローカル ストレージの使用、広告のパーソナライズを目的とした個人データの収集、共有、使用についてユーザーの同意を得る必要があります。このポリシーには、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 のプライバシー メソッドをご覧ください。
ステップ 5: 必要なコードを追加する
SKAdNetwork の統合
Chartboost のドキュメントに沿って、プロジェクトの Info.plist
ファイルに SKAdNetwork 識別子を追加します。
プロジェクトの設定
ターゲットの [Build Settings] で [Allow Non-modular Includes in Framework Modules] を YES
に設定します。
デバッグとリリース両方のプロジェクトのビルド設定の [Other Linker Flags] に値 -ObjC
を追加します。
ステップ 6: 実装をテストする
テスト広告を有効にする
アド マネージャー用のテストデバイスを登録し、Chartboost の UI でテストモードを有効にしてください。
テスト広告を確認する
Chartboost からテスト広告を受信していることを確認するには、Chartboost(ウォーターフォール)の広告ソースを使用して、広告インスペクタで単一の広告ソースのテストを有効にします。
エラーコード
アダプタが Chartboost から広告を受信できなかった場合は、次のクラスの GADResponseInfo.adNetworkInfoArray
を使用して、広告レスポンスから根本原因のエラーを確認できます。
GADMAdapterChartboost
GADMediationAdapterChartboost
広告の読み込みに失敗した場合に Chartboost アダプタがスローするコードとメッセージは次のとおりです。
エラーコード | 理由 |
---|---|
101 | アド マネージャー UI で設定された 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.9.2.0
- Chartboost SDK バージョン 9.9.2 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 12.8.0。
- Chartboost SDK バージョン 9.9.2。
バージョン 9.9.1.0
- Chartboost SDK バージョン 9.9.1 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 12.7.0。
- Chartboost SDK バージョン 9.9.1。
バージョン 9.9.0.0
- Chartboost SDK バージョン 9.9.0 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 12.5.0。
- Chartboost SDK バージョン 9.9.0。
バージョン 9.8.1.0
- Chartboost SDK バージョン 9.8.1 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 12.0.0。
- Chartboost SDK バージョン 9.8.1。
バージョン 9.8.0.1
- Google Mobile Ads SDK バージョン 12.0.0 以降が必要になりました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 12.0.0。
- Chartboost SDK バージョン 9.8.0。
バージョン 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 またはアド マネージャーの UI で報酬がオーバーライドされていない場合、リワード広告の報酬値は
0
ではなく、Chartboost UI で指定された値になります。
構築およびテストに使用したバージョン
- 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」アーキテクチャのサポートを削除しました。
- モジュールとして
ChartboostAdapter.framework
をインポートする際に、非モジュラーの Chartboost SDK をインポートしていると、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
- 初版リリース。リワード ベースの動画広告とインタースティシャル広告に対応しています。