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

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

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

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

¹ このフォーマットの入札の統合はオープンベータ版です。

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

要件

• Android API レベル 21 以降

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

• 最新の Google Mobile Ads SDK

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

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

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

[アプリケーションを追加] ボタンをクリックして、アプリを Liftoff 収益化ダッシュボードに追加します。

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

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

アプリ ID をメモします。

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

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

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

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

Reporting API キーを確認する

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

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

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

ステップ 2: AdMob UI で Liftoff の収益化デマンドを設定する

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

広告ユニットのメディエーション構成に Liftoff Monetize を追加する必要があります。

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

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

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

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

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

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

Liftoff Monetize を広告ソースとして追加する

単価設定

[広告ソース] セクションの [入札] カードで、[広告ソースを追加] を選択します。[Liftoff 収益化] を選択します。
[パートナー契約への署名手順] をクリックし、Liftoff Monetize で入札パートナーシップを設定します。
[確認して同意する]、[続行] の順にクリックします。
Liftoff Monetize のマッピングがすでにある場合は、そのマッピングを選択できます。それ以外の場合は、[マッピングを追加] をクリックします。
次に、前のセクションで取得したアプリケーション ID とプレースメント リファレンス ID を入力します。[完了] をクリックします。

滝

[広告ソース] セクションの [ウォーターフォール] カードで、[広告ソースを追加] を選択します。[Liftoff 収益化] を選択します。

[Liftoff Monetize] を選択し、[Optimize] スイッチをオンにします。前のセクションで取得したReporting API Key を入力して、Liftoff Monetize の広告ソースの最適化を設定します。次に、Liftoff 収益化の eCPM 値を入力し、[続行] をクリックします。



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

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

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.6.0")
    implementation("com.google.ads.mediation:vungle:7.4.2.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 収益化 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);

AdRequest request = new AdRequest.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 = AdRequest.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.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

• 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

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

バージョン 5.3.0.0

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

バージョン 5.1.0.0

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

以前のバージョン

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