Migrate to 9.0.0+

Guide for migrating your LevelPlay Unity integration to version 9.0.0 and above.

読み終わるまでの所要時間 3 分

最終更新 2日前

Use this guide to update your LevelPlay Unity package integration to version 9.0.0 or later. This guide covers three common migration scenarios and ensures a clean setup by removing outdated files, installing the latest package, and restoring network adapters.

重要

If you use Developer Settings (LevelPlay Mediation Settings or Mediated Network Settings), record any app keys, app IDs, or custom selections before you update. You’ll need to re-enter them after upgrading to version 9.0.0 or later.

This article provides guidance for developers migrating their LevelPlay Unity integration to version 9.0.0 or later. For the latest official documentation, see the original migration guide.

Key changes in 9.0.0+

New initialization API and flow
Updated adapter and network requirements
Deprecation of legacy APIs
Additional privacy and compliance features

Migration steps

Update the LevelPlay Unity package to 9.0.0+ using the Unity Package Manager or by downloading the latest .unitypackage.
Update your initialization code to use the new API. See the Migrate to LevelPlay Init API for details.
Review and update all ad format integrations (Rewarded, Interstitial, Banner) to ensure compatibility.
Update mediation network adapters to the latest supported versions.
Test your integration thoroughly using the integration test suite.

Prerequisites

To prevent possible conflicts with legacy files or adapters when updating to version 9.0.0, ensure you’ve done the following:

Remove existing integration files to avoid version conflicts.
Install the new package so you rely only on updated code paths.
Reinstall network adapters so they integrate correctly with the version 9.0.0 APIs and dependency resolver.

Choose your update path

Scenario	When to use
Update your current Unity Plugin version to Unity Plugin 9.0.0+	You currently use the .unitypackage for LevelPlay and want to update to version 9.0.0+
Update the Ads Mediation UPM package to 9.0.0	You currently use the Ads Mediation UPM package for LevelPlay and want to update to version 9.0.0+
Migrate from the Unity Plugin to the Ads Mediation package	You want to stop using the .unitypackage and switch to the Ads Mediation UPM package with version 9.0.0+

Update your current Unity Plugin version to 9.0.0+

Follow these steps if you currently use the Unity Plugin (.unitypackage) for LevelPlay and want to upgrade to version 9.0.0 or later:

Using a supported Editor version, open your project in the Unity Editor.
In the Project window, locate the
```
Assets > LevelPlay
```
folder and delete LevelPlay and all its contents.
If present, delete
```
Assets > Mobile Dependency Resolver
```
.
Download the Unity Plugin.
Import the .unitypackage file into your project.
Go to Ads Mediation > Network Manager in Unity’s main menu.
Click Install to add the network adapters compatible with version 9.0.0 or later.

Update the Ads Mediation UPM package to 9.0.0+

Follow these steps if you currently use the Ads Mediation UPM package for LevelPlay and want to upgrade to version 9.0.0 or later:

Using a supported Editor version, open your project in the Unity Editor.
In the Project window, locate the
```
Assets > LevelPlay
```
or
```
Assets > IronSource
```
folder and delete the folder and all of its contents.
If present, delete
```
Assets > Mobile Dependency Resolver
```
.
Open Window > Package Manager.
- Select Unity Registry in the Packages source.
- Select Ads Mediation.
- Click Update.
Go to Ads Mediation > Network Manager in Unity’s main menu.
Click Install to add the network adapters compatible with version 9.0.0 or later.

Migrate from the Unity Plugin to the Ads Mediation package

Follow these steps if you currently use the Unity Plugin (.unitypackage) but want to migrate to the Ads Mediation UPM package (v9.0.0+):

Using a supported Editor version, open your project in the Unity Editor.
In the Project window, locate the
```
Assets > LevelPlay
```
or
```
Assets > IronSource
```
folder and delete the folder and all of its contents.
If present, delete
```
Assets > Mobile Dependency Resolver
```
.
Open Window > Package Manager.
- Choose Unity Registry.
- Find Ads Mediation.
- Click Install.
Navigate to Ads Mediation > Network Manager in Unity’s main menu.
Click Install to add the network adapters compatible with version 9.0.0+.

Post-update verification

Re-enter any Developer Settings values you saved earlier.
Run a test build to confirm ads load correctly and no missing adapter errors appear.
Check console logs for warnings relating to deprecated API usage and replace them using the APIs supported in v9.0.0.

Troubleshooting common migration issues

Problem	Possible Cause	Suggested Fix
Network adapters missing or not showing	Adapter installation was skipped or failed	Go to Ads Mediation > Network Manager and select Install again. Verify the installer logs.
Duplicate or conflicting files	Old package/SDK files weren’t fully removed	Search for old LevelPlay, IronSource, or Mobile Dependency Resolver folders. Delete them. Reinstall the Unity package.
Previous Developer Settings values missing	Previous settings were removed in the upgrade process	Re-enter keys; confirm they match what you used before. Re-enter your values into Developer Settings > LevelPlay Mediation Settings and Developer Settings > Mediated Network Settings.

For more information on troubleshooting your integration, refer to the troubleshooting guide.

Additional resources

For more details, visit the official migration guide.

ドキュメント

エンジン

サービス

Grow

産業

サポート

Unity LevelPlay

Get started with LevelPlay

SDK integration

LevelPlay platform