Do I Have To Call .loadad() Every Time I Want A New Ad To Appear In My Android App

Interstitial ads are full-screen ads that cover the interface of their host app. They're typically displayed at natural transition points in the flow of an app, such as between activities or during the pause between levels in a game. When an app shows an interstitial ad, the user has the choice to either tap on the ad and continue to its destination or close it and return to the app. Case study.

This guide explains how to integrate interstitial ads into an Android app.

Prerequisites

Google Mobile Ads SDK 19.7.0 or higher.
Follow the Get Started guide to import the Google Mobile Ads SDK and update your Android manifest.

Always test with test ads

When building and testing your apps, make sure you use test ads rather than live, production ads. Failure to do so can lead to suspension of your account.

The easiest way to load test ads is to use our dedicated test ad unit ID for Android interstitials:

ca-app-pub-3940256099942544/1033173712

It's been specially configured to return test ads for every request, and you're free to use it in your own apps while coding, testing, and debugging. Just make sure you replace it with your own ad unit ID before publishing your app.

For more information about how the Mobile Ads SDK's test ads work, see Test Ads.

Load an ad

To load an interstitial ad, call the InterstitialAd static load() method and pass in an InterstitialAdLoadCallback to receive the loaded ad or any possible errors. Notice that like other format load callbacks, InterstitialAdLoadCallback leverages LoadAdError to provide higher fidelity error details.

