# Liftoff Monetizeインテグレーション

> アカウントの作成、アプリケーションの追加、プレースメントの設定を行うことにより、Unity LevelPlay に Liftoff Monetize を広告ネットワークとして統合します。

> **Important:**
>
> 以下のドキュメントでは、Unity が開発、所有、または運用するものではない製品またはサービス ("サードパーティ製品") を取り上げます。
> その情報は、古かったり、不完全であったりする可能性がありますが、利便性のために提供しています。
> サードパーティ製品を使用する際は、その製品の規約に従うものとします。
> Unity はそれらの製品に関して一切保証を行わず、その使用によって生じた損害や損失 (サードパーティプロバイダーのコンテンツ、広告、製品、資料に関する問題を含む) について責任を負いません。

このガイドでは、Unity LevelPlayでLiftoff Monetize(旧称Vungle)を広告ネットワークとして稼働させる方法をステップごとに説明します。Liftoff Monetizeを使用するには、[Vungle SDK](https://liftoff.io/monetize/vungle-sdk/)をインストールする必要があります。

> **Note:**
>
> Vungle iOS SDK v.6.8.0 以降 (Vungle アダプター 4.3.7 以降) は Xcode 12 以降をサポートします。Xcode 11 以下のビルドはサポートされていません。

> **Note:**
>
> このメディエーション ネットワークのアダプタ変更ログを表示するには、[Unity 向けメディエーション ネットワーク](/grow/levelplay/sdk/unity/mediation-networks.md.md#integrate-network-adapters) を参照してください。

## 前提条件##prerequisites

リワード広告、インタースティシャル広告、またはバナー広告をアプリケーションに正しく統合していることを確認します。インテグレーション手順については、以下のプラットフォーム固有のガイドを参照してください。

**Rewarded ads integration:**

* [Unity](/grow/levelplay/sdk/unity/rewarded-ad-integration-package.md.md)
* [Android](/grow/levelplay/sdk/android/rewarded-ads-integration.md.md)
* [iOS](/grow/levelplay/sdk/ios/rewarded-ads-integration.md.md)
* [Adobe Air](/grow/levelplay/sdk/adobe/rewarded-ads-integration.md.md)
* [フラッター](/grow/levelplay/sdk/flutter/rewarded-ads-integration.md.md)
* [リアクトネイティブ](/grow/levelplay/sdk/react/rewarded-ads-integration.md.md)

**Interstitial integration:**

* [Unity](/grow/levelplay/sdk/unity/interstitial-integration.md.md)
* [Android](/grow/levelplay/sdk/android/interstitial-integration.md.md)
* [iOS](/grow/levelplay/sdk/ios/interstitial-integration.md.md)
* [Adobe Air](/grow/levelplay/sdk/adobe/interstitial-integration.md.md)
* [フラッター](/grow/levelplay/sdk/flutter/interstitial-integration.md.md)
* [React ネイティブ](/grow/levelplay/sdk/react/interstitial-integration.md.md)

**Banner integration:**

* [Unity](/grow/levelplay/sdk/unity/banner-integration.md.md)
* [Android](/grow/levelplay/sdk/android/banner-integration.md.md)
* [iOS](/grow/levelplay/sdk/ios/banner-integration.md.md)
* [Adobe Air](/grow/levelplay/sdk/adobe/banner-integration.md.md)
* [フラッター](/grow/levelplay/sdk/flutter/banner-integration.md.md)
* [React ネイティブ](/grow/levelplay/sdk/react/banner-integration.md.md)

## ステップ 1. Liftoff Monetizeアカウントの作成

1. Liftoff Monetizeでアカウントを作成します。You can do so [here (ここ](https://app.vungle.com/signup/)で実行できます)
2. アカウントの確認後、パートナー ログインでログインできます。[こちら](https://app.vungle.com/login/)から

## ステップ 2. Liftoff Monetize でのアプリケーションの作成

ログインしたら、左上隅にある左側のメニュードロップダウンの **Applications** (アプリケーション) タブに移動し、**Add application** (アプリケーションの追加) を選択します。

## ステップ 3.  配置の追加

アプリケーションリストから関連するアプリケーションを選択します。アプリケーションの専用ページで、**配置の追加**を選択します。

次に、リフトオフ配置を作成するために必要な詳細を入力し、**Continue、\*\*\*\*Sounds Good**を選択します。

**バナー配置** バナー広告配置を作成するときは、「広告の更新」オプションを無効にすることを推奨します。後で Unity LevelPlay でリフレッシュレートをコントロールできます。

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

Liftoff を LevelPlay と正しく連動させるためには、LevelPlay ネットワーク設定モジュールに Liftoff アカウントの 4 つのデータを挿入する必要があります。

| **Liftoff App ID**   | Liftoff のシステムにおけるアプリケーションの一意の識別子です。                                                                          |
| -------------------- | ------------------------------------------------------------------------------------------------------------ |
| **Reporting API ID** | Liftoff のシステム内のアプリケーションの一意の識別子で、アプリケーションのパフォーマンスを追跡する Reporting API で使用されます。                                 |
| **レポート API キー**      | Liftoff アカウントの一意の識別子です。Reporting API IDと一緒に、Unity LevelPlay は Liftoff Monetize アカウントからパフォーマンス データをインポートできます。 |
| **配置リファレンス ID**      | これは広告単位の一意の識別子で、リワード広告をインタースティシャル広告やバナー広告と区別するために必要です。                                                       |

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

1. ### レポート API キー

   画面の右上にある**マイアカウント**に移動すると、Reporting APIキーが表示されます。

2. ### **Liftoff MonetizeアプリケーションID**

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

3. ### レポート API ID

   左側のメニューの Applications (アプリケーション) タブに移動し、LevelPlay ダッシュボードで設定するアプリケーションを選択します。Liftoff Reporting API ID が表示されます。

4. ### **配置リファレンス ID**

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

### **Unity LevelPlay で Liftoff Monetize をアクティベート**

必要なパラメータをすべて収集したら、LevelPlay アカウントにログインします。

* **Monetize** > **設定**> **SDK Networks** の順に移動します。
* 使用可能なAd NetworkのリストからLiftoffを選択し、Liftoffの「Reporting APIキー」を入力します。このステップは 1 回だけ必要です。
* 自動設定特徴をアクティベートするには、Liftoff Monetize自動設定ツールをオンにトグルします。これにより、Riftoff Monetizeプラットフォームでアプリケーションと入札者の配置を自動的に作成し、自動設定ツールに切り替えてRiftoff Monetizeプラットフォームの概要ページにあるシークレット トークンを入力した後、LevelPlayがLiftoff Monetizeから配置の詳細を取得できるようになります。次に、Save (保存) を選択します。
* **Save** (保存) を選択します。 Liftoff は **Available Networks** テーブルで有効になります。

## 5.Liftoff Monetizeをアプリケーション レベルで設定

### 従来のウォーターフォール設定

* SDK Networks ページの左側のリストから統合するアプリケーションを選択します。
* 広告単位の行で、設定をクリックし、 、Reporting API キー、App ID、Reporting API ID を入力します。次に、関連する広告単位設定の下に、配置リファレンスIDを追加します。
* **Save** (保存) を選択します。設定 (設定) ダッシュボードに Liftoff Monetize (リフトオフ収益化) が Active for Mediation (メディエーションに対してアクティブ) と表示されます。

### **入札設定**

LevelPlay で Liftoff Monetize 入札者を設定するには 2 つの方法があります。

1. **自動設定** – Liftoff Monetize ダッシュボードに新しいアプリケーションとプレースメントを自動的に作成し、LevelPlay で必要なすべての設定に自動入力
2. **手動** – LevelPlayおよびLiftoff Monetizeプラットフォームで必要なアプリケーションの詳細を手動で入力

**Auto-setup**

* Unity Ads からインタースティシャル広告、リワード広告、バナー広告を実行するアプリケーションを選択します。次に、Liftoff 行の定義アイコンを選択します。
* **Add bids(入札**者の追加)を選択すると、Liftoff Monetizeプラットフォームに新しいアプリケーションと入札プレースメントが自動的に作成され、関連情報がLevelPlayにインポートされます。
* **Save (保存**) を選択して、すべての設定を承認および承認します。保存せずにモジュールを閉じると、データを LevelPlay プラットフォームにインポートせずに Liftoff Monetize プラットフォームにアセットが作成されます。

> **Note:**
>
> Liftoff Monetiz 入札者インスタンスの状態は、広告単位では ironsource Ads 入札者の状態と同じです。例えば、リワード広告にIronsource Adsの入札者を使用していない場合、Liftoff Monetizeネットワークでは自動的にアクティブ化されません。リワード広告の Liftoff Monetize (収益化の解除) 入札インスタンスをアクティベートするには、Liftoff Monetize (収益化の解除) 行を選択し、広告単位をオンにトグルます。

**手動での設定**

* Liftoff Monetizeからバナー広告、インタースティシャル広告、リワード広告を実行するアプリケーションを選択します。

* Ad Networks の設定リストから Liftoff を選択し、定義アイコンを選択し、**Reporting API キー**、**App ID**、**Reporting API** **ID を入力します。次に**、関連する広告単位の設定の下に、**配置リファレンスID**を追加します

* **［Save］** をクリックします。

これで、アカウント内で選択した広告ユニットに対してLifotffがアクティブになりました。

## ステップ 6.Vungle Adapter をビルドに追加する##step-6.-add-the-vungle-adapter-to-your-build

Liftoff Monetizeを使用するには、[ここ](https://liftoff.io/monetize/vungle-sdk/)でVungle SDKをインストールする必要があります。

### Unity ネットワーク マネージャ（推奨）##unity-network-manager-(recommended)

SDK インテグレーションを完了したら、Unity ネットワークマネージャーを使用して Vungle Adapter をダウンロードできます。

Unity Development プラットプラットフォームで、Ads Mediation > ネットワーク Manager に移動します。

すでに最新バージョンのアダプタがある場合は、**アクション** ボタンが「Updated」に変わり、無効になります。

### Android (手動解決)##android-(manual-resolve)

変更を適用するには、必ず「解決」プロセスを使用してください。これにより、選択に応じて関連するアーティファクトがすべてダウンロードされます。詳細については、[こちら](/grow/levelplay/sdk/unity/package-integration.md)の手順を参照してください。 

#### ProGuard ユーザーのみ (Android)##for-proguard-users-only-(android)

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

```text
# Vungle##vungle
-keep class com.vungle.warren.** { *; }
-dontwarn com.vungle.warren.error.VungleError$ErrorCode
# Moat SDK##moat-sdk
-keep class com.moat.** { *; }
-dontwarn com.moat.**
# Okio##okio
-dontwarn org.codehaus.mojo.animal_sniffer.IgnoreJRERequirement
# Retrofit##retrofit
-dontwarn okio**
-dontwarn retrofit2.Platform$Java8
# Gson##gson
-keepattributes シグネチャ
-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##google-android-advertising-id
-keep class com.google.android.gms.internal.** { *; }
-dontwarn com.google.android.gms.ads.identifier.**
```

#### Android プラグイン手動インテグレーション##android-plugin-manual-integration

1. Vungle Androidアダプターのダウンロード

   アダプタと SDK(AAR)は[ここ](/grow/levelplay/sdk/android/mediation-networks.md)からダウンロードしてください。

2. Vungle ファイルをプロジェクトに追加する

   ファイルを `Assets/Plugins/Android/` にインポートします。

3. Vungleサードパーティのjarをダウンロード

   [ここ](https://developers.is.com/wp-content/uploads/2019/10/Vungle_libs_6411.zip)からファイルをダウンロードします。jar ファイルをプロジェクトに **Assets/Plugins/Android/libs** の下に追加します。

#### iOS プラグイン手動インテグレーション##ios-plugin-manual-integration

1. **Vungle iOS アダプタをダウンロードします。**[iOS のメディエーションネット](/grow/levelplay/sdk/ios/mediation-networks.md)ワーク を参照してください。
2. \*\*Vungle アダプターファイルを Unity プロジェクトに追加します。\*\*アダプタとフレームワークファイルを **Assets/Plugins/iOS** にインポート
3. \*\*Xcode プロジェクトに SDK を追加します。\*\*Unity3DはXCFrameworksをサポートしていないため、SDK XCFrameworksをXcodeプロジェクトに直接追加します。

**広告ネットワークインテグレーションの評価**

* [インテグレーションヘルパー](/grow/levelplay/sdk/unity/integration-helper.md)を使用して広告ネットワークのインテグレーションを確認します。LevelPlay SDK は、SDK と追加のネットワークアダプタを正常に統合するためのツールを提供します。
* このブーリアンを使用して統合メディエーション広告ネットワークのデバッグを管理する

  ```text
  LevelPlay.SetAdaptersDebug(true);
  ```

  **true**に設定すると、このコード行でデバッグログが有効になり、それが許可されているすべてのメディエーション広告ネットワークに関する問題のトラブルシューティングに役立ちます。 アプリケーションを広告ユニットで稼働させる前に、このコードを削除してください。SDK バージョン 6.5.2 以降でサポートされます。

## ステップ 7.Liftoff の追加設定##step-7.-liftoff-additional-settings

### COPPAユーザー状態##coppa-user-status

Unity LevelPlay を使用すると、パブリッシャーは Vungle COPPA 設定を ネットワークワークに直接通信できます。この機能は、LevelPlay SDK 7.1.12 以降、Vungle Android Unity 4.3.24 以降を使用する **Android** アプリケーション、および LevelPlay SDK 7.2.1 以降、Vungle Android Unity 4.3.27 以降を使用する **iOS** アプリケーションで使用できます。Vungle COPPA APIの詳細については、[こちら](https://support.vungle.com/hc/en-us/articles/360047780372#coppa-api-0-8)を参照してください。

以下の構文を使用して、VungleのCOPPAユーザー状態をパラメーター「true」で更新します。

```cs
LevelPlay.SetMetaData("Vungle_coppa","true");
```

以下の構文を使用して、パラメーター「false」でVungleのCOPPAユーザー状態を更新します。

```cs
LevelPlay.SetMetaData("Vungle_coppa","false");
```

Liftoff Monetize Adsをアプリケーション内で配信できるようになりました。

## 次のステップ##next-steps

Unity LevelPlay Mediation を通じて追加の広告ネットワークを活用するには、アダプタを組み込み、インテグレーションガイドに従ってください。

**Platform adapters:**

* [Unity](/grow/levelplay/sdk/unity/mediation-networks.md)
* [Android](/grow/levelplay/sdk/android/mediation-networks.md)
* [iOS](/grow/levelplay/sdk/ios/mediation-networks.md)
* [Adobe AIR](/grow/levelplay/sdk/adobe/mediation-networks.md)
* [Flutter](/grow/levelplay/sdk/flutter/mediation-networks.md)
* [React ネイティブ](/grow/levelplay/sdk/react/mediation-networks.md)
