Liftoff Monetize 実装ガイド

このガイドでは、Unity LevelPlay で Liftoff Monetize（旧 Vungle ）をアドネットワークとして配信するための設定方法を説明します。Liftoff Monetize を使用するには、Vungle SDK が必要になります。

ステップ 1. Liftoff Monetize アカウントを作成する

1. Liftoff Monetize のウェブサイトでアカウントを作成します。
2. アカウントが認証されると、こちらからログインできるようになります。

ステップ 2. Liftoff Monetize でアプリケーションを作成する

ログインしたら、左上隅の「 Applications 」タブに移動し、「 Add Application 」をクリックします：

ステップ 3. プレースメントを追加する

アプリケーションリストから関連するアプリをクリックし、該当するアプリのページで「 Add Placement 」をクリックします：

次に、Liftoff プレースメントを作成するために必要な詳細を入力、「 Continue 」をクリックし、「 Sounds Good 」ボタンをクリックします：

バナープレースメント
バナー広告のプレースメントを作成するときは、「 Ad Refresh 」オプションを無効にすることをお勧めします。リフレッシュレートは、後に Unity LevelPlay 上で設定可能です。

ステップ 4. LevelPlay ネットワークモジュールで Liftoff Monetize をアクティベートする

Liftoff が LevelPlay と接続して正しく動作するためには、Liftoff アカウントから 4 つのデータを LevelPlay 「 SDK Networks 」モジュールに入力する必要があります：

これらの情報を取得したら、LevelPlay で Liftoff のパラメータを設定する必要があります。上記のパラメータを正しく追加すると、Liftoff の広告在庫と Unity LevelPlay メディエーションのレポートデータを最大限に活用できるようになります。

1. Reporting API Key

   画面の右上隅にある「 My Account 」に移動すると、レポート API キーが表示されます：
   

2. Liftoff Monetize Application ID

   左側のメニューの「 Applications 」タブに移動し、LevelPlay ダッシュボードで設定するアプリケーションをクリックすると、Liftoff App ID が表示されます：
   

3. Reporting API ID

   同様に、左側のメニューの「 Applications 」タブに移動し、LevelPlay ダッシュボードで設定するアプリケーションをクリックすると、Reporting API ID が表示されます：
   

4. Placement Reference ID

   左側のメニューの「 Placements 」タブに移動し、LevelPlay ダッシュボードで設定したいアプリケーションのプレースメントを選択します：
   

Liftoff Monetize を LevelPlay 上でアクティベートする

全ての必要なパラメータを取得したら、LevelPlay にログインします。

• Monetize ➣ Setup ➣ SDK Networks へ移動します：
  
• 「 Available Networks 」の表から Liftoff を選択し、 Liftoff の「 Reporting API Key 」を入力します。この入力は初回のみ必要です：
  
• 自動セットアップ機能を有効にするには、Liftoff Monetize 自動セットアップツールをオンに切り替え、Secret Token を入力します。これにより、Liftoff Monetize プラットフォーム上でアプリケーションと Bidder プレースメントを自動的に作成し、LevelPlay が Liftoff からプレースメントの詳細を取得できるようになります。
• 「 Save 」をクリックすると、 Liftoff は「 Available Networks 」テーブルで有効になります：

ステップ 5. アプリレベルでLiftoffマネタイズを設定する

Non-bidder ウォーターフォール設定

• SDK Networks ページの左側のリストから実装したいアプリを選択します。
• Liftoff の「 Setup 」ボタンをクリックし、関連する広告ユニット設定で「 Reporting API Key 」、「 App ID 」、「 Reporting API ID 」、「 Placement Reference ID 」を入力します。
• 「保存」をクリックすると、ダッシュボードに、Liftoff Monetize がアクティブであることが表示されます。

Bidder 設定

LevelPlay で Liftoff Monetize Bidder を設定するには 2 つの方法があります：

1. 自動セットアップ – 新しいアプリケーションと bidder プレースメントが自動的に作成され、必要なすべての設定情報が Liftoff Monetize から取得されます。
2. 手動 – LevelPlay プラットフォームと Liftoff Monetize プラットフォームの両方の管理画面を行き来して必要な情報を取得し、入力します。

自動セットアップ

• Liftoff Monetize からのインタースティシャル、動画リワード、またはバナーを配信するアプリを選択します。次に、Liftoff Monetize 行の「 Setup 」ボタンまたは「編集」アイコンをクリックします。
• 「 Add bidder 」 ボタンをクリックすると、Liftoff Monetize プラットフォーム上に新しいアプリと Bidding プレースメントが自動的に作成され、関連する情報がインポートされます。
  
