# 9.0.0 以降への移行

> LevelPlay Unity インテグレーションをバージョン 9.0.0 以降に移行するためのガイド。

このガイドを使用して、LevelPlay Unity パッケージインテグレーションをバージョン 9.0.0 以降に更新します。このガイドでは、3 つの一般的な移行シナリオについて説明し、古いファイルの削除、最新パッケージのインストール、およびネットワーク アダプタの復元によってクリーンな設定を実現します。

> **Important:**
>
> 開発者 Settings (LevelPlay Mediation Settings または Mediated ネットワーク Settings) を使用する場合は、更新する前に、アプリケーション、アプリケーション ID、またはカスタム選択を記録してください。バージョン 9.0.0 以降にアップグレードした後、再入力する必要があります。

この記事では、LevelPlay Unity インテグレーションをバージョン 9.0.0 以降に移行する開発者向けのガイダンスを提供します。

## 9.0.0 以降のキー変更点##key-changes-in-9.0.0+

* 新しい初期化 API とフロー
* アダプタとネットワーク要件の更新
* 古い機能 API の廃止
* その他のプライバシーとコンプライアンス機能

## 移行手順##migration-steps

1. Unity Package Manager を使用するか、最新の .unitypackage をダウンロードして、LevelPlay Unity パッケージを 9.0.0 以上に**更新**します。
2. 新しい API を使用するように**初期化コード**を更新します。詳細については、「 [Migrate to LevelPlay Init API](/grow/levelplay/sdk/unity/migrate-to-init-api.md) 」を参照してください。
3. 互換性を確保するために、すべての広告形式(リワード型、インタースティシャル、バナー)の**統合を確認および更新**します。
4. メディエーション**ネットワークアダプタ**をサポートされている最新バージョンに更新します。
5. インテグレーションテストスイートを使用して、**インテグレーションを**徹底的にテストします。

## 前提条件##prerequisites

バージョン 9.0.0 にアップデートするときに、古い機能ファイルまたはアダプターとの競合が発生する可能性を防ぐために、以下のことを行ってください。

* 既存のインテグレーションファイルを削除して、バージョンの競合を回避します。
* 更新されたコードパスのみに依存するように、新しいパッケージをインストールします。
* ネットワーク アダプタを再インストールして、バージョン 9.0.0 の API と依存関係解決と正しく統合します。

## 更新パスの選択##choose-your-update-path

| シナリオ                                           | どのような場合に使用するか                                                           |
| ---------------------------------------------- | ----------------------------------------------------------------------- |
| 現在の Unity プラグインのバージョンを Unity プラグイン 9.0.0 以上に更新 | 現在、LevelPlay に .unitypackage を使用しており、バージョン 9.0.0 以上に更新したい               |
| Ads Mediation UPM パッケージを 9.0.0 に更新する           | 現在、LevelPlay に Ads Mediation UPM パッケージを使用しており、バージョン 9.0.0 以上に更新しようとしている |
| Unity プラグインから Ads Mediation パッケージに移行する         | .unityパッケージの使用を停止し、バージョン 9.0.0 以降の Ads Mediation UPM パッケージに切り替える必要がある   |

## 現在の Unity プラグインのバージョンを 9.0.0 以上に更新##update-your-current-unity-plugin-version-to-9.0.0+

現在 LevelPlay に Unity プラグイン(.unitypackage)を使用しており、バージョン 9.0.0 以降にアップグレードする場合は、次の手順に従います。

