本文尚无当前语言版本，相关翻译工作正在进行中，感谢您的理解！

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

Create an application: [Application] -> [App] -> [Add App]Reference: How do I create a new App?
Create an ad placement：[Application] -> [Ad Placements] -> [Add Ad Placement] -> [Interstitial Ads]Reference: How do I create an ad placement?

Pangle Platform Parameter Setting：

Orientation: Select the orientation of the video.

Interstitial Ad Implementation

The main steps to integrate interstitial ads are:

Create PAGInterstitialRequest object

Load an Interstitial ad

Display the ad.

Load an Interstitial Ad

Loading an ad is accomplished using the loadAdWithSlotID: request: completionHandler:() method in the PAGLInterstitialAd class. The method requires an ad slot id, an instance object of PAGInterstitialRequest, and a block 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

Load an ad and Register completionHandler callback

Note: After using PAGLInterstitialAd, it should be set to nil, such as after the adDidDismiss callback.

The description of callback

callback	description
error	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
interstitialAd	This object is returned when an ad material is loaded successfully.

Register PAGLInterstitialAdDelegate 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 PAGLInterstitialAdDelegate callback

callback	description
- (void)adDidShow:(PAGLInterstitialAd *)ad	This method is invoked when the ad is displayed, covering the device's screen.
- (void)adDidClick:(PAGLInterstitialAd *)ad	This method is invoked when the ad is clicked by the user.
- (void)adDidDismiss:(PAGLInterstitialAd *)ad	This method is invoked when the ad disappears.

Display the Ad

Test with test ads

Now you have finished the integration. If you wanna test your apps, make sure you use test ads rather than live, production ads. The easiest way to load test ads is to use test mode. It's been specially configured to return test ads for every request, and you're free to use it in your own apps while coding, testing, and debugging.

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