Java

                import com.google.android.gms.ads.interstitial.InterstitialAd;                import com.google.android.gms.ads.interstitial.InterstitialAdLoadCallback;                public class MainActivity extends Activity {                private InterstitialAd mInterstitialAd;                @Override     protected void onCreate(Bundle savedInstanceState) {       super.onCreate(savedInstanceState);       setContentView(R.layout.activity_main);        MobileAds.initialize(this, new OnInitializationCompleteListener() {         @Override         public void onInitializationComplete(InitializationStatus initializationStatus) {}       });                AdRequest adRequest = new AdRequest.Builder().build();        InterstitialAd.load(this,"ca-app-pub-3940256099942544/1033173712", adRequest,         new InterstitialAdLoadCallback() {       @Override       public void onAdLoaded(@NonNull InterstitialAd interstitialAd) {         // The mInterstitialAd reference will be null until         // an ad is loaded.         mInterstitialAd = interstitialAd;         Log.i(TAG, "onAdLoaded");       }        @Override       public void onAdFailedToLoad(@NonNull LoadAdError loadAdError) {         // Handle the error         Log.i(TAG, loadAdError.getMessage());         mInterstitialAd = null;       }     });                } }

Kotlin

                import com.google.android.gms.ads.interstitial.InterstitialAd; import com.google.android.gms.ads.interstitial.InterstitialAdLoadCallback;                class MainActivity : AppCompatActivity() {                private var mInterstitialAd: InterstitialAd? = null   private final var TAG = 'MainActivity'                override fun onCreate(savedInstanceState: Bundle?) {       super.onCreate(savedInstanceState)       setContentView(R.layout.activity_main)                  var adRequest = AdRequest.Builder().build()        InterstitialAd.load(this,"ca-app-pub-3940256099942544/1033173712", adRequest, object : InterstitialAdLoadCallback() {         override fun onAdFailedToLoad(adError: LoadAdError) {           Log.d(TAG, adError?.message)           mInterstitialAd = null         }          override fun onAdLoaded(interstitialAd: InterstitialAd) {           Log.d(TAG, 'Ad was loaded.')           mInterstitialAd = interstitialAd         }       })                } }

Set the FullScreenContentCallback

The FullScreenContentCallback handles events related to displaying your InterstitialAd. Before showing InterstitialAd, make sure to set the callback:

Java

mInterstitialAd.setFullScreenContentCallback(new FullScreenContentCallback(){   @Override   public void onAdDismissedFullScreenContent() {     // Called when fullscreen content is dismissed.     Log.d("TAG", "The ad was dismissed.");   }    @Override   public void onAdFailedToShowFullScreenContent(AdError adError) {     // Called when fullscreen content failed to show.     Log.d("TAG", "The ad failed to show.");   }    @Override   public void onAdShowedFullScreenContent() {     // Called when fullscreen content is shown.     // Make sure to set your reference to null so you don't     // show it a second time.     mInterstitialAd = null;     Log.d("TAG", "The ad was shown.");   } });

Kotlin

mInterstitialAd?.fullScreenContentCallback = object: FullScreenContentCallback() {   override fun onAdDismissedFullScreenContent() {     Log.d(TAG, 'Ad was dismissed.')   }    override fun onAdFailedToShowFullScreenContent(adError: AdError?) {     Log.d(TAG, 'Ad failed to show.')   }    override fun onAdShowedFullScreenContent() {     Log.d(TAG, 'Ad showed fullscreen content.')     mInterstitialAd = null   } }

Show the ad

Interstitial ads should be displayed during natural pauses in the flow of an app. Between levels of a game is a good example, or after the user completes a task. To show an interstitial, use the show() method.

Java

if (mInterstitialAd != null) {   mInterstitialAd.show(MyActivity.this); } else {   Log.d("TAG", "The interstitial ad wasn't ready yet."); }

Kotlin

if (mInterstitialAd != null) {   mInterstitialAd?.show(this) } else {   Log.d("TAG", "The interstitial ad wasn't ready yet.") }

Some best practices

Consider whether interstitial ads are the right type of ad for your app.: Interstitial ads work best in apps with natural transition points. The conclusion of a task within an app, like sharing an image or completing a game level, creates such a point. Because the user is expecting a break in the action, it's easy to present an interstitial ad without disrupting their experience. Make sure you consider at which points in your app's workflow you'll display interstitial ads and how the user is likely to respond.
Remember to pause the action when displaying an interstitial ad.: There are a number of different types of interstitial ads: text, image, video, and more. It's important to make sure that when your app displays an interstitial ad, it also suspends its use of some resources to allow the ad to take advantage of them. For example, when you make the call to display an interstitial ad, be sure to pause any audio output being produced by your app.
Allow for adequate loading time.: Just as it's important to make sure you display interstitial ads at an appropriate time, it's also important to make sure the user doesn't have to wait for them to load. Loading the ad in advance by calling load() before you intend to call show() can ensure that your app has a fully loaded interstitial ad at the ready when the time comes to display one.
Don't flood the user with ads.: While increasing the frequency of interstitial ads in your app might seem like a great way to increase revenue, it can also degrade the user experience and lower clickthrough rates. Make sure that users aren't so frequently interrupted that they're no longer able to enjoy the use of your app.

Source code

MyActivity.java

/*  * Copyright (C) 2013 Google, Inc.  *  * Licensed under the Apache License, Version 2.0 (the "License");  * you may not use this file except in compliance with the License.  * You may obtain a copy of the License at  *  *      http://www.apache.org/licenses/LICENSE-2.0  *  * Unless required by applicable law or agreed to in writing, software  * distributed under the License is distributed on an "AS IS" BASIS,  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  * See the License for the specific language governing permissions and  * limitations under the License.  */ package com.google.android.gms.example.interstitialexample;  import android.os.Bundle; import android.os.CountDownTimer; import android.support.v7.app.AppCompatActivity; import android.util.Log; import android.view.View; import android.widget.Button; import android.widget.TextView; import android.widget.Toast; import androidx.annotation.NonNull; import com.google.android.gms.ads.AdError; import com.google.android.gms.ads.AdRequest; import com.google.android.gms.ads.FullScreenContentCallback; import com.google.android.gms.ads.LoadAdError; import com.google.android.gms.ads.MobileAds; import com.google.android.gms.ads.initialization.InitializationStatus; import com.google.android.gms.ads.initialization.OnInitializationCompleteListener; import com.google.android.gms.ads.interstitial.InterstitialAd; import com.google.android.gms.ads.interstitial.InterstitialAdLoadCallback;  /**  * Main Activity. Inflates main activity xml.  */ public class MyActivity extends AppCompatActivity {      private static final long GAME_LENGTH_MILLISECONDS = 3000;     private static final String AD_UNIT_ID = "ca-app-pub-3940256099942544/1033173712";   private static final String TAG = "MyActivity";      private InterstitialAd interstitialAd;     private CountDownTimer countDownTimer;     private Button retryButton;     private boolean gameIsInProgress;     private long timerMilliseconds;      @Override     protected void onCreate(Bundle savedInstanceState) {         super.onCreate(savedInstanceState);         setContentView(R.layout.activity_my);          // Initialize the Mobile Ads SDK.         MobileAds.initialize(this, new OnInitializationCompleteListener() {             @Override             public void onInitializationComplete(InitializationStatus initializationStatus) {}         });      loadAd();          // Create the "retry" button, which tries to show an interstitial between game plays.         retryButton = findViewById(R.id.retry_button);         retryButton.setVisibility(View.INVISIBLE);         retryButton.setOnClickListener(new View.OnClickListener() {             @Override             public void onClick(View view) {                 showInterstitial();             }         });          startGame();     }    public void loadAd() {     AdRequest adRequest = new AdRequest.Builder().build();     InterstitialAd.load(         this,         AD_UNIT_ID,         adRequest,         new InterstitialAdLoadCallback() {           @Override           public void onAdLoaded(@NonNull InterstitialAd interstitialAd) {             // The mInterstitialAd reference will be null until             // an ad is loaded.             MyActivity.this.interstitialAd = interstitialAd;             Log.i(TAG, "onAdLoaded");             Toast.makeText(MyActivity.this, "onAdLoaded()", Toast.LENGTH_SHORT).show();             interstitialAd.setFullScreenContentCallback(                 new FullScreenContentCallback() {                   @Override                   public void onAdDismissedFullScreenContent() {                     // Called when fullscreen content is dismissed.                     // Make sure to set your reference to null so you don't                     // show it a second time.                     MyActivity.this.interstitialAd = null;                     Log.d("TAG", "The ad was dismissed.");                   }                    @Override                   public void onAdFailedToShowFullScreenContent(AdError adError) {                     // Called when fullscreen content failed to show.                     // Make sure to set your reference to null so you don't                     // show it a second time.                     MyActivity.this.interstitialAd = null;                     Log.d("TAG", "The ad failed to show.");                   }                    @Override                   public void onAdShowedFullScreenContent() {                     // Called when fullscreen content is shown.                     Log.d("TAG", "The ad was shown.");                   }                 });           }            @Override           public void onAdFailedToLoad(@NonNull LoadAdError loadAdError) {             // Handle the error             Log.i(TAG, loadAdError.getMessage());             interstitialAd = null;              String error =                 String.format(                     "domain: %s, code: %d, message: %s",                     loadAdError.getDomain(), loadAdError.getCode(), loadAdError.getMessage());             Toast.makeText(                     MyActivity.this, "onAdFailedToLoad() with error: " + error, Toast.LENGTH_SHORT)                 .show();           }         });   }      private void createTimer(final long milliseconds) {         // Create the game timer, which counts down to the end of the level         // and shows the "retry" button.         if (countDownTimer != null) {             countDownTimer.cancel();         }          final TextView textView = findViewById(R.id.timer);          countDownTimer = new CountDownTimer(milliseconds, 50) {             @Override             public void onTick(long millisUnitFinished) {                 timerMilliseconds = millisUnitFinished;                 textView.setText("seconds remaining: " + ((millisUnitFinished / 1000) + 1));             }              @Override             public void onFinish() {                 gameIsInProgress = false;                 textView.setText("done!");                 retryButton.setVisibility(View.VISIBLE);             }         };     }      @Override     public void onResume() {         // Start or resume the game.         super.onResume();          if (gameIsInProgress) {             resumeGame(timerMilliseconds);         }     }      @Override     public void onPause() {         // Cancel the timer if the game is paused.         countDownTimer.cancel();         super.onPause();     }      private void showInterstitial() {     // Show the ad if it's ready. Otherwise toast and restart the game.     if (interstitialAd != null) {       interstitialAd.show(this);         } else {             Toast.makeText(this, "Ad did not load", Toast.LENGTH_SHORT).show();             startGame();         }     }      private void startGame() {     // Request a new ad if one isn't already loaded, hide the button, and kick off the timer.     if (interstitialAd == null) {       loadAd();         }          retryButton.setVisibility(View.INVISIBLE);         resumeGame(GAME_LENGTH_MILLISECONDS);     }      private void resumeGame(long milliseconds) {         // Create a new timer for the correct length and start it.         gameIsInProgress = true;         timerMilliseconds = milliseconds;         createTimer(milliseconds);         countDownTimer.start();     } }

MainActivity.kt

package com.google.android.gms.example.interstitialexample  import android.os.Bundle import android.os.CountDownTimer import android.util.Log import android.view.View import android.widget.Toast import androidx.appcompat.app.AppCompatActivity import com.google.android.gms.ads.* import com.google.android.gms.ads.interstitial.InterstitialAd import com.google.android.gms.ads.interstitial.InterstitialAdLoadCallback import kotlinx.android.synthetic.main.activity_main.*  const val GAME_LENGTH_MILLISECONDS = 3000L const val AD_UNIT_ID = "ca-app-pub-3940256099942544/1033173712"  class MainActivity : AppCompatActivity() {    private var mInterstitialAd: InterstitialAd? = null   private var mCountDownTimer: CountDownTimer? = null   private var mGameIsInProgress = false   private var mAdIsLoading: Boolean = false   private var mTimerMilliseconds = 0L   private var TAG = "MainActivity"    override fun onCreate(savedInstanceState: Bundle?) {     super.onCreate(savedInstanceState)     setContentView(R.layout.activity_main)      // Initialize the Mobile Ads SDK.     MobileAds.initialize(this) {}      // Set your test devices. Check your logcat output for the hashed device ID to     // get test ads on a physical device. e.g.     // "Use RequestConfiguration.Builder().setTestDeviceIds(Arrays.asList("ABCDEF012345"))     // to get test ads on this device."     MobileAds.setRequestConfiguration(       RequestConfiguration.Builder()         .setTestDeviceIds(listOf("ABCDEF012345"))         .build()     )      // Create the "retry" button, which triggers an interstitial between game plays.     retry_button.visibility = View.INVISIBLE     retry_button.setOnClickListener { showInterstitial() }      // Kick off the first play of the "game."     startGame()   }    private fun loadAd() {     var adRequest = AdRequest.Builder().build()      InterstitialAd.load(       this, AD_UNIT_ID, adRequest,       object : InterstitialAdLoadCallback() {         override fun onAdFailedToLoad(adError: LoadAdError) {           Log.d(TAG, adError?.message)           mInterstitialAd = null           mAdIsLoading = false           val error = "domain: ${adError.domain}, code: ${adError.code}, " +             "message: ${adError.message}"           Toast.makeText(             this@MainActivity,             "onAdFailedToLoad() with error $error",             Toast.LENGTH_SHORT           ).show()         }          override fun onAdLoaded(interstitialAd: InterstitialAd) {           Log.d(TAG, "Ad was loaded.")           mInterstitialAd = interstitialAd           mAdIsLoading = false           Toast.makeText(this@MainActivity, "onAdLoaded()", Toast.LENGTH_SHORT).show()         }       }     )   }    // Create the game timer, which counts down to the end of the level   // and shows the "retry" button.   private fun createTimer(milliseconds: Long) {     mCountDownTimer?.cancel()      mCountDownTimer = object : CountDownTimer(milliseconds, 50) {       override fun onTick(millisUntilFinished: Long) {         mTimerMilliseconds = millisUntilFinished         timer.text = "seconds remaining: ${ millisUntilFinished / 1000 + 1 }"       }        override fun onFinish() {         mGameIsInProgress = false         timer.text = "done!"         retry_button.visibility = View.VISIBLE       }     }   }    // Show the ad if it's ready. Otherwise toast and restart the game.   private fun showInterstitial() {     if (mInterstitialAd != null) {       mInterstitialAd?.fullScreenContentCallback = object : FullScreenContentCallback() {         override fun onAdDismissedFullScreenContent() {           Log.d(TAG, "Ad was dismissed.")           // Don't forget to set the ad reference to null so you           // don't show the ad a second time.           mInterstitialAd = null           loadAd()         }          override fun onAdFailedToShowFullScreenContent(adError: AdError?) {           Log.d(TAG, "Ad failed to show.")           // Don't forget to set the ad reference to null so you           // don't show the ad a second time.           mInterstitialAd = null         }          override fun onAdShowedFullScreenContent() {           Log.d(TAG, "Ad showed fullscreen content.")           // Called when ad is dismissed.         }       }       mInterstitialAd?.show(this)     } else {       Toast.makeText(this, "Ad wasn't loaded.", Toast.LENGTH_SHORT).show()       startGame()     }   }    // Request a new ad if one isn't already loaded, hide the button, and kick off the timer.   private fun startGame() {     if (!mAdIsLoading && mInterstitialAd == null) {       mAdIsLoading = true       loadAd()     }      retry_button.visibility = View.INVISIBLE     resumeGame(GAME_LENGTH_MILLISECONDS)   }    private fun resumeGame(milliseconds: Long) {     // Create a new timer for the correct length and start it.     mGameIsInProgress = true     mTimerMilliseconds = milliseconds     createTimer(milliseconds)     mCountDownTimer?.start()   }    // Resume the game if it's in progress.   public override fun onResume() {     super.onResume()      if (mGameIsInProgress) {       resumeGame(mTimerMilliseconds)     }   }    // Cancel the timer if the game is paused.   public override fun onPause() {     mCountDownTimer?.cancel()     super.onPause()   } }

Examples on GitHub

Interstitial ads example: Java | Kotlin

Success stories

Sample use case

Next steps

If you haven't already, create your own interstitial ad unit in the AdMob UI.
Learn about ad targeting and interstitial ad guidance.