Reference (Old Docs)
InterstitialAd
A more recent version of this class is available. Check out the latest version.

InterstitialAd displays an advertisement by Facebook in an interstitial.

To use the interstitial, do the following:

InterstitialAd interstitial = new InterstitialAd(context, PLACEMENT_ID); interstitial.setAdListener(new InterstitialAdListener() { public void onAdLoaded(Ad ad) { if (ad == interstitial) { interstitial.show(); } } // rest of InterstitialAdListener implementation omitted }); interstitial.loadAd();

InterstitialAd requires InterstitialAdActivity to be declared in app's AndroidManifest.xml with android:configChanges="keyboardHidden|orientation".

Extends:Object
Implements:Ad
Package:ads
Constructors
InterstitialAd(Context, String)

Constructs an InterstitialAd using the given context and placement id.

public InterstitialAd(Context context, String placementId)
ParameterDescription
contextAndroid context
placementIdId of ad placement
Instance Methods
setAdListener(InterstitialAdListener)

Sets an InterstitialAdListener to be notified on events in control lifecycle.

public void setAdListener(InterstitialAdListener adListener)
ParameterDescription
adListenerThe listener
setImpressionListener(ImpressionListener)

Sets an ImpressionListener to be notified of impression events in ad control lifecycle.

public void setImpressionListener(ImpressionListener impListener)
ParameterDescription
impListenerThe listener
loadAd()

Loads an ad.

This method always returns immediately. The ad is loaded asynchronously. The control's ad listener will be called when loading finishes or fails.

public void loadAd()
loadAd()
public void loadAd()
destroy()

Destroys the ad control.

This method should be called when the hosting activity of the ad control is destroyed.

public void destroy()
destroy()
public void destroy()
isAdLoaded()

Gets whether an ad is loaded and ready to show.

public boolean isAdLoaded()
Returns
Whether an ad is loaded
show()

Shows the interstitial ad.

This method should only be called after InterstitialAd.loadAd() is called and the listener is notified ad has been loaded.

public boolean show()
Returns
False if no ad is loaded, otherwise true
Constants
SEPARATOR
public static final String SEPARATOR
INTERSTITIAL_DISPLAYED
public static final String INTERSTITIAL_DISPLAYED
INTERSTITIAL_DISMISSED
public static final String INTERSTITIAL_DISMISSED
INTERSTITIAL_CLICKED
public static final String INTERSTITIAL_CLICKED
IMPRESSION_WILL_LOG
public static final String IMPRESSION_WILL_LOG
INTERSTITIAL_UNIQUE_ID_EXTRA
public static final String INTERSTITIAL_UNIQUE_ID_EXTRA
DISPLAY_ROTATION_INTENT_EXTRA
public static final String DISPLAY_ROTATION_INTENT_EXTRA
DISPLAY_WIDTH_INTENT_EXTRA
public static final String DISPLAY_WIDTH_INTENT_EXTRA
DISPLAY_HEIGHT_INTENT_EXTRA
public static final String DISPLAY_HEIGHT_INTENT_EXTRA