1. サポートされて[いるエディターバージョン](https://unity.com/releases/editor/archive)を使用して、Unity エディターでプロジェクトを開きます。
2. Project ウィンドウで `Assets > LevelPlay` フォルダーを探し、LevelPlay とそのすべてのコンテンツを削除します。
3. 存在する場合は、`Assets > Mobile Dependency Resolver`を削除します。
4. [Unity プラグイン](/grow/levelplay/sdk/unity/package-integration.md)をダウンロードします。
5. .unitypackage ファイルをプロジェクトにインポートします。
6. Unity のメインメニューで Ads Mediation > ネットワーク Manager (ネットワークマネージャー) に移動します。
7. ［Install］ をクリックして、バージョン 9.0.0 以降と互換性のあるネットワーク アダプタを追加します。

## Ads Mediation UPM パッケージを 9.0.0 以上に更新する##update-the-ads-mediation-upm-package-to-9.0.0+

現在 LevelPlay 用の Ads Mediation UPM パッケージを使用しており、バージョン 9.0.0 以降にアップグレードする場合は、次の手順に従います。

1. サポートされて[いるエディターバージョン](https://unity.com/releases/editor/archive)を使用して、Unity エディターでプロジェクトを開きます。
2. Project ウィンドウで、`Assets > LevelPlay`または`Assets > IronSource`フォルダーを探し、そのフォルダーとそのすべてのコンテンツを削除します。
3. 存在する場合は、`Assets > Mobile Dependency Resolver`を削除します。
4. Window (ウィンドウ) > Package Manager (パッケージマネージャー) を開きます。
   * パッケージソースで Unity レジストリを選択します。
   * Ads Mediation を選択します。
   * 更新 をクリックします。
5. Unity のメインメニューで Ads Mediation > ネットワーク Manager (ネットワークマネージャー) に移動します。
6. ［Install］ をクリックして、バージョン 9.0.0 以降と互換性のあるネットワーク アダプタを追加します。

## Unity プラグインから Ads Mediation パッケージに移行する##migrate-from-the-unity-plugin-to-the-ads-mediation-package

現在 Unity プラグイン (.unitypackage) を使用しているが、Ads Mediation UPM パッケージ (v9.0.0 以降) に移行する場合は、次の手順に従います。

1. サポートされて[いるエディターバージョン](https://unity.com/releases/editor/archive)を使用して、Unity エディターでプロジェクトを開きます。
2. Project ウィンドウで、`Assets > LevelPlay`または`Assets > IronSource`フォルダーを探し、そのフォルダーとそのすべてのコンテンツを削除します。
3. 存在する場合は、`Assets > Mobile Dependency Resolver`を削除します。
4. Window (ウィンドウ) > Package Manager (パッケージマネージャー) を開きます。
   * Unity レジストリを選択します。
   * Ads Mediation を検索します。
   * Install (インストール) をクリックします。
5. Unity のメインメニューで Ads Mediation > ネットワーク Manager に操作するします。
6. Install をクリックして、バージョン 9.0.0 以降と互換性のあるネットワーク アダプタを追加します。

## 更新後の検証##post-update-verification

* 前に保存した開発者設定の値を再入力します。
* テストビルドを実行して、広告が正しくロードされ、欠落しているアダプタエラーが表示されないことを確認します。
* コンソール ログで非推奨の API 使用に関する警告を確認し、[v9.0.0](/grow/levelplay/sdk/unity/9-0-0-api-changes/.md) でサポートされる API を使用して置き換えます。

## 移行に関する一般的な問題のトラブルシューティング##troubleshooting-common-migration-issues

| 問題                        | 考えられる原因                     | 修正案                                                                                              |
| ------------------------- | --------------------------- | ------------------------------------------------------------------------------------------------ |
| ネットワークアダプタがない、または表示されない   | アダプタのインストールがスキップされたか、失敗しました | Ads Mediation > ネットワーク マネージャの順に選択し、再度 Install (インストール) を選択します。インストーラーログを確認します。                   |
| 複製または競合するファイル             | 古いパッケージ/SDKファイルが完全に削除されていない | 古い LevelPlay、Ironsource、またはモバイル依存関係解決ツールのフォルダを検索。削除します。Unity パッケージを再インストールします。                   |
| 以前の 開発者 Settings の値がありません | アップグレードプロセスで以前の設定が削除された     | キーを再入力し、以前使用していたものと一致することを確認します。開発者設定> LevelPlay Mediation 設定と開発者設定> Mediated ネットワーク設定に値を再入力します。 |

インテグレーションのトラブルシューティングの詳細については、[トラブルシューティング ガイド](/grow/dashboard/levelplay/troubleshoot.md)を参照してください。

## 追加リソース##additional-resources

* [LevelPlay Unity インテグレーション](/grow/levelplay/sdk/unity/package-integration.md)
* [LevelPlay SDK changelog](/grow/levelplay/sdk/unity/changelog.md)
* [Maven Central 移行ガイド](/grow/levelplay/sdk/unity/maven-central-migration-guide.md)