Interstitial Ads

We support both static and video interstitial ads. Follow the instructions below to set up interstitial ads.

Set up Interstitial Ad🔗

1. From the left navigation, select Inventory Inventory Settings.
2. Search for the app or website you would like to create a placement for and click + Add a placement.
3. Click Select Ad Unit and select Interstitial.
4. Click Add a placement to start setting up your Interstitial settings. After you create the Interstitial placement, you can see the placement ID.

    

Add Interstitial Ad to your App🔗

Creating an Interstitial Ad

The IMInterstitial is simply a UIViewController subclass displaying full-screen ads that respond to user touch.

Follow these steps to create the interstitial ad unit programmatically:

1. Import the headers and declare an interstitial instance in your ViewController.h / ViewController.swift file. Your ViewController header file should look like this:

   • Objective C
   • Swift

   Objective C

   #import  <UIKit/UIKit.h> 
   @import InMobiSDK; 
   @interface ViewController : UIViewController <IMInterstitialDelegate> 
   @property (nonatomic, strong) IMInterstitial *interstitial; 
   @end
   Copy

   Swift

   import UIKit
   import InMobiSDK
   class ViewController: UIViewController, IMInterstitialDelegate {
       var interstitial: IMInterstitial?
   }
   	Copy

2. Instantiate the interstitial object. Your viewDidLoad method in ViewController.m file should look like this:
    

   • Objective C
   • Swift

   Objective C

   -(void)viewDidLoad { 
       [super viewDidLoad]; 
       self.interstitial = [[IMInterstitial alloc] initWithPlacementId:<Insert your placement ID here>]; 
       self. interstitial.delegate = self; 
       [self.interstitial load]; 
   } 
   Copy

   Swift

   override func viewDidLoad() { 
       super.viewDidLoad() 
       interstitial = IMInterstitial.init(placementId: <Insert your placement ID here>) 
       interstitial?.delegate = self 
       interstitial?.load() 
   } 
   Copy

3. For ad status callbacks, implement the delegate methods of IMInterstitialDelegate. Here are the supported callbacks:

   • Objective C
   • Swift

   Objective C

   // Notifies that the ad is received with Meta info. 
   - (void)interstitial:(IMInterstitial *)interstitial didReceiveWithMetaInfo:(IMAdsMetaInfo*)metaInfo { 
       NSLog(@"interstitial didReceiveAdWithMetaInfo"); 
   } 
   - (void)interstitialDidFinishLoading:(IMInterstitial *)interstitial { 
       NSLog(@"interstitialDidFinishLoading"); 
   } 
   - (void)interstitial:(IMInterstitial *)interstitial didFailToLoadWithError:
   (IMRequestStatus *)error { 
       NSLog(@"Interstitial failed to load ad"); 
       NSLog(@"Error : %@",error.description); 
   } 
   - (void)interstitial:(IMInterstitial *)interstitial didFailToPresentWithError:
   (IMRequestStatus *)error { 
       NSLog(@"Interstitial didFailToPresentWithError"); 
       NSLog(@"Error : %@",error.description); 
   } 
   - (void)interstitialWillPresent:(IMInterstitial *)interstitial { 
       NSLog(@"interstitialWillPresent"); 
   } 
   - (void)interstitialDidPresent:(IMInterstitial *)interstitial { 
       NSLog(@"interstitialDidPresent"); 
   } 
   - (void)interstitialWillDismiss:(IMInterstitial *)interstitial { 
       NSLog(@"interstitialWillDismiss"); 
   } 
   - (void)interstitialDidDismiss:(IMInterstitial *)interstitial { 
       NSLog(@"interstitialDidDismiss"); 
   } 
   - (void)userWillLeaveApplicationFromInterstitial:(IMInterstitial *)interstitial { 
       NSLog(@"userWillLeaveApplicationFromInterstitial"); 
   } 
   - (void)interstitial:(IMInterstitial *)interstitial didInteractWithParams:
   (NSDictionary *)params { 
       NSLog(@"InterstitialDidInteractWithParams"); 
   }
   Copy

   Swift

   public func interstitialDidReceiveAd(_ interstitial: IMInterstitial) {
           print("[ViewController %@] \(#function)")
       }
       public func interstitialDidFinishLoading(_ interstitial: IMInterstitial) {
           print("[ViewController %@] \(#function)")
       }
       public func interstitial(_ interstitial: IMInterstitial, didFailToLoadWithError error: IMRequestStatus) {
           print("[ViewController %@] \(#function)")
           print("Interstitial ad failed to load with error \(error)" )
       }
       public func interstitialWillPresent(_ interstitial: IMInterstitial) {
           print("[ViewController %@] \(#function)")
       }
       public func interstitialDidPresent(_ interstitial: IMInterstitial) {
           print("[ViewController %@] \(#function)")
       }
       public func interstitial(_ interstitial: IMInterstitial, didFailToPresentWithError error: IMRequestStatus) {
           print("[ViewController %@] \(#function)")
           print("Interstitial ad failed to present with error \(error)" )
       }
       public func interstitialWillDismiss(_ interstitial: IMInterstitial) {
           print("[ViewController %@] \(#function)")
       }
       public func interstitialDidDismiss(_ interstitial: IMInterstitial) {
           print("[ViewController %@] \(#function)")
       }
       public func interstitial(_ interstitial: IMInterstitial, didInteractWithParams params: [String : Any]?) {
           print("[ViewController %@] \(#function)")
       }
       public func interstitial(_ interstitial: IMInterstitial, rewardActionCompletedWithRewards rewards: [String : Any]) {
           print("[ViewController %@] \(#function)")
       }
       public func userWillLeaveApplicationFromInterstitial(_ interstitial: IMInterstitial) {
           print("[ViewController %@] \(#function)")
       }
   Copy

4. To show the Interstitial Ad, use the following code:

   • Objective C
   • Swift

   Objective C

   [self.interstitial showFrom:self];
   [self.interstitial showFrom:self with:IMInterstitialAnimationTypeAsNone];
   
   Copy

   Swift

   interstitial?.show(from: self)
   //interstitial?.show(from: self, with:.coverVertical)
   
   Copy