Verve HyBid SDK をメディエーションと統合する

プラットフォームを選択: Android iOS Android（以前のバージョン）

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

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

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

統合
入札  1
ウォーターフォール
フォーマット
バナー
インタースティシャル
リワード インタースティシャル
特典
ネイティブ

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

前提条件

先に進む前に、次のことを確認してください。

  • Android API レベル 24 以降。

ステップ 1: Verve HyBid SDK の管理画面で構成を設定する

構成の設定については、Verve にお問い合わせください。

ステップ 2: AdMob の管理画面で Verve HyBid SDK のデマンドを設定する

広告ユニットのメディエーション設定を構成する

広告ユニットのメディエーション設定に Verve HyBid SDK を追加する必要があります。

まず、AdMob アカウントにログインします。次に、[メディエーション] タブに移動します。変更したい既存のメディエーション グループがある場合は、そのメディエーション グループの名前をクリックして編集し、 広告のソースとして Verve HyBid SDK を追加するに進みます。

新しいメディエーション グループを作成するには、[メディエーション グループを作成] をクリックします。

広告フォーマットとプラットフォームを入力し、[続行] をクリックします。

メディエーション グループに名前を付け、ターゲットとする地域を選択します。次に、 メディエーション グループのステータスを [有効] に設定し、[広告ユニットを追加] をクリックします。

このメディエーション グループを、1 つ以上の既存の AdMob 広告ユニットに関連付けます。次に [完了] をクリックします。

広告ユニット カードに選択した広告ユニットが表示されます。

広告のソースとして Verve HyBid SDK を追加する


[広告ソース] セクションの [入札] カードで、[広告のソースを追加] を選択します。[Verve HyBid SDK] を選択します。

[**パートナー契約への署名手順**] をクリックし、 入札のパートナーシップを Verve HyBid SDK と 設定します。



[確認して同意する] をクリックし、[続行] をクリックします。



Verve HyBid SDK のマッピングがすでに存在する場合は、 それを選択できます。それ以外の場合は、[マッピングを追加] をクリックします。



次に、 ゾーン ID と アプリトークン を前のセクションで取得したものを入力します。[完了] をクリックします。

GDPR と米国の州規制の広告パートナー リストに Verve Group を追加する

欧州の規制に関する設定と米国の州の規制に関する設定の手順に沿って、AdMob 管理画面の欧州および米国の州の規制に関する広告パートナーのリストにVerve Groupを追加します。

ステップ 3: Verve HyBid SDK とアダプタをインポートする

プロジェクト レベルの 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.3.1")
    implementation("com.google.ads.mediation:verve:3.9.1.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 にプライバシー設定を実装する

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

HyBid.getUserDataManager().setIABUSPrivacyString(US_PRIVACY_STRING);

Kotlin

HyBid.getUserDataManager().setIABUSPrivacyString(US_PRIVACY_STRING)

US_PRIVACY_STRING は、米国のプライバシー文字列に置き換えます。

詳しくは、 CCPA コンプライアンスに関する Verve HyBid SDK のプライバシー ドキュメントをご覧ください。

ステップ 5: 必要なコードを追加する

Verve HyBid SDK の統合に追加のコードは必要ありません。

ステップ 6: 実装をテストする

テスト広告を有効にする

AdMob 用のテストデバイスを 登録 してください。

テスト広告を確認する

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.1.0

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

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

  • Google Mobile Ads SDK バージョン 25.4.0。
  • Google Mobile Ads Next-Gen SDK バージョン 1.3.1。
  • Verve HyBid SDK バージョン 3.9.1。

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