Migrate to 9.0.0+
Guide for migrating your LevelPlay Unity integration to version 9.0.0 and above.
読み終わるまでの所要時間 3 分最終更新 1日前
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.
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. Refer to 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 folder and delete LevelPlay and all its contents.
Assets > LevelPlay - 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 or
Assets > LevelPlayfolder and delete the folder and all of its contents.Assets > IronSource - 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 or
Assets > LevelPlayfolder and delete the folder and all of its contents.Assets > IronSource - 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. |