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

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

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

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

¹入札の統合 現在オープンベータ版です

² 入札 このフォーマットの統合はクローズド ベータ版です。

³ リワード インタースティシャル広告の設定のサポートが必要です。アカウントに連絡する Liftoff Monetize または monetize@liftoff.io までお問い合わせください。

要件

• Android API レベル 21 以降

• 最新の Google Mobile Ads SDK

• メディエーションを完了する スタートガイド

ステップ 1: Liftoff Monetize UI で構成をセットアップする

Liftoff Monetize アカウントに登録またはログインします。

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

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

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

アプリ ID をメモします。

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

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

新しいプレースメントを追加する方法について詳しくは、下記をご覧ください。

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

Reporting API キーを確認する

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

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

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

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

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

会社に Liftoff Monetize 追加

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

入札を Liftoff Monetize 設定

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

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

GDPR 設定 米国の州規制の設定 の手順に沿って、 Ad Manager UI の GDPR および米国の州規制の広告パートナーのリストに Liftoff を追加します。

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

Android Studio の統合（推奨）

アプリレベルの build.gradle.kts ファイルに次の実装を追加します。 構成について説明します。最新バージョンの Vungle SDK を使用する およびアダプター:

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

手動による統合

• 最新の Vungle Android SDK をダウンロードします。 libs フォルダの下の .jar ファイルを展開して、 できます。

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

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

EU ユーザーの同意と GDPR

Google の EU ユーザーの同意 ポリシーに基づき、特定の情報開示が必ず行われるようにし、 欧州経済領域（EEA）のユーザーから、 デバイス ID と個人データの使用。このポリシーは、 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 で推奨される実装手順をご確認ください。 を参照してください。

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

米国プライバシー関連州法 は、ユーザーに対して適切な権限を 「セール」からオプトアウトする「個人情報」を（法律で定められているとおり、 これらの規約を参照）の「Do Not Sell My Personal」という目立つ位置で 情報」[販売]ページのリンクに表示されます。「 米国州のプライバシー 法令遵守ガイドに用意されている 制限付きデータ処理 設定されているが、この設定を各広告に適用することはできない 関連付けられますそのため各広告ネットワークを 個人の商品販売に参加するメディエーション チェーン 各ネットワークのガイダンスに従って 遵守する必要があります

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: 実装をテストする

テスト広告を有効にする

Ad Manager にテストデバイスを登録し、 Liftoff Monetize UI でテストモードを有効にします。

テスト広告を確認する

Liftoff Monetizeからテスト広告を受信していることを確認するには、広告インスペクタで Liftoff Monetize (Bidding) and Liftoff Monetize (Waterfall) 広告ソースを使用して単独の広告ソースのテストを有効にします。

省略可能なステップ

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

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.

¹ The Liftoff Monetize メイン画像アセットへの直接アクセスはなく、 できます。代わりに、アダプターが MediaView 追加できます。

エラーコード

アダプタが Liftoff Monetize から広告を受け取れなかった場合、パブリッシャーは以下を行うことができます。 広告レスポンスからの根本的なエラーを確認する ResponseInfo.getAdapterResponses() 次のクラスに分類されます。

Liftoff Monetize がスローしたコードとそのメッセージは次のとおりです。 広告の読み込みに失敗した場合に表示されます。

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

バージョン 7.4.0.0

• VungleMediationAdapter から VungleInterstitialAdapter クラスを拡張しました を追加します。
• 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 プロジェクトを更新しました。
• Bundle ビルダー クラスに以下のメソッドを追加しました。
  • setOrdinalViewCount : このフィールドは、メディエーションの序数、 パブリッシャーが Vungle から序数データレポートを受け取るたびに通知を受け取れます。
  • setFlexViewCloseTimeInSec : このオプションは、フレックス ビュー広告の作成に使用されます 指定した秒数が経過すると、自動的に閉じます。

バージョン 5.3.0.0

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

バージョン 5.1.0.0

• Vungle SDK 5.1.0 に対応するようにアダプターを更新しました。
• バージョン命名システムを [Vungle SDK バージョン].[アダプター パッチ バージョン] です。

以前のバージョン

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