Migrate SDK versions

  • In version 8, all full screen ad formats now use a static Load() method for loading ads, replacing the instance level LoadAd() method used for interstitial and rewarded ads in version 7.

  • The IsLoaded() method in version 7 is replaced by the new CanShowAd() method in version 8 to check if a full-screen ad can be shown.

  • Rewarded and rewarded interstitial ad formats in version 8 use a Show(Action<Reward>) method with a callback for handling the user reward, unlike the separate OnUserEarnedReward event in version 7 for rewarded ads.

  • Version 8 ad event delegates use generic delegates and emit event values directly, unlike version 7 which used EventHandlers and wrapped values in the EventArg class.

  • Version 8 has standardized API method names across ad formats for uniformity, addressing discrepancies present in version 7.
Select platform: iOS Unity Android (Legacy)

Last updated: February 2023

This page covers migrations for current and previous versions.

Migrate from version 7 to version 8

Full Screen formats now use a static load method

In version 7 of the plugin, interstitial and rewarded ads had an instance level LoadAd() method for loading an ad whereas rewarded interstitial ad and app open ads had a static Load() method for loading ads. In version 8, all full screen ad formats (interstitial, rewarded, rewarded interstitial, and app open) will have a static Load() method for loading ads. Here is an example of how to load an interstitial ad:

Version 8 (Current)

#if UNITY_ANDROID
const string adUnitId = "ca-app-pub-3940256099942544/1033173712";
#elif UNITY_IPHONE
const string adUnitId = "ca-app-pub-3940256099942544/4411468910";
#else
const string adUnitId = "unexpected_platform";
#endif

private InterstitialAd _interstitialAd;

private void LoadAd()
{
    // Load an interstitial ad
    InterstitialAd.Load(adUnitId, new AdRequest(),
        (