Pangle: A global platform dedicated to developer growth.|Integration Docs
Knowledge Center

Interstitial Ads

Introduction

Interstitial Ads are a visually immersive advertising format that covers the interface of an app until closed by the user. While an Interstitial Ad can be skipped after a predetermined time limit of 5 seconds, it is designed to capture the user's attention fully, promoting an enhanced user experience.

Typically, Interstitial Ads are displayed at natural transition points within the app, such as between activities or during a game's pause between levels. By leveraging this optimal positioning, the Interstitial Ad can elicit a higher engagement rate and ensure that users remain fully immersed in the app's flow.

When an Interstitial Ad is displayed, the user is provided with a clear and concise choice to either tap on the ad and continue to its destination or close it and return to the app. This aspect of Interstitial Ads enhances the user's sense of control over the ad experience, increasing the likelihood of positive user sentiment towards the ad and ultimately benefiting the publisher's monetization efforts.

Precondition

Create an app and Interstitial ad placement on the Pangle platform

Pangle Platform Parameter Setting:

  • Orientation: Select the orientation of the video.

Interstitial Ad Implementation

  1. Create PAGInterstitialRequest object
  1. Load an Interstitial ad and Register PAGInterstitialAdLoadListener callbacks.
  2. Register ad event callbacks.
  3. Display the ad.

Load an Interstitial Ad

Loading an ad is accomplished using the load() method in the PAGInterstitialAd class. The load() method requires an ad slot id, an instance object of PAGInterstitialRequest, and a PAGInterstitialAdLoadListener to be notified when ad loading succeeds or fails. The loaded PAGInterstitialAd object is provided as a parameter in the success callback.

Create PAGInterstitialRequest object

PAGInterstitialRequest is an Ad Loading Manager. It is recommended to be the member variable of the Activity.

Load an ad and Register PAGInterstitialAdLoadListener callback

Use the method of PAGInterstitialAd to load the ad, and register the PAGInterstitialAdLoadListener callback.

Note: After the waterfall interstitial Ad is displayed or closed, Pangle SDK will automatically start a new ad request for the next display chance, please turn off the self-built Pre-loading logic.

The description of PAGInterstitialAdLoadListener callback

PAGInterstitialAdLoadListener

description

onError

This method is invoked when an ad fails to load. It includes an error parameter of type Error that indicates what type of failure occurred. For more information, refer to the ErrorCode section

onAdLoaded

This method is executed when an ad material is loaded successfully.

Register Ad Event Callback

Ad event callbacks need to be registered before displaying an ad. Each method in the event callback corresponds to an event in the ad lifecycle.

The description of PAGInterstitialAdInteractionListener callback

PAGInterstitialAdInteractionListener

description

onAdShowed

This method is invoked when the ad is displayed, covering the device's screen.

onAdClicked

This method is invoked when the ad is clicked by the user.

onAdDismissed

This method is invoked when the ad disappears.

Display the Ad

An instance of the PAGInterstitialAd object will be returned when the ad is loaded successfully. Call the show()method of PAGInterstitialAd to render the ad and it needs to pass in activity, and it must be called in the main thread.

Test with test ads

Upon completing the integration, it is essential to ensure that you test your app functionality prior to launching it to end users. It is highly recommended that you employ test ads rather than live ads.

To facilitate the testing process, Pangle offers a "test mode" that is specifically designed to generate test ads for every request. You can seamlessly implement this mode in your app during the coding, testing, and debugging phase, and gain confidence that your app's ad functionality is fully operational before deploying it to end users.

Refer to the How to add a test device? to add your device to the test devices on the Pangle platform.