Implement interstitial ads in Unity

Implement interstitial ads in your Unity project. Load ad content and display it through C# scripts between gameplay moments or app transitions.

Read time 1 minute

Last updated a day ago

To display a full-screen interstitial ad using the

Advertisements API

, initialize the SDK, then use the

Load

function to load ad content to a placement and the

Show

function to show the ad.

Note

Starting April 1, 2026, apps that monetize with Unity Ads through direct integration through the Advertisement Legacy Package might see reduced ad performance. To avoid reduction in performance, switch to integrating Unity Ads as a bidder.The Unity Ads network will continue to support and provide fill for all apps using direct integration. However, to maximize revenue and performance, the recommended best practice is to install the Ads Mediation package for LevelPlay, Unity's ad mediation platform.

In SDK versions 3.7.0 and later, you can use the

IUnityAdsLoadListener

and

IUnityAdsShowListener

callbacks to implement logic for when content succeeds or fails to load or show respectively.

Note

When calling the

Show

method, you must specify a placement ID, or an error will occur.

Interstitial ad example


using UnityEngine;using UnityEngine.Advertisements;public class InterstitialAdExample : MonoBehaviour, IUnityAdsLoadListener, IUnityAdsShowListener{  [SerializeField] string _androidAdUnitId = "Interstitial_Android";  [SerializeField] string _iOSAdUnitId = "Interstitial_iOS";  string _adUnitId;  void Awake()  {    // Get the Ad Unit ID for the current platform:    _adUnitId = (Application.platform == RuntimePlatform.IPhonePlayer)    ? _iOSAdUnitId    : _androidAdUnitId;  }  // Load content to the Ad Unit:  public void LoadAd()  {    // IMPORTANT! Only load content AFTER initialization (in this example, initialization is handled in a different script).    Debug.Log("Loading Ad: " + _adUnitId);    Advertisement.Load(_adUnitId, this);  }  // Show the loaded content in the Ad Unit:  public void ShowAd()  {    // Note that if the ad content wasn't previously loaded, this method will fail    Debug.Log("Showing Ad: " + _adUnitId);    Advertisement.Show(_adUnitId, this);  }  // Implement Load Listener and Show Listener interface methods:   public void OnUnityAdsAdLoaded(string adUnitId)  {    // Optionally execute code if the Ad Unit successfully loads content.  }  public void OnUnityAdsFailedToLoad(string _adUnitId, UnityAdsLoadError error, string message)  {    Debug.Log($"Error loading Ad Unit: {_adUnitId} - {error.ToString()} - {message}");    // Optionally execute code if the Ad Unit fails to load, such as attempting to try again.  }  public void OnUnityAdsShowFailure(string _adUnitId, UnityAdsShowError error, string message)  {    Debug.Log($"Error showing Ad Unit {_adUnitId}: {error.ToString()} - {message}");    // Optionally execute code if the Ad Unit fails to show, such as loading another ad.  }  public void OnUnityAdsShowStart(string _adUnitId) { }  public void OnUnityAdsShowClick(string _adUnitId) { }  public void OnUnityAdsShowComplete(string _adUnitId, UnityAdsShowCompletionState showCompletionState) { }}

Next steps: To improve your implementation, refer to the Implement rewarded ads in Unity documentation.

Documentation

Development

User Acquisition

Monetization

Industry