Contact usContact us

Unity Package Migration 9.0.0+

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.

Note: 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.

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+

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.

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:

  1. Using a supported Editor version, open your project in the Unity Editor.
  2. In the Project window, locate the Assets > LevelPlay folder and delete LevelPlay and all its contents.
  3. If present, delete Assets > Mobile Dependency Resolver.
  4. Download the Unity Plugin. 
  5. Import the .unitypackage file into your project.
  6. Go to Ads Mediation > Network Manager in Unity’s main menu.
  7. 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:

  1. Using a supported Editor version, open your project in the Unity Editor. 
  2. In the Project window, locate the Assets > LevelPlay or Assets > IronSource folder and delete the folder and all of its contents.
  3. If present, delete Assets > Mobile Dependency Resolver.
  4. Open Window > Package Manager.
    • Select Unity Registry in the Packages source.
    • Select Ads Mediation.
    • Click Update.
  5. Go to Ads Mediation > Network Manager in Unity’s main menu.
  6. 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+):

  1. Using a supported Editor version, open your project in the Unity Editor.
  2. In the Project window, locate the Assets > LevelPlay or Assets > IronSource folder and delete the folder and all of its contents.
  3. If present, delete Assets > Mobile Dependency Resolver.
  4. Open Window > Package Manager.
    • Choose Unity Registry.
    • Find Ads Mediation.
    • Click Install.
  5. Navigate to Ads Mediation > Network Manager in Unity’s main menu.
  6. 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.