Liftoff Monetize をメディエーションと統合する

このガイドでは、Google Mobile Ads SDK を使用して、 メディエーション、 入札とウォーターフォールの両方の統合をカバーする、Liftoff Monetize の広告を読み込んで表示する方法について説明します。ここでは、Liftoff Monetize を広告ユニットのメディエーション構成に追加する方法と、Vungle SDK とアダプタをアプリに統合する方法について説明します。 Android

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

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

¹入札の統合はオープンベータ版です。

² この形式のウォーターフォールの統合はオープンベータ版です。

要件

• Android API レベル 21 以降

• 最新の Google Mobile Ads SDK

• メディエーションのスタートガイドを完了していること

ステップ 1: Liftoff 収益化 UI で設定を行う

Liftoff Monetize アカウントに登録するか、ログインします。

[Add Application] ボタンをクリックして、Liftoff Monetize ダッシュボードにアプリを追加します。

フォームに必要な情報をすべて入力します。

アプリを作成したら、Liftoff の [Monetize Applications] ダッシュボードからアプリを選択します。

アプリ ID をメモします。

新しいプレースメントを追加する

AdMob メディエーションで使用する新しいプレースメントを作成するには、Liftoff の Monetize Placements ダッシュボードに移動し、[Add Placement] ボタンをクリックして、プルダウン リストからアプリを選択します。

新しいプレースメントを追加する方法の詳細は次のとおりです。

参照 ID をメモし、[Sounds Good] をクリックします。

Reporting API キーを確認する

テストモードをオンにする

テスト広告を有効にするには、Liftoff Monetize ダッシュボードに移動し、[アプリ] に移動します。

テスト広告を有効にするアプリを、アプリの [プレースメント リファレンス ID] セクションで選択します。テスト広告を有効にするには、[ステータス] セクションで [テストモード] から [テスト広告のみを表示] を選択します。

ステップ 2: Ad Manager UI で Liftoff Monetize デマンドを設定する

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

GDPR 設定と 米国の州の規制設定の手順に沿って、AdMob 管理画面の GDPR と米国の州の規制の広告パートナー リストに Liftoff を追加します。

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

Android Studio の統合（推奨）

アプリレベルの build.gradle.kts ファイルで、次の実装依存関係と構成を追加します。Vungle SDK とアダプタの最新バージョンを使用します。

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.5.0")
    implementation("com.google.ads.mediation:vungle:7.4.1.0")
}

手動による統合

• 最新の Vungle Android SDK をダウンロードし、libs フォルダに .jar ファイルを解凍してプロジェクトに追加します。

• Google の Maven リポジトリにある Liftoff Monetize アダプタ アーティファクトに移動します。最新バージョンを選択し、Vungle アダプターの .aar ファイルをダウンロードしてプロジェクトに追加します。

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

EU ユーザーの同意と GDPR

Google の EU ユーザーの同意ポリシーに基づき、デバイス ID と個人データの使用について、欧州経済領域（EEA）のユーザーに対して特定の情報を開示し、同意を得る必要があります。このポリシーには、EU の e プライバシー指令と一般データ保護規則（GDPR）の要件が反映されています。同意を求める際は、個人データを収集、受領、または使用する可能性があるメディエーション チェーン内の各広告ネットワークを特定し、各ネットワークの使用に関する情報を提供する必要があります。現在のところ、Google はユーザーの同意に関する選択を自動的にこのようなネットワークに渡すことはできません。

Liftoff Monetize には、Vungle SDK に同意を渡すことができる API が含まれています。次のサンプルコードは、この同意情報を Vungle SDK に渡す方法を示しています。このメソッドを呼び出す場合は、Google Mobile Ads SDK で広告をリクエストする前に呼び出すことをおすすめします。

import com.vungle.ads.VunglePrivacySettings;
// ...

VunglePrivacySettings.setGDPRStatus(true, "v1.0.0");

import com.vungle.ads.VunglePrivacySettings
// ...

VunglePrivacySettings.setGDPRStatus(true, "v1.0.0")

詳細とメソッドで指定できる値については、GDPR で推奨される実装手順をご覧ください。

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

