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

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

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

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

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

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

要件

  • 最新の Google Mobile Ads SDK
  • Unity 4 以降
  • （入札用）: Liftoff Monetize 3.8.2 以降用の Google モバイル広告メディエーション プラグイン（最新バージョンを推奨）
  • Android にデプロイするには
    • Android API レベル 21 以降
  • iOS にデプロイする場合
    • iOS デプロイ ターゲットが 12.0 以降であること
  • Google Mobile Ads SDK で構成された Unity 作業中のプロジェクト詳しくは、使ってみるをご覧ください。
  • メディエーションのスタートガイドを完了します。

ステップ 1: Liftoff Monetize UI で設定を行う

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

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

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

Android

iOS

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

Android

iOS

アプリ ID をメモします。

Android

iOS

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

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

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

[Banner] を選択し、プレースメント名を入力して、フォームの残りの部分を入力します。[入札のみ] [収益化] で、[アプリ内入札] スイッチを [有効] に切り替えます。ページの下部にある [続行] ボタンをクリックして、プレースメントを作成します。

300×250 のバナー

[MREC] を選択してプレースメント名を入力し、フォームの残りの部分に入力します。[入札のみ] [収益化] で、[アプリ内入札] スイッチを [有効] に切り替えます。ページの下部にある [続行] ボタンをクリックして、プレースメントを作成します。

インタースティシャル

[インタースティシャル] を選択してプレースメント名を入力し、フォームの残りの部分に入力します。[入札のみ] [収益化] で、[アプリ内入札] を [有効] に切り替えます。ページの下部にある [続行] ボタンをクリックして、プレースメントを作成します。

特典

[リワード] を選択してプレースメント名を入力し、フォームの残りの部分に入力します。[入札のみ] [収益化] で、[アプリ内入札] スイッチを [有効] に切り替えます。ページの下部にある [続行] ボタンをクリックして、プレースメントを作成します。

リワード インタースティシャル

[リワード] を選択します。[プレースメント名] を入力し、[スキップ可能] を有効にして、フォームの残りの部分を入力します。[入札のみ] [収益化] で、[アプリ内入札] を [有効] に切り替えます。ページの下部にある [続行] ボタンをクリックして、プレースメントを作成します。

ネイティブ

[ネイティブ] を選択し、プレースメント名を入力して、フォームの残りの部分を入力します。[入札のみ] [収益化] で、[アプリ内入札] スイッチを [有効] に切り替えます。ページの下部にある [続行] ボタンをクリックして、プレースメントを作成します。

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

300×250 のバナー

インタースティシャル

特典

リワード インタースティシャル

ネイティブ

Reporting API キーを確認する

入札

入札の統合では、この手順は必要ありません。

ウォーターフォール

AdMob 広告ユニット ID を設定するには、アプリ ID と参照 ID に加えて、Liftoff Monetize Reporting API キーも必要です。Liftoff Monetize Reports ダッシュボードに移動し、[Reporting API Key] ボタンをクリックして Reporting API キーを表示します。

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

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

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

Android

iOS

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

広告ユニットのメディエーション設定を行う

Android

手順については、 Android 向けガイドのステップ 2 をご覧ください。

iOS

手順については、 iOS 向けガイドのステップ 2 をご覧ください。

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

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

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

変更ログのダウンロード リンクから、Liftoff 用の Google モバイル広告メディエーション プラグインの最新バージョンをダウンロードし、zip ファイルから GoogleMobileAdsVungleMediation.unitypackage を抽出します。

Unity プロジェクト エディタで、[Assets] > [Import Package] > [Custom Package] を選択し、ダウンロードした GoogleMobileAdsVungleMediation.unitypackage ファイルを見つけます。すべてのファイルが選択されていることを確認し、[Import]（インポート）をクリックします。

次に、[Assets] > [Play Services Resolver] > [Android Resolver] > [Force Resolver] を選択します。Unity Play Services Resolver ライブラリは、依存関係の解決をゼロから行い、宣言された依存関係を Unity アプリの Assets/Plugins/Android ディレクトリにコピーします。

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

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

Liftoff Monetize バージョン 4.0.0 用の Google モバイル広告メディエーション プラグインには、同意の情報を Vungle SDK に渡すメソッドが含まれています。

Android

同意ステータスの更新時に指定できる値は次の 2 つです。

  • VungleConsentStatus.OPTED_IN
  • VungleConsentStatus.OPTED_OUT

次のサンプルコードは、同意ステータスを VungleConsentStatus.OPTED_IN に更新します。このメソッドを呼び出す場合は、Google Mobile Ads SDK を使用して広告をリクエストする前に呼び出すことをおすすめします。

