このガイドでは、Google Mobile Ads SDK を使用して、Google Mobile Ads SDK を読み込んで表示する方法を説明します。 を使用した Chartboost の広告 AdMob メディエーション ウォーターフォール統合に対応しています広告ユニットのページに Chartboost を Chartboost SDK とアダプタを統合する方法 組み込むことが重要です。 iOS
サポートされている統合と広告フォーマット
Chartboost のメディエーション アダプタの機能は次のとおりです。
統合 | |
---|---|
単価設定 | |
滝 | |
フォーマット | |
バナー | |
インタースティシャル | |
特典 | |
ネイティブ |
要件
- iOS デプロイ ターゲットが 12.0 以降であること
最新の Google Mobile Ads SDK
メディエーションを完了する スタートガイド
ステップ 1: Chartboost UI で構成を設定する
Chartboost アカウントに登録する アカウントの確認が完了したらログインしてください。 次に、[アプリの管理] タブに移動します。
[Add new app] ボタンをクリックしてアプリを作成します。
フォームの残りの部分に記入し、[Add App] ボタンをクリックして 。
アプリが作成されると、アプリのダッシュボードが表示されます。メモ アプリのアプリ ID とアプリ署名。
Android
iOS
AdMob では、Chartboost のユーザー ID が必要です。 ユーザーの署名: AdMob 広告を設定できます あります。これらのパラメータを確認するには、[Chartboost メディエーション] Chartboost UI です
[リソース >API Explorer] タブを開き、 [Authentication] セクションにある [User ID] と [User Signature]。
テストモードをオンにする
アプリでテストモードを有効にするには、[アプリの管理] に移動します。 Chartboost UI でタブを開き、リストからアプリを選択して アプリの設定を編集します。
Android
iOS
アプリの設定から、アプリのテストモードを切り替えることができます。
テストモードを有効にすると、作成した広告ユニット ID を使用して広告をリクエストできます。 Chartboost テスト広告を受信できます
Chartboost テスト広告を表示できるようになると、お客様のアプリは Chartboost の Publisher App Review に掲載されています。 Chartboost で収益化が機能するためには、パブリッシャーのアプリ審査により、 Chartboost の承認が必要です。
ステップ 2: UI で Chartboost デマンドを設定する AdMob
広告ユニットのメディエーション設定を行う
広告ユニットのメディエーション設定に Chartboost を追加する必要があります。
AdMob アカウントにログインします。次に、[メディエーション] タブに移動します。既存のメディエーション グループを編集する場合は、そのメディエーション グループの名前をクリックして編集し、広告ソースとして Chartboost を追加するに進んでください。
新しいメディエーション グループを作成するには、[メディエーション グループを作成] を選択します。
広告フォーマットとプラットフォームを入力して、[続行] をクリックします。
メディエーション グループに名前を付けて、ターゲットとする地域を選択します。次に、メディエーション グループのステータスを [有効] に設定し、[広告ユニットを追加] をクリックします。
このメディエーション グループを、既存の 1 つ以上の広告ユニット(AdMob )に関連付けます。[完了] をクリックします。
選択した広告ユニットが入力された広告ユニットカードが表示されます。
広告ソースとして Chartboost を追加
[広告ソース] セクションの [ウォーターフォール] カードで、[広告のソースを追加] を選択します。Chartboost を選択します。
[Chartboost] を選択して、[最適化] スイッチを有効にします。前のセクションで取得した User ID and User Signatureを入力して、Chartboostの広告ソースの最適化を設定します。 次に、Chartboost の eCPM の値を入力し、[続行] をクリックします。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 追加
ステップ 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)のユーザーから、 デバイス ID や個人データの使用。このポリシーは、 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 のプライバシー メソッド をご覧ください。
米国のプライバシー関連州法
米国プライバシー関連州法 は、ユーザーに対して適切な権限を 「セール」からオプトアウトする「個人情報」を(法律で定められているとおり、 これらの規約を参照)の「Do Not Sell My Personal」という目立つ位置で 情報」[販売]ページのリンクに表示されます。「 米国州のプライバシー 法令遵守ガイドに用意されている 制限付きデータ処理 設定されているが、この設定を各広告に適用することはできない 関連付けられますそのため各広告ネットワークを 個人の商品販売に参加するメディエーション チェーン 各ネットワークのガイダンスに従って 遵守する必要があります
SDK バージョン 8.2.0 で Chartboost に addDataUseConsent
メソッドが追加されました。「
次のサンプルコードでは、データ使用の同意を CHBCCPAConsentOptInSale
に設定しています。もし
このメソッドを呼び出す場合は、API をリクエストする前に
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 | UI で設定されている Chartboost サーバー パラメータが見つからないか、無効です。 AdMob |
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.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 Kubernetes Engine
- Google Mobile Ads SDK バージョン 8.13.0.
- Chartboost SDK バージョン 8.5.0
バージョン 8.5.0.0
- Chartboost SDK 8.5.0 との互換性を検証しました。
Google Kubernetes Engine
- 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 Kubernetes Engine
- 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 Kubernetes Engine
- 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 Kubernetes Engine
- 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 Kubernetes Engine
- Google Mobile Ads SDK バージョン 7.59.0.
- Chartboost SDK バージョン 8.1.0
バージョン 8.0.4.0
- Chartboost SDK 8.0.4 との互換性を検証しました。
Google Kubernetes Engine
- 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」のサポートを削除説明します。
- パブリッシャーがインポート時に Swift でコンパイルの問題が発生するバグを修正しました
非モジュール形式をインポートしていたモジュールとしての
ChartboostAdapter.framework
Chartboost SDK
バージョン 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
をインポートするには、 ビルドの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
- 初版リリース。報酬ベースの動画広告とインタースティシャル広告をサポートします。