• 「 Save 」をクリックしてすべての設定を承認します。保存せずにモジュールを閉じると、アセットは Liftoff Monetize プラットフォーム上に作成されますが、データは LevelPlay プラットフォームにインポートされません。

手動セットアップ

• Liftoff Monetize からのインタースティシャル、動画リワード、またはバナーを配信するアプリを選択します。
• Liftoff Monetize 行の「 Setup 」ボタンまたは「編集」アイコンをクリックし、関連する広告ユニット設定で「 Reporting API Key 」、「 App ID 」、「 Reporting API ID 」、「 Placement Reference ID 」を入力します。
• 「 Save 」をクリックします。

これで、アカウント内で選択した広告ユニットに対して Liftoff Monetize が有効になっていることが確認できます。

ステップ 5. Vungle アダプターをビルドに追加する

Unity Network Manager（推奨）

SDK の実装が完了すると、Unity Network Manager を使用して InMobi アダプターをダウンロードできます。

Unity 開発プラットフォームで、Ads Mediation > Network Manager へ移動します。

すでに最新バージョンのアダプターが実装されている場合は、アクションボタンが「 Updated 」に変更され、無効になります。

Android (Manual Resolve)

変更を適用するには、必ず「 Resolve 」プロセスを使用してください。これにより、選択されたネットワークに関連するすべてのアーティファクトがダウンロードされます。詳細については、こちらの手順を参照してください。

Proguard ユーザーのみ (Android)

Vungle アダプターで ProGuard を使用している場合は、次のコードを ProGuard 設定ファイルに追加する必要があります：

# Vungle
-keep class com.vungle.warren.** { *; }
-dontwarn com.vungle.warren.error.VungleError$ErrorCode
# Moat SDK
-keep class com.moat.** { *; }
-dontwarn com.moat.**
# Okio
-dontwarn org.codehaus.mojo.animal_sniffer.IgnoreJRERequirement
# Retrofit
-dontwarn okio.**
-dontwarn retrofit2.Platform$Java8
# Gson
-keepattributes Signature
-keepattributes *Annotation*
-dontwarn sun.misc.**
-keep class com.google.gson.examples.android.model.** { *; }
-keep class * implements com.google.gson.TypeAdapterFactory
-keep class * implements com.google.gson.JsonSerializer
-keep class * implements com.google.gson.JsonDeserializer
# Google Android Advertising ID
-keep class com.google.android.gms.internal.** { *; }
-dontwarn com.google.android.gms.ads.identifier.**

Android プラグイン手動実装

1. Vungle Android アダプターをダウンロード：
   こちらからアダプターと InMobi SDK をダウンロードします。
2. Vungle ファイルを Unity プロジェクトに追加：
   アダプターファイルを Assets/Plugins/Android にインポートします。
3. 依存関係を追加：
   

   implementation 'com.ironsource.adapters:inmobiadapter:4.3.28' 
   implementation 'com.inmobi.monetization:inmobi-ads-kotlin:10.8.0' 
   

4. Vungle サードパーティの jar をダウンロード：
   こちらからファイルをダウンロードし、プロジェクトのAssets/Plugins/Android/libs に jar を追加します。

iOS プラグイン手動実装

1. Vungle iOS アダプターと SDK をダウンロード：
   こちらから アダプターと SDK (XCFrameworks) をダウンロードします。
2. Vungle アダプターファイルを Unity プロジェクトに追加：
   ファイルを Assets/Plugins/iOS にインポートします。
3. SDK を Xcode プロジェクトに追加：
   Unity3D は XCFrameworks をサポートしていないため、SDK の XCFrameworks を Xcode プロジェクトに直接追加してください。

ステップ 6. Liftoff の追加設定

COPPA ユーザーステータス

この機能は、ironSource SDK 7.1.12 以降、Vungle Unity アダプター 4.3.25 以降を使用する Android アプリ、および ironSource SDK 7.2.1 以降、Vungle Unity アダプター 4.3.27 以降を使用する iOS アプリで有効になります。 Vungle COPPA API の詳細については、こちらをご覧ください。

次の構文を使用して、Vungle の COPPA ユーザーステータスを「 true 」に設定します：

 IronSource.Agent.setMetaData("Vungle_coppa","true");

次の構文を使用して、Vungle の COPPA ユーザーステータスを「 false 」に設定します：

 IronSource.Agent.setMetaData("Vungle_coppa","false");

完了！
これで、アプリで Liftoff Monetize 広告を配信する準備が整いました。