using GoogleMobileAds.Mediation.LiftoffMonetize.Api;
// ...

LiftoffMonetize.UpdateConsentStatus(VungleConsentStatus.OPTED_IN, "1.0.0");

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

iOS

次のサンプルコードは、同意情報を Vungle iOS SDK に転送します。このメソッドを呼び出す場合は、Google Mobile Ads SDK を使用して広告をリクエストする前に呼び出すことをおすすめします。

using GoogleMobileAds.Mediation.LiftoffMonetize.Api;
// ...

LiftoffMonetize.SetGDPRStatus(true);
LiftoffMonetize.SetGDPRMessageVersion("1.0.0");

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

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

米国のプライバシー関連州法 「個人情報」の「販売」は、法律で定められているとおり、オプトアウトする権利をユーザーに提供することが義務付けられています。オプトアウトするには、「販売」当事者のホームページに目立つ [個人情報を第三者に売却しない] リンクがあります。米国のプライバシー関連州法の遵守ガイドでは、Google の広告配信について制限付きデータ処理を有効にすることができますが、Google がメディエーション チェーンの各広告ネットワークにこの設定を適用することはできません。したがって、個人情報の販売に参加する可能性のあるメディエーション チェーンの各広告ネットワークを特定し、各ネットワークのガイダンスに沿ってポリシーに準拠する必要があります。

Liftoff Monetize バージョン 4.0.0 用の Google モバイル広告メディエーション プラグインには、同意の情報を Vungle SDK に渡すメソッドが含まれています。

Android

同意ステータスの更新時に指定できる値は次の 2 つです。

  • VungleCCPAStatus.OPTED_IN
  • VungleCCPAStatus.OPTED_OUT

次のサンプルコードは、同意ステータスを VungleCCPAStatus.OPTED_IN に更新します。このメソッドを呼び出す場合は、Google Mobile Ads SDK を使用して広告をリクエストする前に呼び出すことをおすすめします。

using GoogleMobileAds.Mediation.LiftoffMonetize.Api;
// ...

LiftoffMonetize.UpdateCCPAStatus(VungleCCPAStatus.OPTED_IN);

詳細とこのメソッドで提供できる値については、CCPA で推奨される実装手順をご覧ください。

iOS

次のサンプルコードは、同意情報を Vungle iOS SDK に転送します。このメソッドを呼び出す場合は、Google Mobile Ads SDK を使用して広告をリクエストする前に呼び出すことをおすすめします。

using GoogleMobileAds.Mediation.LiftoffMonetize.Api;
// ...

LiftoffMonetize.SetCCPAStatus(true);

詳細とこのメソッドで提供できる値については、CCPA で推奨される実装手順をご覧ください。

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

Android

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

iOS

SKAdNetwork との統合

Liftoff Monetize のドキュメントに沿って、SKAdNetwork 識別子をプロジェクトの Info.plist ファイルに追加します。

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

テスト広告を有効にする

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

テスト広告を確認する

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

エラーコード

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

iOS

形式 クラス名
バナー GADMAdapterVungleInterstitial
インタースティシャル GADMAdapterVungleInterstitial
特典 GADMAdapterVungleRewardBasedVideoAd

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

iOS

エラーコード 理由
1-100 Vungle SDK からエラーが返されました。詳しくは、コードをご覧ください。
101 管理画面で設定されている Liftoff Monetize サーバー パラメータが見つからないか、無効です。 AdMob
102 このネットワーク設定の広告はすでに読み込まれています。Vungle SDK は、同じプレースメント ID の 2 つ目の広告を読み込むことができません。
103 リクエストされた広告サイズが、Liftoff Monetize でサポートされているバナーサイズと一致しません。
104 Vungle SDK はバナー広告をレンダリングできませんでした。
105 Vungle SDK では、プレースメント ID に関係なく、一度に 1 つのバナー広告のみを読み込むことができます。
106 Vungle SDK が、広告が再生できないことを示すコールバックを送信しました。

Liftoff Monetize Unity メディエーション プラグインの変更履歴

バージョン 5.1.0

  • Android プロジェクトとしてエクスポートするときにビルドが失敗する原因となっていた NullPointerException を修正しました。
  • Privacy API を更新しました。
    • UpdateConsentStatus() メソッドと UpdateCCPAStatus() メソッドを削除しました。
    • VungleConsentStatus 列挙型と VungleCCPAStatus 列挙型を削除しました。
    • SetGDPRStatus(bool) メソッドを SetGDPRStatus(bool, String) に更新しました。
  • LiftoffMonetizeMediationExtras クラスから次のメソッドを削除しました。
    • SetAllPlacements(String[])
    • SetSoundEnabled(bool)
  • Liftoff Monetize Android アダプタ バージョン 7.3.1.0 をサポートします。
  • Liftoff Monetize iOS アダプタ バージョン 7.3.1.0 に対応しています。
  • Google Mobile Ads Unity プラグイン バージョン 9.1.0 でビルドおよびテストされています。