米国の州のプライバシー法 は、ユーザーに「個人情報」の「販売」を拒否する権利を保障する法律で、「販売者」パーティのホームページにある「個人情報を販売しない」リンクから販売を拒否することができます。米国の州のプライバシー関連法の遵守ガイドでは、Google 広告配信で制限付きデータ処理を有効にできますが、Google はメディエーション チェーン内の各広告ネットワークにこの設定を適用することはできません。そのため、個人情報の販売に参加する可能性があるメディエーション チェーンの各広告ネットワークを特定し、各ネットワークのガイダンスに従ってコンプライアンスを確保する必要があります。

Liftoff Monetize には、Vungle SDK に同意を渡すことができる API が含まれています。次のサンプルコードは、この同意情報を Vungle SDK に渡す方法を示しています。このメソッドを呼び出す場合は、Google Mobile Ads SDK で広告をリクエストする前に呼び出すことをおすすめします。

import com.vungle.ads.VunglePrivacySettings;
// ...

VunglePrivacySettings.setCCPAStatus(true);

import com.vungle.ads.VunglePrivacySettings
// ...

VunglePrivacySettings.setCCPAStatus(true)

詳細と、このメソッドで指定できる値については、CCPA の実装をご覧ください。

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

Liftoff Monetize の統合に追加のコードは必要ありません。

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

テスト広告を有効にする

AdMob にテストデバイスを登録し、Liftoff Monetize の UI でテストモードを有効にするようにしてください。

テスト広告を確認する

Liftoff Monetize からテスト広告を受信していることを確認するには、Liftoff Monetize（入札）と Liftoff Monetize（ウォーターフォール）の広告ソースを使用して、広告インスペクタで単一の広告ソースのテストを有効にします。

省略可能なステップ

ネットワーク固有のパラメータ

Liftoff Monetize アダプタは、アダプタに渡すことができる次のリクエスト パラメータをサポートしています。

userId

Liftoff Monetize のインセンティブ付きユーザー ID を表す文字列。

adOrientation

全画面広告の表示の向きを指定する整数。

これらのパラメータを設定する広告リクエストを作成するコードの例を次に示します。

Bundle extras = new Bundle();
extras.putString(VungleConstants.KEY_USER_ID, "myUserID");
extras.putInt(VungleConstants.KEY_ORIENTATION, 1);

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
   .addNetworkExtrasBundle(VungleAdapter.class, extras) // Rewarded.
   .addNetworkExtrasBundle(VungleInterstitialAdapter.class, extras) // Interstitial.
   .build();

val extras = Bundle()
extras.putString(VungleConstants.KEY_USER_ID, "myUserID")
extras.putInt(VungleConstants.KEY_ORIENTATION, 1)

val request = AdManagerAdRequest.Builder()
   .addNetworkExtrasBundle(VungleAdapter::class, extras) // Rewarded.
   .addNetworkExtrasBundle(VungleInterstitialAdapter.class, extras) // Interstitial.
   .build()

ネイティブ広告のレンダリング

Liftoff Monetize アダプタは、ネイティブ広告を NativeAd オブジェクトとして返します。 NativeAd の フィールド に、次の値が入力されます。

¹ Liftoff Monetize アダプタは、ネイティブ広告のメイン画像アセットに直接アクセスできません。代わりに、アダプターは MediaView に動画または画像を入力します。

エラーコード

アダプターが Liftoff Monetize から広告を受信できない場合、パブリッシャーは次のクラスの ResponseInfo.getAdapterResponses() を使用して、広告レスポンスから根本的なエラーを確認できます。

広告の読み込みに失敗したときに、Liftoff Monetize アダプタによってスローされるコードと付随するメッセージは次のとおりです。

Vungle SDK に起因するエラーについては、エラーコード: Vungle SDK for iOS and Android をご覧ください。

Liftoff Monetize Android メディエーション アダプタに関する変更履歴

バージョン 7.4.1.0

• Vungle SDK 7.4.1 との互換性を確認しました。

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

• Google Mobile Ads SDK バージョン 23.3.0。
• Vungle SDK バージョン 7.4.1。

バージョン 7.4.0.1

• 入札とウォーターフォールのバナー広告でカスタム広告サイズのサポートを追加しました。

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

