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

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

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

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

要件

• Android API レベル 23 以上

• [入札の場合]: サポートされているすべての広告フォーマットを入札に統合するには、Liftoff Monetize アダプタ 7.3.0.0 以降（最新バージョンを推奨）を使用します。

• Google Mobile Ads SDK のバージョンが最新であること。

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

ステップ 1: Liftoff Monetize の管理画面で構成を設定する

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

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

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

アプリを作成したら、Liftoff Monetize アプリケーション ダッシュボードでアプリを選択します。

アプリ ID をメモします。

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

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

新しいプレースメントを追加する手順は以下のとおりです。

参照 ID をメモして、[Sounds Good]（了解）をクリックします。

Reporting API キーを確認する

app-ads.txt を更新する

Authorized Sellers for Apps app-ads.txt は、承認されたチャネルでのみアプリ広告枠を販売できるようにする IAB Tech Lab が推進しているイニシアチブです。広告収益の大幅な減少を防ぐためには、app-ads.txt ファイルを実装する必要があります。まだ作成していない場合は、アド マネージャー用の app-ads.txt ファイルを作成します。

Liftoff Monetize の app-ads.txt を実装するには、Liftoff Monetize の app-ads.txt エントリをダウンロードして、既存の app-ads.txt ファイルに追加します。詳しくは、app-ads.txt をご覧ください。

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

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

アプリの [プレースメント参照 ID] セクションで、テスト広告を有効にするアプリを選択します。[ステータス] セクションで [テストモード] を [テスト広告のみを表示] に設定すると、テスト広告を有効にできます。

ステップ 2: アド マネージャーの管理画面で Liftoff Monetize のデマンドを設定する

アド マネージャー アカウントにログインします。

[会社] に Liftoff Monetize を追加

セキュア シグナルの共有を有効にする

入札リクエストでセキュア シグナルを共有する

SDK 入札のセキュア シグナルの共有を許可する

Liftoff Monetize の入札を設定する

広告ユニットのマッピングを設定する

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

欧州の規制に関する設定と米国の州の規制に関する設定の手順に沿って、アド マネージャーの管理画面で欧州および米国の州の規制に関する広告パートナーのリストに Liftoff を追加します。

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

Android Studio の統合（推奨）

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

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

手動による統合

• 最新の Vungle Android SDK をダウンロードし、libs フォルダにある .aar ファイルと JAR ファイルを抽出して、プロジェクトに追加します。

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

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

EU ユーザーからの同意と GDPR

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

Vungle SDK バージョン 7.4.1 以降では、Liftoff Monetize は、UMP SDK を含む Google の追加の同意に関する仕様をサポートする同意管理プラットフォームによって設定された GDPR 同意を自動的に読み取ります。詳しくは、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: 実装をテストする

テスト広告を有効にする

アド マネージャー用のテストデバイスを登録し、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 から発生したエラーについては、エラーコード: iOS および Android 向け Vungle SDK を参照してください。

Liftoff Monetize Android メディエーション アダプタの変更履歴

バージョン 7.5.1.0

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

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

• Google Mobile Ads SDK バージョン 24.5.0。
• Vungle SDK バージョン 7.5.1。

バージョン 7.5.0.1

• ウォーターフォールと RTB の両方のネイティブ広告で overrideImpressionRecording を true に設定します。

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

• Google Mobile Ads SDK バージョン 24.4.0。
• Vungle SDK バージョン 7.5.0。

バージョン 7.5.0.0

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

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

• Google Mobile Ads SDK バージョン 24.2.0。
• Vungle SDK バージョン 7.5.0。

バージョン 7.4.3.1

• 必要な最小 Android API レベルを 23 に更新しました。
• Google Mobile Ads SDK の必要最小限のバージョンを 24.0.0 に更新しました。

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

• Google Mobile Ads SDK バージョン 24.0.0。
• Vungle SDK バージョン 7.4.3。

バージョン 7.4.3.0

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

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

• Google Mobile Ads SDK バージョン 23.6.0。
• Vungle SDK バージョン 7.4.3。

バージョン 7.4.2.0

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

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

• Google Mobile Ads SDK バージョン 23.5.0。
• Vungle SDK バージョン 7.4.2。

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

• VungleMediationAdapter から VungleInterstitialAdapter クラスを拡張し、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 との互換性を確認しました。
• バナー広告とインタースティシャル広告をリクエストする際に、Vungle ネットワーク固有のパラメータを取得するために、パラメータ serverParameters を mediationExtras に置き換えることで、アダプタの問題を修正しました。

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

• 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 に更新しました。
• Vungle のバナー API で MREC 広告がサポートされるようになりました。
• 標準化されたエラーコードとメッセージが更新されました。

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

• 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

• 新しいオープンベータ版の Rewarded 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 プロジェクトを更新しました。
• Bundle ビルダー クラスに次のメソッドを追加しました。
  • setOrdinalViewCount : パブリッシャーが Vungle から順序データレポートを受け取るたびに、このフィールドを使用してメディエーションの順序を渡します。
  • setFlexViewCloseTimeInSec : このオプションは、指定した秒数の経過後にフレックス ビュー広告が自動的に閉じられるようにするために使用します。

バージョン 5.3.0.0

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

バージョン 5.1.0.0

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

以前のバージョン

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