App Open Ads

Introduction

App Open Ads constitute a distinctive ad format that caters to publishers seeking to monetize their app load screens. These ads are strategically positioned to be exhibited when your users switch to your app and may be terminated at any point.

Precondition

Create an app and App Open 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] -> [App Open Ads]Reference: How do I create an ad placement?

App Open Ads Implementation

The main steps to integrate App Open ads are:

• Set the host app icon

• Create the object of PAGOpenAdRequest

• Load an ad and register PAGAppOpenAdLoadListener callback

• Register PAGAppOpenAdInteractionListener callback

• Show the ad

• Destroy Ad

Set Host APPIcon

Please set the host app icon when initializing the Pangle SDK

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

var config = new PAGConfig.Builder()

    ...

    .SetAppIconName(...)

    ...

    .Build();

Create the PAGOpenAdRequest Object

PAGOpenAdRequest is an Ad Loading Manager. It is recommended to be the member variable of the Activity. This class can configure the load timeout period.

xxxxxxxxxx

var request = new PAGAppOpenRequest

{

    //set timeout

    Timeout = 5000

};

//request an ad

_appOpenAd?.Load(request);

Load an ad and Register PAGAppOpenAdLoadListener callback

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

//create PAGAppOpenAd object，write the slot id

PAGAppOpenAd _appOpenAd = new PAGAppOpenAd(slotId)

{

    //Set whether the callback event switches to the unity main thread, true means switching to the main thread, false means not switching, the default is true

    CallbackOnMainThread = false

};

​

_appOpenAd.OnLoad += (() =>

{

    Debug.Log("[PAGAppOpen]-[Load]:successfully");

    ShowAppOpenAd();

});

​

_appOpenAd.OnLoadFailed += ((code, msg) =>

{

    Debug.Log($"[PAGAppOpen]-[Load]:failed， code ={code}, error message = {msg}");

});

​

​

The description of PAGAppOpenAdLoadListener

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.

xxxxxxxxxx

_appOpenAd.OnAdShowed += (() => { Debug.Log("[PAGAppOpen]-[interaction]:show"); });

​

_appOpenAd.OnAdClicked += (() => { Debug.Log("[PAGAppOpen]-[interaction]:click"); });

​

_appOpenAd.OnAdDismissed += (() => { Debug.Log("[PAGAppOpen]-[interaction]:dismiss"); });

The description of PAGAppOpenAdInteractionListener callback

Show Ad

An instance of the PAGAppOpenAd 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 into activity.

xxxxxxxxxx

_appOpenAd?.Show();

Destroy Ad

Destroy advertisements in time to avoid memory leaks.

xxxxxxxxxx

_appOpenAd?.DestroyAd();

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.