バージョン 5.0.0

バージョン 4.0.0

  • Unity メディエーション プラグインの名称を Vungle から Liftoff Monetize に変更しました。
  • アダプターのコンテンツを GoogleMobileAds/Mediation/LiftoffMonetize/ に移動しました。
  • GoogleMobileAds.Mediation.LiftoffMonetize を使用するようにアダプターの名前空間をリファクタリングしました。
  • LiftoffMonetize クラスに次のメソッドを追加しました。
    • SetGDPRStatus(bool)
    • SetGDPRMessageVersion(String)
    • SetCCPAStatus(bool)
  • Liftoff Monetize Android アダプタ バージョン 6.12.1.1 をサポートします。
  • Liftoff Monetize iOS アダプタ バージョン 7.0.1.0 に対応しています。
  • Google Mobile Ads Unity プラグイン バージョン 8.4.1 でビルドおよびテストされています。

バージョン 3.9.2

バージョン 3.9.1

バージョン 3.9.0

バージョン 3.8.2

バージョン 3.8.1

バージョン 3.8.0

バージョン 3.7.5

バージョン 3.7.4

バージョン 3.7.3

バージョン 3.7.2

バージョン 3.7.1

バージョン 3.7.0

バージョン 3.6.0

バージョン 3.5.1

バージョン 3.5.0

バージョン 3.4.1

バージョン 3.4.0

バージョン 3.3.1

バージョン 3.3.0

バージョン 3.2.0

バージョン 3.1.4

  • Android アダプター バージョン 6.3.24.1 をサポートします。
  • iOS アダプタ バージョン 6.3.2.3 をサポート。

バージョン 3.1.3

  • Android アダプター バージョン 6.3.24.1 をサポートします。
  • iOS アダプタ バージョン 6.3.2.2 をサポート。

バージョン 3.1.2

  • 新しいオープンベータ版リワード API をサポートするようにプラグインを更新しました。
  • Android アダプター バージョン 6.3.24.1 をサポートします。
  • iOS アダプタ バージョン 6.3.2.1 をサポートします。

バージョン 3.1.1

  • Android アダプター バージョン 6.3.24.0 をサポートします。
  • iOS アダプタ バージョン 6.3.2.0 をサポートします。
  • Vungle.UpdateConsentStatus() メソッドを更新し、consentMessageVersion パラメータをオプションにしました。iOS で consentMessageVersion の値が無視されるようになりました。
  • iOS 向けの Vungle.GetCurrentConsentMessageVersion() のサポートが終了しました。

バージョン 3.1.0

  • Android アダプター バージョン 6.3.17.0 をサポートします。
  • iOS アダプタ バージョン 6.3.0.0 をサポートします。
  • パブリッシャー提供の同意メッセージ バージョン用に追加の String パラメータを受け取るように Vungle.UpdateConsentStatus() メソッドを更新しました。
  • パブリッシャー提供の同意メッセージのバージョンを取得する Vungle.GetCurrentConsentMessageVersion() メソッドを追加しました。

バージョン 3.0.1

  • Android アダプター バージョン 6.2.5.1 をサポートします。
  • iOS アダプタ バージョン 6.2.0.3 をサポート。

バージョン 3.0.0

  • Android アダプター バージョン 6.2.5.0 をサポートします。
  • iOS アダプタ バージョン 6.2.0.2 をサポート。
  • 以下のメソッドを追加しました。
    • Vungle.UpdateConsentStatus() メソッドを使用して、Vungle SDK に記録される同意ステータスを設定します。
    • Vungle.GetCurrentConsentStatus() メソッドを使用して、ユーザーの現在の同意ステータスを取得します。

バージョン 2.0.0

  • Android アダプター バージョン 5.3.2.1 をサポートします。
  • iOS アダプタ バージョン 6.2.0.0 をサポートします。

バージョン 1.1.0

  • Android アダプター バージョン 5.3.2.1 をサポートします。
  • iOS アダプタ バージョン 5.4.0.0 をサポートします。

バージョン 1.0.0

  • 初回リリース
  • Android アダプター バージョン 5.3.0.0 をサポートします。
  • iOS アダプタ バージョン 5.3.0.0 をサポートします。