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

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

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

統合
単価設定 1
滝
フォーマット
アプリの起動 2
バナー
インタースティシャル
特典
リワード インタースティシャル

1 入札の統合はオープンベータ版です。

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

要件

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

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

Liftoff に登録またはログインする アカウントを収益化します。

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

フォームに必要事項をすべて入力します。

Android

iOS

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

Android

iOS

アプリ ID をメモします。

Android

iOS

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

AdMob で使用する新しいプレースメントを作成するため 詳細ページの Liftoff Monetize Placements ダッシュボード [Add Placement] ボタンをクリックして、プルダウンからアプリを選択します。 選択します。

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

アプリの起動

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

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

300x250 バナー

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

インタースティシャル

[インタースティシャル] を選択し、プレースメント名を入力して、残りを入力します。 表示されます。[入札のみ] [収益化] で、 [アプリ内入札] を [有効] に切り替えます。[続行] ボタンをクリックします。 プレースメントを作成します

特典

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

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

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

ネイティブ

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

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

アプリの起動

300×250 のバナー

インタースティシャル

特典

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

ネイティブ

Reporting API キーを確認する

単価設定

入札の統合では不要です。

滝

アプリ ID と参照 ID に加えて、次の情報も必要です。 Liftoff Monetize Reporting API Key にアクセスし、 AdMob 広告ユニット ID。[ Liftoff Monetize Reports ダッシュボード Reporting API キー ボタンをクリックして、Reporting API を表示します Key です。

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

テスト広告を有効にするには、Liftoff Monetize のダッシュボードにアクセスして、 アプリ。

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

Android

iOS

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

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

Android

手順については、 Android。

iOS

手順については、 iOS。

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

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

変更ログのダウンロード リンクから、Liftoff Monetize 向けの Google Mobile Ads メディエーション プラグインの最新バージョンをダウンロードし、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 Mobile Ads メディエーション プラグインには、同意情報を 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:

Android

形式 クラス名
アプリ起動（入札） com.google.ads.mediation.vungle.VungleMediationAdapter
アプリ起動（ウォーターフォール） com.google.ads.mediation.vungle.VungleMediationAdapter
バナー（入札） com.google.ads.mediation.vungle.VungleMediationAdapter
バナー（ウォーターフォール） com.vungle.mediation.VungleInterstitialAdapter
インタースティシャル（入札） com.google.ads.mediation.vungle.VungleMediationAdapter
インタースティシャル（ウォーターフォール） com.vungle.mediation.VungleInterstitialAdapter
リワード（入札） com.google.ads.mediation.vungle.VungleMediationAdapter
リワード（ウォーターフォール） com.vungle.mediation.VungleAdapter
リワード インタースティシャル（入札） com.google.ads.mediation.vungle.VungleMediationAdapter
リワード インタースティシャル（ウォーターフォール） com.google.ads.mediation.vungle.VungleMediationAdapter

iOS

形式 クラス名
アプリ起動（入札） GADMediationAdapterVungle
アプリ起動（ウォーターフォール） GADMediationAdapterVungle
バナー（入札） GADMediationAdapterVungle
バナー（ウォーターフォール） GADMAdapterVungleInterstitial
インタースティシャル（入札） GADMediationAdapterVungle
インタースティシャル（ウォーターフォール） GADMAdapterVungleInterstitial
リワード（入札） GADMediationAdapterVungle
リワード（ウォーターフォール） GADMAdapterVungleRewardBasedVideoAd
リワード インタースティシャル（入札） GADMediationAdapterVungle
リワード インタースティシャル（ウォーターフォール） GADMediationAdapterVungle

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

Android

エラーコード 理由
101 サーバー パラメータが無効です（アプリ ID、プレースメント ID など）。
102 リクエストされたバナーサイズが有効な Liftoff Monetize 広告にマッピングされていません 指定します。
103 Liftoff Monetize で広告をリクエストするには、Activity コンテキストが必要です。
104 Vungle SDK では同じプレースメントの複数の広告を読み込めません あります。
105 Vungle SDK を初期化できませんでした。
106 Vungle SDK は読み込み成功コールバックを返しましたが、Banners.getBanner() または Vungle.getNativeAd() が null を返しました。
107 Vungle SDK では広告を再生する準備ができていません。
108 Vungle SDK から無効な入札トークンが返されました。

iOS

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

Vungle SDK に起因するエラーについては、エラーコード: Vungle SDK for iOS and Android をご覧ください。

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

バージョン 5.2.1

バージョン 5.2.0

バージョン 5.1.1

バージョン 5.1.0

  • Android プロジェクトとしてエクスポートする際にビルドが失敗する NullPointerException を修正しました。
  • プライバシー 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

  • 新しいオープンベータ版の Rewarded 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 をサポートします。