Interstitial

Integration

Unlike banners, interstitials can only be integrated with code. Below we show a simple example to understand how it works:

Kotlin

class MainActivity : Activity() {

    private var interstitialAd: InterstitialAd? = null

    override fun onCreate(savedInstanceState: Bundle?) {
        ...
        interstitialAd = InterstitialAd(this, "<Wortise Ad Unit ID>").also {
            it.loadAd()
        }
    }

    override fun onDestroy() {
        ...
        interstitialAd?.destroy()
    }

    fun showInterstitial() {
        if (interstitialAd?.isAvailable == true) {
            interstitialAd?.showAd(this)
        }
    }
}

Java

public class MainActivity extends Activity {

    private InterstitialAd mInterstitial;

    @Override
    public void onCreate(Bundle savedInstanceState) {
        ...
        mInterstitial = new InterstitialAd(this, "Wortise Ad Unit ID");
        mInterstitial.loadAd();
    }

    @Override
    public void onDestroy() {
        ...
        mInterstitial.destroy();
    }

    public void showInterstitial() {
        if (mInterstitial.isAvailable()) {
            mInterstitial.showAd(this);
        }
    }
}

Listener configuration

As with banners, a listener can be set to receive the events that happen during the interstitial lifecycle. For this, you need to implement the InterstitialAd.Listener interface as shown in the example below:

Kotlin

interstitialAd.listener = object : InterstitialAd.Listener() {

    override fun onInterstitialClicked(ad: InterstitialAd) {
        // Invoked when the ad has been clicked
    }

    override fun onInterstitialDismissed(ad: InterstitialAd) {
        // Invoked when the ad has been dismissed
    }

    override fun onInterstitialFailedToLoad(ad: InterstitialAd,
                                            error: AdError) {
        // Invoked when the ad could not be loaded
        // (because of an error or no fill)
    }

    override fun onInterstitialFailedToShow(ad: InterstitialAd,
                                            error: AdError) {
        // Invoked when the ad could not be shown
    }

    override fun onInterstitialImpression(ad: InterstitialAd) {
        // Invoked when the ad has generated an impression
    }

    override fun onInterstitialLoaded(ad: InterstitialAd) {
        // Invoked when the ad has been loaded
    }

    override fun onInterstitialRevenuePaid(ad: InterstitialAd,
                                           data: RevenueData) {
        // Invoked when the ad has generated revenue
    }

    override fun onInterstitialShown(ad: InterstitialAd) {
        // Invoked when the ad has been shown
    }
}

Java

mInterstitial.setListener(new InterstitialAd.Listener() {
    @Override
    public void onInterstitialClicked(@NonNull InterstitialAd ad) {
        // Invoked when the ad has been clicked
    }

    @Override
    public void onInterstitialDismissed(@NonNull InterstitialAd ad) {
        // Invoked when the ad has been dismissed
    }

    @Override
    public void onInterstitialFailedToLoad(@NonNull InterstitialAd ad,
                                           @NonNull AdError error) {
        // Invoked when the ad could not be loaded
        // (because of an error or no fill)
    }

    @Override
    public void onInterstitialFailedToShow(@NonNull InterstitialAd ad,
                                           @NonNull AdError error) {
        // Invoked when the ad could not be shown
    }

    @Override
    public void onInterstitialImpression(@NonNull InterstitialAd ad) {
        // Invoked when the ad has generated an impression
    }

    @Override
    public void onInterstitialLoaded(@NonNull InterstitialAd ad) {
        // Invoked when the ad has been loaded
    }

    @Override
    public void onInterstitialRevenuePaid(@NonNull InterstitialAd ad,
                                          @NonNull RevenueData data) {
        // Invoked when the ad has generated revenue
    }

    @Override
    public void onInterstitialShown(@NonNull InterstitialAd ad) {
        // Invoked when the ad has been shown
    }
});