com.google.ads.mediation
Interface MediationInterstitialListener


public interface MediationInterstitialListener

Callback for an adapter to communicate back to the mediation library. Events must be communicated back for the mediation library to properly manage ad flow.


Method Summary
 void onDismissScreen(MediationInterstitialAdapter<?,?> adapter)
          Indicates that the ad control rendered something in full screen and is now transferring control back to the application.
 void onFailedToReceiveAd(MediationInterstitialAdapter<?,?> adapter, AdRequest.ErrorCode error)
          Indicates that an ad request has failed along with the underlying cause.
 void onLeaveApplication(MediationInterstitialAdapter<?,?> adapter)
          Indicates that the ad is causing the device to switch to a different application (such as a web browser).
 void onPresentScreen(MediationInterstitialAdapter<?,?> adapter)
          Indicates that the ad control is rendering something that is full screen.
 void onReceivedAd(MediationInterstitialAdapter<?,?> adapter)
          Indicates that an ad has been requested and successfully received.
 

Method Detail

onReceivedAd

void onReceivedAd(MediationInterstitialAdapter<?,?> adapter)
Indicates that an ad has been requested and successfully received. Interstitials must wait for a InterstitialAd.show() call.

Once an ad is requested, the adapter must report either success or failure. If no response is heard within a time limit, the mediation library may move on to another adapter, resulting in a potentially successful ad not being shown.

From the point when this method is called until the adapter is destroyed, MediationInterstitialAdapter.showInterstitial() should open the interstitial.

Parameters:
adapter - The mediation adapter which raised the event.
See Also:
onFailedToReceiveAd(MediationInterstitialAdapter, AdRequest.ErrorCode)

onFailedToReceiveAd

void onFailedToReceiveAd(MediationInterstitialAdapter<?,?> adapter,
                         AdRequest.ErrorCode error)
Indicates that an ad request has failed along with the underlying cause. A failure may be an actual error or just a lack of fill.

Once an ad is requested, the adapter must report either success or failure. If no response is heard within a time limit, the mediation library may move on to another adapter, resulting in a potentially successful ad not being shown.

Parameters:
adapter - The mediation adapter which raised the event.
error - An error code detailing the cause of the failure.
See Also:
onReceivedAd(MediationInterstitialAdapter)

onPresentScreen

void onPresentScreen(MediationInterstitialAdapter<?,?> adapter)
Indicates that the ad control is rendering something that is full screen. This may be an Activity, or it may be a precursor to switching to a different application.

Once this screen is dismissed, onDismissScreen(MediationInterstitialAdapter) must be called.

Parameters:
adapter - The mediation adapter which raised the event.

onDismissScreen

void onDismissScreen(MediationInterstitialAdapter<?,?> adapter)
Indicates that the ad control rendered something in full screen and is now transferring control back to the application. This may be the user returning from a different application.

Parameters:
adapter - The mediation adapter which raised the event.
See Also:
onPresentScreen(MediationInterstitialAdapter)

onLeaveApplication

void onLeaveApplication(MediationInterstitialAdapter<?,?> adapter)
Indicates that the ad is causing the device to switch to a different application (such as a web browser). This must be called before the current application is put in the background.

Parameters:
adapter - The mediation adapter which raised the event.