9.0.0 以降への移行
LevelPlay Unity インテグレーションをバージョン 9.0.0 以降に移行するためのガイド。
読み終わるまでの所要時間 12 分最終更新 1ヶ月前
このガイドを使用して、LevelPlay Unity パッケージインテグレーションをバージョン 9.0.0 以降に更新します。このガイドでは、3 つの一般的な移行シナリオについて説明し、古いファイルの削除、最新パッケージのインストール、およびネットワーク アダプタの復元によってクリーンな設定を実現します。
重要
開発者 Settings (LevelPlay Mediation Settings または Mediated ネットワーク Settings) を使用する場合は、更新する前に、アプリケーション、アプリケーション ID、またはカスタム選択を記録してください。バージョン 9.0.0 以降にアップグレードした後、再入力する必要があります。
この記事では、LevelPlay Unity インテグレーションをバージョン 9.0.0 以降に移行する開発者向けのガイダンスを提供します。
9.0.0 以降のキー変更点
- 新しい初期化 API とフロー
- アダプタとネットワーク要件の更新
- 古い機能 API の廃止
- その他のプライバシーとコンプライアンス機能
移行手順
- Unity Package Manager を使用するか、最新の .unitypackage をダウンロードして、LevelPlay Unity パッケージを 9.0.0 以上に更新します。
- 新しい API を使用するように初期化コードを更新します。詳細については、「 Migrate to LevelPlay Init API 」を参照してください。
- 互換性を確保するために、すべての広告形式(リワード型、インタースティシャル、バナー)の統合を確認および更新します。
- メディエーションネットワークアダプタをサポートされている最新バージョンに更新します。
- インテグレーションテストスイートを使用して、インテグレーションを徹底的にテストします。
前提条件
バージョン 9.0.0 にアップデートするときに、古い機能ファイルまたはアダプターとの競合が発生する可能性を防ぐために、以下のことを行ってください。
- 既存のインテグレーションファイルを削除して、バージョンの競合を回避します。
- 更新されたコードパスのみに依存するように、新しいパッケージをインストールします。
- ネットワーク アダプタを再インストールして、バージョン 9.0.0 の API と依存関係解決と正しく統合します。
更新パスの選択
シナリオ | どのような場合に使用するか |
|---|---|
| 現在の 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 以上に更新
現在 LevelPlay に Unity プラグイン(.unitypackage)を使用しており、バージョン 9.0.0 以降にアップグレードする場合は、次の手順に従います。
- サポートされているエディターバージョンを使用して、Unity エディターでプロジェクトを開きます。
- Project ウィンドウで フォルダーを探し、LevelPlay とそのすべてのコンテンツを削除します。
Assets > LevelPlay - 存在する場合は、を削除します。
Assets > Mobile Dependency Resolver - Unity プラグインをダウンロードします。
- .unitypackage ファイルをプロジェクトにインポートします。
- Unity のメインメニューで Ads Mediation > ネットワーク Manager (ネットワークマネージャー) に移動します。
- ［Install］ をクリックして、バージョン 9.0.0 以降と互換性のあるネットワーク アダプタを追加します。
Ads Mediation UPM パッケージを 9.0.0 以上に更新する
現在 LevelPlay 用の Ads Mediation UPM パッケージを使用しており、バージョン 9.0.0 以降にアップグレードする場合は、次の手順に従います。
- サポートされているエディターバージョンを使用して、Unity エディターでプロジェクトを開きます。
- Project ウィンドウで、または
Assets > LevelPlayフォルダーを探し、そのフォルダーとそのすべてのコンテンツを削除します。Assets > IronSource - 存在する場合は、を削除します。
Assets > Mobile Dependency Resolver - Window (ウィンドウ) > Package Manager (パッケージマネージャー) を開きます。
- パッケージソースで Unity レジストリを選択します。
- Ads Mediation を選択します。
- 更新 をクリックします。
- Unity のメインメニューで Ads Mediation > ネットワーク Manager (ネットワークマネージャー) に移動します。
- ［Install］ をクリックして、バージョン 9.0.0 以降と互換性のあるネットワーク アダプタを追加します。
Unity プラグインから Ads Mediation パッケージに移行する
現在 Unity プラグイン (.unitypackage) を使用しているが、Ads Mediation UPM パッケージ (v9.0.0 以降) に移行する場合は、次の手順に従います。
- サポートされているエディターバージョンを使用して、Unity エディターでプロジェクトを開きます。
- Project ウィンドウで、または
Assets > LevelPlayフォルダーを探し、そのフォルダーとそのすべてのコンテンツを削除します。Assets > IronSource - 存在する場合は、を削除します。
Assets > Mobile Dependency Resolver - Window (ウィンドウ) > Package Manager (パッケージマネージャー) を開きます。
- Unity レジストリを選択します。
- Ads Mediation を検索します。
- Install (インストール) をクリックします。
- Unity のメインメニューで Ads Mediation > ネットワーク Manager に操作するします。
- Install をクリックして、バージョン 9.0.0 以降と互換性のあるネットワーク アダプタを追加します。
更新後の検証
- 前に保存した開発者設定の値を再入力します。
- テストビルドを実行して、広告が正しくロードされ、欠落しているアダプタエラーが表示されないことを確認します。
- コンソール ログで非推奨の API 使用に関する警告を確認し、v9.0.0 でサポートされる API を使用して置き換えます。
移行に関する一般的な問題のトラブルシューティング
問題 | 考えられる原因 | 修正案 |
|---|---|---|
| ネットワークアダプタがない、または表示されない | アダプタのインストールがスキップされたか、失敗しました | Ads Mediation > ネットワーク マネージャの順に選択し、再度 Install (インストール) を選択します。インストーラーログを確認します。 |
| 複製または競合するファイル | 古いパッケージ/SDKファイルが完全に削除されていない | 古い LevelPlay、Ironsource、またはモバイル依存関係解決ツールのフォルダを検索。削除します。Unity パッケージを再インストールします。 |
| 以前の 開発者 Settings の値がありません | アップグレードプロセスで以前の設定が削除された | キーを再入力し、以前使用していたものと一致することを確認します。開発者設定> LevelPlay Mediation 設定と開発者設定> Mediated ネットワーク設定に値を再入力します。 |
インテグレーションのトラブルシューティングの詳細については、トラブルシューティング ガイドを参照してください。