windows-guidelines | Interstitial Ads

Interstitial ads are full page ads placed at natural break points in the app flow. With 10 times the real estate compared to banner ads, Interstitial ads are guaranteed to catch your users' eyes and drive higher revenue for your mobile business!


Follow these steps to start monetizing with Interstitial ads:

  1. Setting up an Interstitial Ad in the UI
  2. Creating an Interstitial Ad
  3. Testing the Integration

Step 1. Setting up an Interstitial Ad in the UI

  1. Go to the Inventory tab in the nav bar and press + next to the app you want to add your Interstitial ad placement to.

  2. Select Add Placement in the aerWall (Rewarded or Non-Rewarded) placement section.

    Note: The UI enables you to add multiple placements in step 2 before continuing to step 3.

  3. Fill in the details in the following fields. Some of them are optional. Read the descriptions to understand the functionality of each field:
    • Name - A unique name that will help identify this placement.
    • Ad Type: Determines the types of creatives that can be shown in the placement.
    • Skippable: A flag that indicates if the video ad can be skipped.
    • Skip Duration: Specifies the time in seconds when the skip button will appear in the interstitial.
    • Video Duration: Specifies the video lengths that can be returned to a placement.
    • Default Video to Mute: A flag that indicates if the video should start with sound off. Checking this box indicates that the video should be muted while starting.
    • Frequency Cap - Limits the amount of times an ad can be delivered to a specific user in a given duration.
    • COPPA Compliance - A flag to determine if the section of the app where this placement resides, needs to be COPPA compliant. Checking this box indicates that the placement needs COPPA compliance.
    • Ad Mode - This toggle will enable display of test ads on your placement.

      WARNING: If enabled, the placement will only show test ads. These test ads do not have revenue associated with them and should be used strictly for testing purposes.

    • It’s an Audience Bidder Placement - This field should remain unchecked and is not relevant to the Windows SDK.

Step 2. Creating an Interstitial Ad

The InMobi SDK provides a programmatic instantiation of the Interstitial ad.

Let's take a look at the steps required to create and show an Interstitial ad.

  1. Import the header and create an Interstitial:

    Import the InMobi.Ads header, and declare an instance of IMInterstitial.

    It should look similar to the below code snippet:

    using InMobi.Ads;
    // <additional headers here>
    namespace <namespace_here> {
    		public sealed partial class AdRequestTesting: Page {
    		    private IMInterstitial interstitial;
            // rest of your code below
        }
    }
    		
  2. Instantiate the Interstitial object:

    The Interstitial object can be instantiated with the following method provided in the IMInterstitial class:

    public IMInterstitial(string placementId)
    		

    Param Definitions::

    1. placementId: A placement ID is a unique ID that defines a specific place in your application where an ad will be served.
    2. Recommended: You may register the Interstitial to the following events:
      interstitial.OnAdLoadSucceeded += Interstitial_OnAdLoaded;
      interstitial.OnAdLoadFailed += Interstitial_OnAdFailed;
      interstitial.OnAdWillDisplay += Interstitial_OnAdWillDisplay;
      interstitial.OnAdDisplayed += Interstitial_OnAdDisplayed;
      interstitial.OnAdDismissed += Interstitial_OnAdDismissed;
      interstitial.OnAdDisplayFailed += Interstitial_OnAdDisplayFailed;
      interstitial.OnAdInteraction += Interstitial_OnAdInteraction;
      interstitial.OnAdWillLeaveApplication += Interstitial_OnAdWillLeaveApplication;
      interstitial.OnRewardsUnlocked += _Interstitial_onRewardsUnlocked;
      			

      These events are triggered in following situations:

      a. OnAdLoadSucceeded: When the Interstitial ad is fully loaded.

      b. OnAdLoadFailed: When the Interstitial ad has failed to load due to some error.

      c. OnAdWillDisplayed: When the Interstitial ad is about to present full screen content.

      d. OnAdDisplayed: When the ad Interstitial model view has presented the full screen content.

      e. OnAdDismissed: When the Interstitial ad view has been dismissed.

      f. OnAdDisplayFailed: When the Interstitial ad has failed to present due to some error.

      g. OnAdInteraction: When the user interacts with the Interstitial ad. (i.e. click)

      h. OnAdWillLeaveApplication: When the app is about to leave the application after the Interstitial ad is clicked.

      i. OnRewardsUnLocked: When the user has performed the required action to receive the reward.

  3. Loading the Interstitial Ad:

    Displaying an Interstitial ad is a two-step process.

    1. The first step is to call the loadAd method on the IMInterstitial object.
      interstitial.LoadAd();
      			

      Note: The above callback can result in a success or a failure.

    2. If the call was successful, the second step is to call the ShowAd method on the IMInterstitial object to show the ad. An example is demonstrated next:
      private void Interstitial_OnAdLoaded(object sender, string e) {
          interstitial.ShowAd();
      }
      			

      Should the ad call fail for any reason, the failure is reported in the following method:

      private void Interstitial_OnAdFailed(object sender, FailureCode e) {
          // <your code to handle failure state>
      }
      			

      Failure indicates an exception in loading the Interstitial ad. Once a failure is encountered, showing the Interstitial ad is not possible.

Step 3. Testing the Integration

The Banner placement can be set to Test mode in order to test your integration.

Note: The default setting for a placement is Live.

When any placement is in Test mode, the placement will only show test ads.

These test ads do not have revenue associated with them and should be used strictly for testing purposes!

To switch a placement’s Ad Mode:

  • Go to the placement edit page
  • Find the “Ad Mode” toggle and switch to Test
  • Select “Confirm” from the reminder dialogue box.
  • Press “Save” on the placement edit page.
  • Once testing is complete, remember to switch the placement’s “Ad Mode” back to Live to start monetizing the placement.