• Google Mobile Ads SDK バージョン 23.2.0。
• Vungle SDK バージョン 7.4.0。

バージョン 7.4.0.0

• VungleInterstitialAdapter クラスを VungleMediationAdapter から拡張し、Google アド マネージャーのアプリ起動広告フォーマットのウォーターフォール サポートを追加しました。
• Vungle SDK 7.4.0 との互換性を確認しました。

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

• Google Mobile Ads SDK バージョン 23.2.0。
• Vungle SDK バージョン 7.4.0。

バージョン 7.3.2.0

• Vungle SDK 7.3.2 との互換性を検証しました。

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

• Google Mobile Ads SDK バージョン 23.0.0。
• Vungle SDK バージョン 7.3.2。

バージョン 7.3.1.0

• Vungle SDK 7.3.1 との互換性を確認しました。

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

• Google Mobile Ads SDK バージョン 23.0.0。
• Vungle SDK バージョン 7.3.1。

バージョン 7.3.0.0

• 必須の Google Mobile Ads SDK バージョンを 23.0.0 に更新しました。
• Vungle SDK 7.3.0 との互換性を検証しました。
• アプリ起動広告フォーマットのウォーターフォールと入札のサポートを追加しました。

以下を使用してビルドとテストを行う:

• Google Mobile Ads SDK バージョン 23.0.0。
• Vungle SDK バージョン 7.3.0。

バージョン 7.1.0.0

• Vungle SDK 7.1.0 との互換性を確認しました。

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

• Google Mobile Ads SDK バージョン 22.3.0。
• Vungle SDK バージョン 7.1.0。

バージョン 7.0.0.1

• Google Mobile Ads SDK でネイティブ広告入札のインプレッションが記録されない問題を修正しました。
• アダプタの依存関係を Google Mobile Ads SDK バージョン 22.3.0 に戻しました。

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

• Google Mobile Ads SDK バージョン 22.3.0。
• Vungle SDK バージョン 7.0.0。

バージョン 7.0.0.0

• すべてのウォーターフォール広告フォーマットで、同じプレースメント ID を持つ複数の広告を読み込むサポートを追加しました。
• アダプタの名前を Vungle から Liftoff Monetize に変更しました。
• Vungle SDK 7.0.0 との互換性を確認しました。

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

• Google Mobile Ads SDK バージョン 22.4.0.
• Vungle SDK バージョン 7.0.0。

バージョン 6.12.1.1

• 新しい VersionInfo クラスを使用するようにアダプターを更新しました。
• 必須の Google Mobile Ads SDK バージョンを 22.0.0 に更新しました。

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

• Google Mobile Ads SDK バージョン 22.0.0 にアップデートします。
• Vungle SDK バージョン 6.12.1。

バージョン 6.12.1.0

• Vungle SDK 6.12.1 との互換性を検証しました。

以下を使用してビルドとテストを行う:

• Google Mobile Ads SDK バージョン 21.4.0。
• Vungle SDK バージョン 6.12.1。

バージョン 6.12.0.1

• バナー広告フォーマットの入札サポートを追加しました。
• Vungle SDK 6.12.0 との互換性を確認しました。
• 必須の Google Mobile Ads SDK バージョンを 21.4.0 に更新しました。

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

• Google Mobile Ads SDK バージョン 21.4.0.
• Vungle SDK バージョン 6.12.0。

バージョン 6.12.0.0

• リワード インタースティシャル広告フォーマットに対するウォーターフォール メディエーションと入札のサポートを追加しました。
• ネイティブ広告フォーマットの入札サポートを追加しました。

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

• Google Mobile Ads SDK バージョン 21.1.0。
• Vungle SDK バージョン 6.12.0。

バージョン 6.11.0.3

• ネイティブ広告フォーマットのウォーターフォール メディエーションのサポートを追加しました。
• 必要最小限の Google Mobile Ads SDK バージョンを 21.1.0 に更新しました。

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

• Google Mobile Ads SDK バージョン 21.1.0.
• Vungle SDK バージョン 6.11.0。

バージョン 6.11.0.2

• リワード広告で、同じプレースメント ID に複数の広告を読み込むことがサポートされるようになりました。

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

