このガイドでは、GMA Next-Gen SDK を使用して、 メディエーションで Verve HyBid SDK の広告を読み込んで表示する方法について説明します。入札 の統合についても説明します。広告ユニットのメディエーション設定に Verve HyBid SDK を追加する方法と、Verve HyBid SDK とアダプタを Android アプリに統合する方法についても説明します。
サポートされている統合と広告フォーマット
Verve HyBid SDK 用のメディエーション アダプタには、次の機能があります。
| 統合 | |
|---|---|
| 入札 | 1 |
| ウォーターフォール | |
| フォーマット | |
| バナー | |
| インタースティシャル | |
| リワード インタースティシャル | |
| 特典 | |
| ネイティブ | |
1 入札の統合はアルファ版です。アクセス権をリクエストするには、アカウント マネージャーにご連絡ください。
要件
- Android API レベル 24 以降
最新の GMA Next-Gen 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 とアダプタをインポートする
Android Studio の統合（推奨）
プロジェクト レベルの settings.gradle.kts ファイルに、次のリポジトリを追加します。
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://verve.jfrog.io/artifactory/verve-gradle-release")
}
}
}
次に、アプリレベルの build.gradle.kts ファイルに、次の実装の依存関係と構成を追加します。最新バージョンの Verve HyBid SDK とアダプタを使用してください。
dependencies {
implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.2.1")
implementation("com.google.ads.mediation:verve:3.9.0.0")
}
configurations {
all {
exclude(group = "com.google.android.gms", module = "play-services-ads")
exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}
}
ステップ 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 に手動で渡す場合は、GMA Next-Gen SDK を介して広告をリクエストする前に、この例を呼び出すことをおすすめします。
Java
Kotlin
US_PRIVACY_STRING は、米国のプライバシー文字列に置き換えてください。
詳しくは、CCPA コンプライアンスに関する Verve HyBid SDK のプライバシー ドキュメントをご覧ください。
ステップ 5: 必要なコードを追加する
Verve HyBid SDK の統合に追加のコードは必要ありません。
ステップ 6: 実装をテストする
テスト広告を有効にする
アド マネージャー用のテストデバイスを 登録 してください。
テスト広告を確認する
Verve HyBid SDK からテスト広告を受信していることを確認するには、 広告インスペクタで 単一の広告ソースのテスト を Verve（入札）の広告ソースを使用して有効にします。
その他の構成については、 Verve HyBid SDK のドキュメントをご覧ください。
エラーコード
アダプタが Verve HyBid SDK から広告を受け取れない場合は、パブリッシャーは
次のクラスの
ResponseInfo.getAdSourceResponses()
を使用して、広告レスポンスから根本原因のエラーを確認できます。
net.pubnative.lite.sdk
com.google.ads.mediation.verve
広告の読み込みに失敗した場合に Verve HyBid SDK アダプタがスローするコードとメッセージは次のとおりです。
| エラーコード | 理由 |
|---|---|
| 100 ～ 103 | Verve HyBid SDK がエラーを返しました。 |
| 101 | リクエストされた広告サイズが、Verve HyBid SDK でサポートされているバナー サイズと一致しません。 |
| 102 | アプリトークンがないか、空です。 |
| 103 | コンテキストが null です。 |
Verve Android メディエーション アダプタの変更履歴
バージョン 3.9.0.0
- 新しい
AgeRestrictedTreatmentがCHILDに設定されている場合、Verve SDK の年齢制限付きリクエストをフィルタします。 - Verve HyBid SDK バージョン 3.9.0 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 25.4.0。
- Google Mobile Ads Next-Gen SDK バージョン 1.2.1。
- Verve HyBid SDK バージョン 3.9.0。
バージョン 3.8.2.0
- Verve HyBid SDK バージョン 3.8.2 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 25.3.0。
- Google Mobile Ads Next-Gen SDK バージョン 1.2.1。
- Verve HyBid SDK バージョン 3.8.2。
バージョン 3.8.1.1
- クリック可能なビューをフィルタして、VerveNativeAd のコンテンツ情報クリックと通常の広告クリックを区別します。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 25.2.0。
- Google Mobile Ads Next-Gen SDK バージョン 1.0.1。
- Verve HyBid SDK バージョン 3.8.1。
バージョン 3.8.1.0
- GMA Next-Gen SDK の依存関係を使用してアダプタをビルドするプロパティを追加しました。
- Verve HyBid SDK バージョン 3.8.1 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 25.1.0。
- Verve HyBid SDK バージョン 3.8.1。
バージョン 3.7.1.1
- シグナルの収集エラーを解決するため、Verve アダプタからバナーサイズのチェックを削除しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 25.0.0。
- Verve HyBid SDK バージョン 3.7.1。
バージョン 3.7.1.0
- 初回リリース。
- Verve HyBid SDK バージョン 3.7.1 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 24.8.0。
- Verve HyBid SDK バージョン 3.7.1。