MPInterstitialAdControllerDelegate /5.7.0

@protocol MPInterstitialAdControllerDelegate <MPMoPubAdDelegate>

The delegate of an MPInterstitialAdController object must adopt the MPInterstitialAdControllerDelegate protocol.

The optional methods of this protocol allow the delegate to be notified of interstitial state changes, such as when an ad has loaded, when an ad has been presented or dismissed from the screen, and when an ad has expired.

Public Methods

Detecting When an Interstitial Ad is Loaded

-/interstitialDidLoadAd: /+1.11.1.0

  • Description: Sent when an interstitial ad object successfully loads an ad.

  • Declaration:

    - (void)interstitialDidLoadAd:(MPInterstitialAdController *)interstitial;
    
  • Parameters:

    • interstitial: The interstitial ad object sending the message.

-/interstitialDidFailToLoadAd: /+1.11.1.0

  • Description: Sent when an interstitial ad object fails to load an ad.

  • Declaration:

    - (void)interstitialDidFailToLoadAd:(MPInterstitialAdController *)interstitial;
    
  • Parameters:

    • interstitial: The interstitial ad object sending the message.

-/interstitialDidFailToLoadAd:withError: /+1.11.1.0

  • Description: Sent when an interstitial ad object fails to load an ad.

  • Declaration:

    - (void)interstitialDidFailToLoadAd:(MPInterstitialAdController *)interstitial
                            withError:(NSError *)error;
    
  • Parameters:

    • interstitial: The interstitial ad object sending the message.
    • error: The error that occurred during the load.

Detecting When an Interstitial Ad is Presented

-/interstitialWillAppear: /+1.11.1.0

  • Description: Sent immediately before an interstitial ad object is presented on the screen. Your implementation of this method should pause any application activity that requires user interaction.

  • Declaration:

    - (void)interstitialWillAppear:(MPInterstitialAdController *)interstitial;
    
  • Parameters:

    • interstitial: The interstitial ad object sending the message.

-/interstitialDidAppear: /+1.11.1.0

  • Description: Sent after an interstitial ad object has been presented on the screen.

  • Declaration:

    - (void)interstitialDidAppear:(MPInterstitialAdController *)interstitial;
    
  • Parameters:

    • interstitial: The interstitial ad object sending the message.

Detecting When an Interstitial Ad is Dismissed

-/interstitialWillDisappear: /+1.11.1.0

  • Description: Sent immediately before an interstitial ad object will be dismissed from the screen.

  • Declaration:

    - (void)interstitialWillDisappear:(MPInterstitialAdController *)interstitial;
    
  • Parameters:

    • interstitial: The interstitial ad object sending the message.

-/interstitialDidDisappear: /+1.11.1.0

  • Description: Sent after an interstitial ad object has been dismissed from the screen, returning control to your application. Your implementation of this method should resume any application activity that was paused prior to the interstitial being presented on screen.

  • Declaration:

    - (void)interstitialDidDisappear:(MPInterstitialAdController *)interstitial;
    
  • Parameters:

    • interstitial: The interstitial ad object sending the message.

Detecting When an Interstitial Ad Expires

-/interstitialDidExpire: /+5.7.0

  • Description: Sent when a loaded interstitial ad is no longer eligible to be displayed. Interstitial ads from certain networks may expire their content at any time, even if the content is currently on screen. This method notifies you when the currently loaded interstitial has expired and is no longer eligible for display. If the ad was on screen when it expired, you can expect that the ad will already have been dismissed by the time this message is sent. Your implementation may include a call to loadAd to fetch a new ad, if desired.

  • Declaration:

    - (void)interstitialDidExpire:(MPInterstitialAdController *)interstitial;
    
  • Parameters:

    • interstitial: The interstitial ad object sending the message.

-/interstitialDidReceiveTapEvent: /+3.0.0

  • Description: Sent when the user taps the interstitial ad and the ad is about to perform its target action. This action may include displaying a modal or leaving your application. Certain ad networks may not expose a “tapped” callback, so you should not rely on this callback to perform critical tasks.

  • Declaration:

    - (void)interstitialDidReceiveTapEvent:
        (MPInterstitialAdController *)interstitial;
    
  • Parameters:

    • interstitial: The interstitial ad object sending the message.

Last updated July 10, 2020

TWITTER, MOPUB, and the Bird logo are trademarks of Twitter, Inc. or its affiliates. All third party logos and trademarks included are the property of their respective owners.

© 2020 MoPub (a division of Twitter, Inc.)