App Open Ads

💡 Pangle SDK supports App Open Ads from version 4300 and above, this doc is for developers who use Pangle SDK directly, if you use mediation to integrate Pangle, please jump to the link.

Introduction

App open ads are a special ad format intended for publishers wishing to monetize their app load screens. App open ads can be closed at any time, and are designed to be shown when your users bring your app to the foreground.

Precondition

Create an app and App Open ad placement on 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] -> [App Open Ads]

Reference：How do I create an ad placement?

App Open Ads Implementation

The main steps to integrate App Open ads are:

Import BUADSDK

Set Host APPIcon

Load ad data using BUAppOpenAd
Register Ad Event Callbacks
After the data is loaded, use the BUAppOpenAd display ads content

Set Host APPIcon

set the host app icon when initializing the Pangle SDK.

Tips: Please follow the code below to set the appLogoImage , otherwise the logo image won't be displayed in the App open ad.

Load an ad

Load ad data using BUAppOpenAd object calls loadOpenAdWithTimeout method request.

The loadOpenAdWithTimeout method needs to pass in AdSlot, completionHandler callback, and timeout parameters.

The completionHandler callback includes BUAppOpenAd and NSError objects.

After the data is loaded, use the BUAppOpenAd display ads content.

Create the AdSlot Object

Load ad data using BUAppOpenAd

App Open ad timeout recommended >=3s

“error”parameter, which includes an error parameter of type error indicating what type of failure occurred. See the Error Codes section for details.

Register Ad Event Callbacks

Once the ad is loaded, these ad event callbacks provided by the protocol BUAppOpenAdDelegate will be invoked at the corresponding time to notify its delegate.

BUAppOpenAdDelegate callback Instruction

BUAppOpenAdDelegate callback	Description
didPresentForAppOpenAd:	This method is invoked when the ad is displayed, covering the device's screen.
didClickForAppOpenAd:	This method is invoked when the ad is clicked by the user.
didClickSkipForAppOpenAd:	This method is called when the user clicks the skip button.
countdownToZeroForAppOpenAd:	Ad countdown ends

Show Ad

After the data is loaded, use the BUAppOpenAd display ads content and it needs to pass in the displayed VC.

Refer to the Demo example

For a specific example of loading APP Open Ads, see BUDAppOpenAdViewController、BUDAppOpenAdManager in Demo.

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 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 Pangle platform.