• Google Mobile Ads SDK バージョン 21.0.0。
• Vungle SDK バージョン 6.11.0。

バージョン 6.11.0.1

• compileSdkVersion と targetSdkVersion を API 31 に更新しました。
• 必須の Google Mobile Ads SDK バージョンを 21.0.0 に更新しました。
• 必要最小限の Android API レベルを 19 に更新しました。

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

• Google Mobile Ads SDK バージョン 21.0.0。
• Vungle SDK バージョン 6.11.0。

バージョン 6.11.0.0

• Vungle SDK 6.11.0 との互換性を確認しました。

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

• Google Mobile Ads SDK バージョン 20.6.0。
• Vungle SDK バージョン 6.11.0。

バージョン 6.10.5.0

• Vungle SDK 6.10.5 との互換性を確認しました。
• 必須となる Google Mobile Ads SDK のバージョンを 20.6.0 に更新しました。

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

• Google Mobile Ads SDK バージョン 20.6.0。
• Vungle SDK バージョン 6.10.5。

バージョン 6.10.4.0

• Vungle SDK 6.10.4 との互換性を確認しました。

以下を使用してビルドとテストを行う:

• Google Mobile Ads SDK バージョン 20.5.0。
• Vungle SDK バージョン 6.10.4。

バージョン 6.10.3.0

• Vungle SDK 6.10.3 との互換性を確認しました。

以下を使用してビルドとテストを行う:

• Google Mobile Ads SDK バージョン 20.5.0.
• Vungle SDK バージョン 6.10.3。

バージョン 6.10.2.1

• Vungle SDK 6.10.2 との互換性を確認しました。
• インタースティシャル広告とリワード広告フォーマットの入札サポートを追加しました。
• 必須となる Google Mobile Ads SDK のバージョンを 20.5.0 に更新しました。

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

• Google Mobile Ads SDK バージョン 20.5.0。
• Vungle SDK バージョン 6.10.2。

バージョン 6.10.2.0

• Vungle SDK 6.10.2 との互換性を確認しました。
• バナー広告とインタースティシャル広告をリクエストする際に、パラメータ serverParameters を mediationExtras に置き換えて Vungle ネットワーク固有のパラメータを取得し、アダプタの問題を修正しました。

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

• Google Mobile Ads SDK バージョン 20.3.0。
• Vungle SDK バージョン 6.10.2。

バージョン 6.10.1.0

• Vungle SDK 6.10.1 との互換性を確認しました。
• 必要最小限の Google Mobile Ads SDK バージョンを 20.3.0 に更新しました。
• MREC 広告が Vungle のバナー API でサポートされるようになりました。
• 標準化されたエラーコードとメッセージを更新しました。

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

• Google Mobile Ads SDK バージョン 20.3.0。
• Vungle SDK バージョン 6.10.1。

バージョン 6.9.1.1

• 必要最小限の Google Mobile Ads SDK バージョンを 20.0.0 に更新しました。

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

• Google Mobile Ads SDK バージョン 20.0.0。
• Vungle SDK バージョン 6.9.1。

バージョン 6.9.1.0

• Vungle SDK 6.9.1 との互換性を確認しました。
• OMSDK のサポートを追加しました。
• さまざまなバグを修正しました。
• Vungle の onAdViewed コールバックのリワード広告のサポート。
• 必要最小限の Google Mobile Ads SDK バージョンを 19.7.0 に更新しました。

以下を使用してビルドとテストを行う:

• Google Mobile Ads SDK バージョン 19.7.0。
• Vungle SDK バージョン 6.9.1。

バージョン 6.8.1.1

• 必要最小限の Google Mobile Ads SDK バージョンを 19.6.0 に更新しました。

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

• Google Mobile Ads SDK バージョン 19.6.0.
• Vungle SDK バージョン 6.8.1。

バージョン 6.8.1.0

• Vungle SDK 6.8.1 との互換性を確認しました。
• 必須となる Google Mobile Ads SDK のバージョンを 19.5.0 に更新しました。

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

• Google Mobile Ads SDK バージョン 19.5.0。
• Vungle SDK バージョン 6.8.1。

バージョン 6.8.0.0

