Verve HyBid SDK を入札と統合する

このガイドでは、Google Mobile Ads SDK でメディエーションを使用して Verve HyBid SDK の広告を読み込んで表示する方法を説明します。入札 の統合についても説明します。さらに、広告ユニットのメディエーション設定に Verve HyBid SDK を追加する方法と、Verve HyBid SDK とアダプタを iOS アプリに統合する方法についても説明します。

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

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

¹ 入札の統合はアルファ版です。アクセス権をリクエストするには、アカウント マネージャーにご連絡ください。

前提条件

続行する前に、次のことを確認してください。

• 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 が必要です。

プロジェクトにパッケージの依存関係 を追加する手順は次のとおりです。

1. Xcode で、[ファイル] > [Add Package Dependencies...] に移動します。

2. 表示されるプロンプトで、次のパッケージ URL を検索します。

   https://github.com/googleads/googleads-mobile-ios-mediation-verve.git
   

3. [Dependency Rule] で [Branch] を選択します。

4. テキスト フィールドに「main」と入力します。

CocoaPods を使用

• プロジェクトの Podfile に次の行を追加します。

  pod 'GoogleMobileAdsMediationVerve'
  

• コマンドラインで次のコマンドを実行します。

  pod install --repo-update

手動による統合

• Verve iOS SDK の最新バージョンをダウンロードし、プロジェクトに VerveSDK.framework をリンクします。

• 変更履歴のダウンロード リンク から Verve アダプタの最新バージョンをダウンロードし、プロジェクトに 変更履歴をリンクします。 VerveAdapter.framework

• プロジェクトに次のフレームワークを追加します。

  • AdSupport
  • AVFoundation
  • CoreGraphics
  • CoreMedia
  • CoreTelephony
  • StoreKit
  • SystemConfiguration
  • UIKit
  • WebKit
  • libz.tbd

ステップ 4: Verve SDK にプライバシー設定を実装する

EU の同意に関する規制と GDPR

Google の EU ユーザーの同意ポリシーに準拠する には、欧州経済領域（EEA）、英国、スイスの ユーザーに対して特定の情報を開示し、法律で 義務付けられている場合は、Cookie やその他のローカル ストレージの使用、広告の パーソナライズを目的とした個人データの収集、共有、使用についてユーザーの同意を得る必要があります。このポリシーには、EU の e プライバシー指令と一般データ保護規則（GDPR）の要件が反映されています。パブリッシャー様には、同意がメディエーション チェーン内の各広告ソースに反映されていることを確認する責任があります。

Verve HyBid SDK は、UMP SDK などの同意管理プラットフォームによって設定された GDPR 同意を自動的に読み取ります。詳しくは、 GDPR TCF コンプライアンスをご覧ください。

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

米国のプライバシー関連州法では、ユーザーが「個人情報」の「販売」をオプトアウトする権利を付与することが義務付けられています（用語は法律の定義に基づく）。「販売者」のホームページには、「個人情報を第三者に売却しない」ことを明記したリンクを目立つように表示することによってオプトアウトの手段を提供する必要があります。米国のプライバシー関連州法遵守ガイドでは、Google 広告の配信で制限付きデータ処理を有効にできますが、Google がこの設定をメディエーション チェーン内の各広告ネットワークに適用することはできません。そのため、メディエーション チェーン内で個人情報の販売に関与する可能性のある広告ネットワークを特定し、各ネットワークのガイダンスに沿って州法を遵守する必要があります。

Verve HyBid SDK は、 メソッドを使用してプライバシー設定をサポートしています。次のサンプルコードは、この同意情報を Verve HyBid SDK に渡します。同意情報 を Verve HyBid SDK に手動で渡す場合は、この例 を呼び出す前に、Google Mobile Ads SDKを介して広告をリクエストすることをおすすめします。

HyBidUserDataManager.sharedInstance().setIABUSPrivacyString(usPrivacyString)
VerveMediationSwiftSnippets.swift

[[HyBidUserDataManager sharedInstance] setIABUSPrivacyString:kUSPrivacyString];
VerveMediationObjectiveCSnippets.m

詳しくは、 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 アダプタがスローするコードとメッセージは次のとおりです。

Verve iOS メディエーション アダプタの変更履歴

バージョン 3.9.3.0（開発中）

バージョン 3.9.2.0

• HyBid SDK バージョン 3.9.2 との互換性を確認しました。

構築およびテストに使用したバージョン:

• Google Mobile Ads SDK バージョン 13.9.0。
• HyBid SDK バージョン 3.9.2。

バージョン 3.9.1.0

• HyBid SDK バージョン 3.9.1 との互換性を確認しました。

構築およびテストに使用したバージョン:

• Google Mobile Ads SDK バージョン 13.8.0。
• HyBid SDK バージョン 3.9.1。

バージョン 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。