このガイドでは、Google Mobile Ads SDK でメディエーションを使用して Verve HyBid SDK の広告を読み込んで表示する方法を説明します。入札 の統合についても説明します。さらに、広告ユニットのメディエーション設定に Verve HyBid SDK を追加する方法と、Verve HyBid SDK とアダプタを iOS アプリに統合する方法についても説明します。
サポートされている統合と広告フォーマット
Verve HyBid SDK 用のメディエーション アダプタには、次の機能があります。
| 統合 | |
|---|---|
| 入札 | 1 |
| ウォーターフォール | |
| フォーマット | |
| バナー | |
| インタースティシャル | |
| リワード インタースティシャル | |
| 特典 | |
| ネイティブ | |
1 入札の統合はアルファ版です。アクセス権をリクエストするには、アカウント マネージャーにご連絡ください。
前提条件
続行する前に、次のことを確認してください。
- iOS のデプロイ対象のバージョンが 13.0 以降であること。
最新バージョンの Google Mobile Ads SDK。
ステップ 1: Verve HyBid SDK の管理画面で構成を設定する
構成の設定については、Verve にお問い合わせください。
ステップ 2: アド マネージャーの管理画面で Verve HyBid SDK のデマンドを設定する
アド マネージャー アカウントにログインします。
セキュア シグナルの共有を有効にする
[管理者] > [全般設定] に移動します。[Ad Exchange アカウントの設定] タブに移動し、[セキュア シグナルの共有] を確認してオンに切り替えます。[保存] をクリックします。
入札リクエストでセキュア シグナルを共有する
[広告枠] > [セキュア シグナル] に移動します。[セキュア シグナル] で、 [Verve HyBid SDK] を検索し、[アプリ統合を有効にする] をオンにします。
[保存] をクリックします。
SDK 入札のセキュア シグナルの共有を許可する
[配信] > [デマンド チャネルの設定] に移動します。[デフォルト設定] タブで、[SDK 入札] の [セキュア シグナルの共有を許可する] をオンにします。
[保存] をクリックします。
Verve HyBid SDK の入札を設定する
[配信] > [入札者（ビッダー）] に移動し、[SDK 入札に移動] をクリックします。
[新しいビッダー] をクリックします。
ビッダーとして [Verve Group] を選択します。
[続行] をクリックして、このビッダーの SDK 入札を有効にします。
[完了] をクリックします。
広告ユニットのマッピングを設定する
[配信] > [入札者（ビッダー）] に移動し、[SDK 入札に移動] をクリックします。
Verve HyBid SDK で使用する会社を選択します。
[広告ユニットのマッピング] タブに移動し、[新しい広告ユニットのマッピング] をクリックします。
[特定の広告ユニット] を選択します。広告ユニットと広告フォーマットを選択します。[モバイルアプリ] を [広告枠のタイプ] として選択し、対象の [モバイルアプリ] を選択します。次に、前のセクションで取得したゾーン ID と AppToken を入力します。
アド マネージャーの管理画面で リワード インタースティシャル広告の広告ユニットのマッピングを設定する場合は、[リワード] フォーマットを選択し、リワード インタースティシャル プレースメント ID を使用します。
最後に、[保存] をクリックします。
GDPR と米国の州規制の広告パートナー リストに Verve Group を追加する
欧州の規制に関する設定 と 米国の州の規制に関する設定 の手順に沿って、アド マネージャーの管理画面で欧州および米国の州の規制に関する広告パートナーのリストに [Verve Group] を追加します。
ステップ 3: Verve HyBid SDK とアダプタをインポートする
Swift Package Manager を使用する
続行する前に、サポートされている最小アダプタ バージョン 3.8.0.0 が必要です。
プロジェクトにパッケージの依存関係 を追加するには、次の手順を行います。
Xcode で、[File] > [Add Package Dependencies...] の順に移動します。
表示されたプロンプトで、次のパッケージ URL を検索します。
https://github.com/googleads/googleads-mobile-ios-mediation-verve.git[Dependency Rule] で [Branch] を選択します。
テキスト フィールドに「
main」と入力します。
CocoaPods を使用する
プロジェクトの Podfile に次の行を追加します。
pod 'GoogleMobileAdsMediationVerve'コマンドラインで次のコマンドを実行します。
pod install --repo-update
手動による統合
Verve iOS SDK の最新バージョンをダウンロードし、プロジェクトに
VerveSDK.frameworkをリンクします。変更履歴のダウンロード リンク から Verve アダプタの最新バージョンをダウンロードし、プロジェクトに 変更履歴をリンクします。
VerveAdapter.framework次のフレームワークをプロジェクトに追加します。
AdSupportAVFoundationCoreGraphicsCoreMediaCoreTelephonyStoreKitSystemConfigurationUIKitWebKitlibz.tbd
ステップ 4: Verve SDK にプライバシー設定を実装する
EU の同意に関する規制と GDPR
Google の EU ユーザーの同意ポリシーに準拠するには、欧州経済領域（EEA）、英国、スイスのユーザーに対して特定の情報を開示し、法律で義務付けられている場合は、Cookie やその他のローカル ストレージの使用、広告のパーソナライズを目的とした個人データの収集、共有、使用についてユーザーの同意を得る必要があります。このポリシーには、EU の e プライバシー指令と一般データ保護規則（GDPR）の要件が反映されています。パブリッシャー様には、同意がメディエーション チェーン内の各広告ソースに反映されていることを確認する責任があります。 Google は、同意に関するユーザーの選択をそのようなネットワークに自動的に渡すことはできません。
Verve HyBid SDK は、UMP SDK などの同意管理プラットフォームによって設定された GDPR 同意を自動的に読み取ります。詳しくは、 GDPR TCF コンプライアンスをご覧ください。
米国のプライバシー関連州法
米国のプライバシー関連州法では、ユーザーが「個人情報」の「販売」をオプトアウトする権利を付与することが義務付けられています（用語は法律の定義に基づく）。「販売者」のホームページには、「個人情報を第三者に売却しない」ことを明記したリンクを目立つように表示することによってオプトアウトの手段を提供する必要があります。米国のプライバシー関連州法遵守ガイドでは、Google 広告の配信で制限付きデータ処理を有効にできますが、Google がこの設定をメディエーション チェーン内の各広告ネットワークに適用することはできません。そのため、メディエーション チェーン内で個人情報の販売に関与する可能性のある広告ネットワークを特定し、各ネットワークのガイダンスに沿って州法を遵守する必要があります。
Verve HyBid SDK は、 メソッドを使用してプライバシー設定をサポートしています。次のサンプルコードは、この同意情報を Verve HyBid SDK に渡します。同意情報 を Verve HyBid SDK に手動で渡す場合は、この例 を呼び出す前に、Google Mobile Ads SDKを介して広告をリクエストすることをおすすめします。
Swift
usPrivacyString を米国のプライバシー文字列に置き換えます。
Objective-C
kUSPrivacyString を米国のプライバシー文字列に置き換えます。
詳しくは、 CCPA コンプライアンスに関する Verve HyBid SDK のプライバシー ドキュメントをご覧ください。
ステップ 5: 必要なコードを追加する
SKAdNetwork を実装する
Verve HyBid SDK のドキュメント
に沿って、SKAdNetwork 識別子をプロジェクトの Info.plist ファイルに追加します。
ステップ 6: 実装をテストする
テスト広告を有効にする
テストデバイスを アド マネージャーに登録していることを確認します。
テスト広告を確認する
Verve HyBid SDK からテスト広告を受信していることを確認するには、 広告インスペクタで 単一の広告ソースのテスト を Verve（入札）の広告ソースを使用して有効にします。
追加の設定については、 Verve HyBid SDK のドキュメントをご覧ください。
エラーコード
アダプタが Verve HyBid SDK から広告を受け取れない場合は、パブリッシャーは
次のクラスの
GADResponseInfo.adNetworkInfoArray
を使用して、広告レスポンスからエラーの詳細を確認できます。
GADMAdapterVerve
GADMAdapterVerveRewardBasedVideoAd
GADMediationAdapterVerve
広告の読み込みに失敗した場合に Verve HyBid SDK アダプタがスローするコードとメッセージは次のとおりです。
| エラーコード | 理由 |
|---|---|
| 100 ～ 106 | Verve HyBid SDK がエラーを返しました。 |
| 101 | アプリトークンがありません。 |
| 102 | ユーザーは子供です。 |
| 103 | Verve HyBid SDK の初期化に失敗しました。 |
| 104 | 広告の設定が無効です。 |
| 105 | サポートされていないバナーサイズです。 |
| 106 | 全画面広告を表示する準備ができていません。 |
| 115 | 広告ユニット ID がありません。広告を読み込めません。 |
| 116 | 広告の準備ができていません。広告を表示できません。 |
Verve iOS メディエーション アダプタの変更履歴
バージョン 3.9.0.0
- マイナー バージョンを緩和して許可するため、Google Mobile Ads iOS SDK の最小バージョンを
13.3に更新しました。 - HyBid SDK バージョン 3.9.0 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 13.6.0。
- HyBid SDK バージョン 3.9.0。
バージョン 3.8.1.1
- 新しい
ageRestrictedTreatmentがGADAgeRestrictedTreatmentChildに設定されている場合、Verve SDK の年齢制限付きリクエストをフィルタします。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 13.4.0。
- HyBid SDK バージョン 3.8.1。
バージョン 3.8.1.0
- HyBid SDK バージョン 3.8.1 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 13.4.0。
- HyBid SDK バージョン 3.8.1。
バージョン 3.8.0.0
- シグナルの収集の失敗と広告の読み込みの失敗を解決するため、アダプタからバナーサイズのチェックを削除しました。
- HyBid SDK バージョン 3.8.0 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 13.2.0。
- HyBid SDK バージョン 3.8.0。
バージョン 3.7.1.3
- Google Mobile Ads SDK の依存関係をバージョン 13.0.0 に更新しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 13.0.0。
- HyBid SDK バージョン 3.7.1。
バージョン 3.7.1.2
- CocoaPods の最小 iOS バージョンを
13.0に更新しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 13.0.0。
- HyBid SDK バージョン 3.7.1。
バージョン 3.7.1.1
- 初版リリース。
- バナー、インタースティシャル、リワード、リワード インタースティシャル、ネイティブの広告フォーマットの入札をサポートしています。
- HyBid SDK バージョン 3.7.1 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 12.13.0。
- HyBid SDK バージョン 3.7.1。