• Vungle SDK 6.8.0 との互換性を検証しました。
• バナー広告が更新または破棄されたときに onAdClosed() を転送しないようにアダプターを更新しました。
• FlexFeed と FlexView を削除しました（Vungle 6.8.0 で非推奨）。
• 必要最小限の Google Mobile Ads SDK バージョンを 19.4.0 に更新しました。

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

• Google Mobile Ads SDK バージョン 19.4.0。
• Vungle SDK バージョン 6.8.0。

バージョン 6.7.1.0

• Vungle SDK 6.7.1 との互換性を確認しました。
• アプリのコンテキストを使用して広告を読み込んだ場合に広告が読み込まれないバグを修正しました。
• targetSdkVersion を API 29 に更新しました。
• 必須の Google Mobile Ads SDK バージョンを 19.3.0 に更新しました。

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

• Google Mobile Ads SDK バージョン 19.3.0.
• Vungle SDK バージョン 6.7.1。

バージョン 6.7.0.0

• Vungle SDK 6.7.0 との互換性を検証しました。
• インライン アダプティブ バナー リクエストをサポートするようにアダプターを更新しました。
• インタースティシャル広告とリワード広告はデフォルトでミュート解除されました。
• インタースティシャル広告がクリックされたときに onAdLeftApplication() コールバックを転送するようになりました。
• 必要な最小バージョンの Google Mobile Ads SDK を 19.2.0 に更新しました。

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

• Google Mobile Ads SDK バージョン 19.2.0.
• Vungle SDK バージョン 6.7.0。

バージョン 6.5.3.0

• Vungle SDK 6.5.3 との互換性を確認しました。
• 新たに導入された Vungle のバナー形式のサポートを追加しました。
• 必須の Google Mobile Ads SDK バージョンを 19.0.1 に更新しました。

以下を使用してビルドとテストを行う:

• Google Mobile Ads SDK バージョン 19.0.1。
• Vungle SDK バージョン 6.5.3。

バージョン 6.4.11.1

• バナー広告が更新されない問題を修正しました。

バージョン 6.4.11.0

• Vungle SDK 6.4.11 との互換性を確認しました。
• バナー広告のサポートを追加しました。
• アダプターを AndroidX に移行しました。
• 必須となる Google Mobile Ads SDK のバージョンを 18.2.0 に更新しました。

バージョン 6.3.24.1

• 新しいオープンベータ版リワード API をサポートするようにアダプタを更新しました。
• 最低限必要な Google Mobile Ads SDK のバージョンを 17.2.0 に更新しました。

バージョン 6.3.24.0

• Vungle SDK 6.3.24 との互換性を確認しました。

バージョン 6.3.17.0

• Vungle SDK 6.3.17 との互換性を検証しました。

バージョン 6.3.12.0

• Vungle SDK 6.3.12 との互換性を検証しました。

バージョン 6.2.5.1

• onRewardedVideoComplete() 広告イベントを呼び出すようにアダプターを更新しました。

バージョン 6.2.5.0

• Vungle SDK 6.2.5 との互換性を確認しました。

バージョン 5.3.2.1

• アダプタを更新し、Google Mobile Ads SDK にクリックを正しく報告するようにしました。

バージョン 5.3.2.0

• Vungle SDK 5.3.2 との互換性を確認しました。
• Android Studio 3.0 用に Adpater プロジェクトを更新しました。
• バンドル ビルダー クラスに次のメソッドを追加しました。
  • setOrdinalViewCount : このフィールドは、パブリッシャーが Vungle からオーディナル データ レポートを受け取るたびに、メディエーション オーディナルを渡すために使用されます。
  • setFlexViewCloseTimeInSec: このオプションは、指定した秒数経過後に Flex ビュー広告を自動的に閉じるように設定するために使用します。

バージョン 5.3.0.0

• Vungle SDK 5.3.0 との互換性を確認しました。

バージョン 5.1.0.0

• Vungle SDK 5.1.0 と互換性を持たせるためにアダプターを更新しました。
• バージョン命名システムを [Vungle SDK バージョン].[アダプター パッチ バージョン] に変更しました。

以前のバージョン

• インタースティシャル広告と動画リワード広告フォーマットのサポートを追加しました。