# 9.0.0 API changes

> Detailed list of API changes introduced in LevelPlay Unity SDK 9.0.0.

As part of Native SDK version 9.0.0 we will remove some APIs and deprecate some of our existing listeners and callbacks. You can find the detailed list of changes below:

This article summarizes the major API changes introduced in LevelPlay Unity SDK version 9.0.0. For the full migration process, refer to the [Migrate to 9.0.0+ guide](/grow/levelplay/sdk/unity/migrate-to-9-0-0.md).

## Key API changes in 9.0.0

* All public-facing APIs have been refactored from `IronSource` to `LevelPlay` for clarity and consistency.
* Deprecated APIs have been removed. Refer to the SDK documentation for a full list of removed methods.
* The `LevelPlay.Init` method has been simplified, removing ad format parameters.
* Ad units are now created using new config classes.
* The `OnAdDisplayFailed` event now provides distinct `LevelPlayAdInfo` and `LevelPlayAdError` parameters.

## Migration notes

* Upgrading from a version lower than 9.0.0 requires additional migration steps. Refer to the [Migration Guide](/grow/levelplay/sdk/unity/migrate-to-9-0-0.md).
* Review and update all ad format integrations (Rewarded, Interstitial, Banner) to ensure compatibility.

## APIs removed from 9.0.0 for Unity

### Init

|       | Legacy – deprecated      | New                                                   |
| ----- | ------------------------ | ----------------------------------------------------- |
| API   | Ironsource.init          | LevelPlay.Init                                        |
|       | setUserID                | Should be set as part of LevelPlayInitRequest builder |
| Event | onInitializationComplete | OnInitSuccess                                         |

### Rewarded

|          | Legacy – deprecated            | New (Ad Unit Level LevelPlayRewardedAd)                          |
| -------- | ------------------------------ | ---------------------------------------------------------------- |
| Listener | IronsourceRewardedVideoEvents  | LevelPlayRewardedAd                                              |
| API      | loadRewardedVideo              | LoadAd                                                           |
|          | showRewardedVideo              | ShowAd                                                           |
|          | isRewardedVideoAvailable       | IsAdReady                                                        |
|          | isRewardedVideoPlacementCapped | IsPlacementCapped                                                |
|          | setRewardedVideoServerParams   | LevelPlay.SetMetaData, key:”LevelPlay\_Rewarded\_Server\_Params” |
|          | clearRewardedVideoServerParams | LevelPlay.SetMetaData, key:”LevelPlay\_Rewarded\_Server\_Params” |
| Events   | onAdReadyEvent                 | OnAdLoaded                                                       |
|          | onAdLoadFailedEvent            | OnAdLoadFailed                                                   |
|          | onAdOpenedEvent                | OnAdDisplayed                                                    |
|          | onAdClosedEvent                | OnAdClosed                                                       |
|          | onAdShowFailedEvent            | OnAdDisplayFailed                                                |
|          | onAdRewardedEvent              | OnAdRewarded                                                     |
|          | onAdClickedEvent               | OnAdClicked                                                      |
|          | onAdShowSucceededEvent         | —                                                                |

### Interstitial

|          | Legacy – deprecated           | New                     |
| -------- | ----------------------------- | ----------------------- |
| Listener | IronSourceInterstitialEvents  | LevelPlayInterstitialAd |
| Events   | onAdReadyEvent                | OnAdLoaded              |
|          | onAdLoadFailedEvent           | OnAdLoadFailed          |
|          | onAdOpenedEvent               | OnAdDisplayed           |
|          | onAdClosedEvent               | OnAdClosed              |
|          | onAdShowSucceededEvent        | —                       |
|          | onAdShowFailedEvent           | OnAdDisplayFailed       |
|          | onAdClickedEvent              | OnAdClicked             |
| API      | LoadInterstitial              | LoadAd                  |
|          | ShowInterstitial              | ShowAd                  |
|          | IsInterstitialPlacementCapped | IsPlacementCapped       |
|          | IsInterstitialReady           | IsAdReady               |

### Banners

