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

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

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

バナー インタースティシャル 特典 リワード インタースティシャル 2

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

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

要件

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

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

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

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

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

Android

iOS

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

Android

iOS

アプリ ID をメモします。

Android

iOS

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

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

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

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

300×250 のバナー

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

インタースティシャル

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

特典

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

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

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

ネイティブ

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

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

300×250 のバナー

インタースティシャル

特典

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

ネイティブ

Reporting API キーを確認する

入札

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

ウォーターフォール

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

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

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

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

Android

iOS

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

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

Android

手順については、 Android。

iOS

手順については、 iOS。

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

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

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

Liftoff 向け Google モバイル広告メディエーション プラグインの最新バージョンをダウンロード [変更履歴] をクリックして、 ZIP ファイル内の GoogleMobileAdsVungleMediation.unitypackage。

Unity プロジェクト エディタで、[Assets] >パッケージをインポート > Custom Package を開き、GoogleMobileAdsVungleMediation.unitypackage ファイルを見つけます。 表示されます。すべてのファイルのチェックボックスがオンになっていることを確認して、[Import]（インポート）をクリックします。

次に、[アセット >Play 開発者サービス リゾルバ >Android リゾルバ > Force Resolve。Unity Play Services Resolver ライブラリは、 最初から依存関係を解決し、宣言された依存関係を Unity アプリの Assets/Plugins/Android ディレクトリ。

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

Google の EU ユーザーの同意 ポリシーに基づき、特定の情報開示が必ず行われるようにし、 欧州経済領域（EEA）のユーザーから、 デバイス ID と個人データの使用。このポリシーは、 EU の e プライバシー指令と一般データ保護規則の要件 規則（GDPR）。同意を求める場合は、各広告ネットワークを特定する必要がある 個人データを収集、受信、または使用する可能性がある 各ネットワークの使用状況に関する情報が表示されます。現在のところ、Google は ユーザーの同意に関する選択をこうしたネットワークに自動的に渡す。

Liftoff Monetize の Google モバイル広告メディエーション プラグインには、以下のメソッドが含まれています。 同意情報を Vungle SDK に渡します。次のサンプルコードは、 同意情報を Vungle SDK に渡します。このように メソッドを使って広告をリクエストする前に、 Google Mobile Ads SDK

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

LiftoffMonetize.SetGDPRStatus(true, "v1.0.0");
#if UNITY_IPHONE
LiftoffMonetize.SetGDPRMessageVersion("v1.0.0");
#endif

GDPR で推奨される実装手順を確認: Android、iOS: 詳細 メソッドで提供できる値を確認できます。

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

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

Liftoff Monetize の Google モバイル広告メディエーション プラグインには、以下のメソッドが含まれています。 同意情報を Vungle SDK に渡します。次のサンプルコードは、 同意情報を Vungle SDK に渡します。このように メソッドを使って広告をリクエストする前に、 Google Mobile Ads SDK

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

LiftoffMonetize.SetCCPAStatus(true);

CCPA で推奨される実装手順をご覧ください Android または iOS の詳細 メソッドで指定できる値。

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

Android

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

iOS

SKAdNetwork との統合

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

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

テスト広告を有効にする

Ad Manager にテストデバイスを登録し、 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 のサーバー パラメータがないか、無効です。 Ad Manager
102 このネットワーク設定の広告はすでに読み込まれています。Vungle SDK で同じプレースメント ID に 2 つ目の広告を読み込むことはできません。
103 リクエストされた広告サイズが、Liftoff Monetize でサポートされているバナーサイズと一致しません。
104 Vungle SDK がバナー広告をレンダリングできませんでした。
105 Vungle SDK では、プレースメント ID に関係なく、一度に 1 つのバナー広告しか読み込めません。
106 Vungle SDK から、広告が再生できないことを示すコールバックが送信されました。

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

バージョン 5.2.0

バージョン 5.1.1

バージョン 5.1.0

  • Android プロジェクトとしてエクスポートするときにビルドエラーが発生する NullPointerException を修正しました。
  • プライバシー API を更新しました。 <ph type="x-smartling-placeholder">
      </ph>
    • UpdateConsentStatus() メソッドと UpdateCCPAStatus() メソッドを削除しました。
    • VungleConsentStatus 列挙型と VungleCCPAStatus 列挙型を削除しました。
    • SetGDPRStatus(bool) メソッドを SetGDPRStatus(bool, String) に更新しました。
  • LiftoffMonetizeMediationExtras クラスから次のメソッドを削除しました。 <ph type="x-smartling-placeholder">
      </ph>
    • SetAllPlacements(String[])
    • SetSoundEnabled(bool)
  • Liftoff Monetize Android アダプター バージョン 7.3.1.0 をサポートしています。
  • Liftoff Monetize iOS アダプター バージョン 7.3.1.0 をサポートしています。
  • Google Mobile Ads Unity Plugin バージョン 9.1.0 でビルド、テストされています。

バージョン 5.0.0

バージョン 4.0.0

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

バージョン 3.9.2

  • Vungle クラスを更新しました。 <ph type="x-smartling-placeholder">
      </ph>
    • UpdateCCPAStatus(VungleCCPAStatus) メソッドを追加しました。
    • GetCurrentConsentStatus() メソッドを削除しました。
    • GetCurrentConsentMessageVersion() メソッドを削除しました。
  • Vungle Android アダプター バージョン 6.12.1.0 をサポートします。
  • Vungle iOS アダプター バージョン 6.12.2.0 をサポートしています。
  • Google Mobile Ads Unity Plugin バージョン 7.4.1 でビルド、テストされていること。

バージョン 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 をサポートします。
  • consentMessageVersion パラメータをオプションにするように Vungle.UpdateConsentStatus() メソッドを更新しました。iOS で consentMessageVersion の値が無視されるようになりました。
  • Vungle.GetCurrentConsentMessageVersion()（iOS 版）のサポートが終了しました。

バージョン 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 をサポートします。