|          | Legacy – deprecated                 | New (Ad Unit Level LevelPlayBannerAd)                                  |
| -------- | ----------------------------------- | ---------------------------------------------------------------------- |
| Listener | IronSourceBannerEvents              | LevelPlayBannerAd                                                      |
| Events   | onAdLoadedEvent                     | OnAdLoaded                                                             |
|          | onAdLeftApplicationEvent            | OnAdLeftApplication                                                    |
|          | onAdScreenDismissedEvent            | —                                                                      |
|          | onAdScreenPresentedEvent            | OnAdDisplayed                                                          |
|          | onAdClickedEvent                    | OnAdClicked                                                            |
|          | onAdLoadFailedEvent                 | OnAdLoadFailed                                                         |
| API      | IronSourceBannerLayout.createBanner | LevelPlayBannerAdView(context, “adUnitId”)                             |
|          | loadBanner                          | LoadAd                                                                 |
|          | destroyBanner                       | DestroyAd                                                              |
|          | displayBanner                       | ShowAd                                                                 |
|          | hideBanner                          | HideAd                                                                 |
|          | IronSourceBannerPosition            | LevelPlayBannerPosition.TopCenter LevelPlayBannerPosition.BottomCenter |
|          | IronSourceBannerSize                | LevelPlayAdSize                                                        |

### Banner Sizes

| Legacy               | Ad Unit (new)                            | Dimensions in dp                                                              |
| -------------------- | ---------------------------------------- | ----------------------------------------------------------------------------- |
| IronSourceBannerSize | LevelPlayAdSize                          | (Width X Height)                                                              |
| BANNER               | BANNER                                   | 320 x 50                                                                      |
| LARGE                | LARGE                                    | 320 x 90                                                                      |
| RECTANGLE            | MEDIUM\_RECTANGLE                        | 300 x 250                                                                     |
| SMART                | Replaced by Adaptive Ad Size (see below) | Automatically renders ads to adjust size and orientation for mobile & tablets |

### Settings

|       | Legacy – deprecated                                | New                                                                                                    |
| ----- | -------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| API   | IronSource.pluginVersion                           | LevelPlay.PluginVersion                                                                                |
|       | IronSource.unityVersion                            | LevelPlay.UnityVersion                                                                                 |
|       | IronSource.Agent.validateIntegration               | LevelPlay.ValidateIntegration                                                                          |
|       | IronSource.Agent.setDynamicUserId                  | LevelPlay.SetDynamicUserId                                                                             |
|       | IronSource.Agent.setAdaptersDebug                  | LevelPlay.SetAdaptersDebug                                                                             |
|       | IronSource.Agent.setMetaData                       | LevelPlay.SetMetaData                                                                                  |
|       | IronSource.Agent.setNetworkData                    | LevelPlay.SetNetworkData                                                                               |
|       | IronSource.Agent.SetPauseGame                      | LevelPlay.SetPauseGame                                                                                 |
|       | IronSource.Agent.launchTestSuite                   | LevelPlay.LaunchTestSuite                                                                              |
|       | IronSource.Agent.setConsent                        | LevelPlay.SetConsent                                                                                   |
|       | IronSource.Agent.setSegment                        | LevelPlay.SetSegment                                                                                   |
|       | onApplicationPause                                 | — (This API was calling onPause/onResume from native. Pause/Resume is now fetched from the lifecycle.) |
|       | getAdvertiserId                                    | —                                                                                                      |
|       | shouldTrackNetworkState                            | —                                                                                                      |
|       | getPlacementInfo                                   | —                                                                                                      |
|       | isBannerPlacementCapped                            | —                                                                                                      |
|       | getMaximalAdaptiveHeight                           | —                                                                                                      |
|       | getDeviceScreenWidth                               | —                                                                                                      |
| Class | IronSourceSegment                                  | LevelPlaySegment                                                                                       |
|       | IronSourceError                                    | LevelPlayAdError                                                                                       |
|       | IronSourceImpressionData                           | LevelPlayImpressionData                                                                                |
|       | IronSourceConfig                                   | —                                                                                                      |
|       | IronSourcePlacement                                | —                                                                                                      |
|       | IronSourceUtils                                    | —                                                                                                      |
|       | WaterfallConfiguration                             | —                                                                                                      |
| Event | IronSourceEvents.onImpressionDataReadyEvent        | LevelPlay.OnImpressionDataReady (Supported from SDK 8.10.1+)                                           |
|       | IronSourceEvents.onSdkInitializationCompletedEvent | LevelPlay.OnInitSuccess                                                                                |
|       | onSegmentReceivedEvent                             | —                                                                                                      |

For more details, refer to the [changelog](/grow/levelplay/sdk/unity/changelog.md).
