Banner Integration for Adobe Air

Banners are a rectangular, system-initiated ads that can be either static or animated, and are served in a designated area around your live app content. 

Integrate and serve Banner ads through ironSource Mediation in a few easy steps:

1. Implement the Banner Events
2. Load Banner Ad
3. Destroy the Banner Ad
4. Integrate a Banner Provider

Step 1. Implement the Banner Events

The ironSource Air Plugin fires several events to inform you of ad availability and activity. To listen to any event, call the following method:

IronSource.instance.addEventListener( "EventName", functionToCall  );

The Plugin will notify the Listener of all possible events listed below:

IronSource.instance.addEventListener("onBannerAdLoaded", onBannerAdLoaded);
IronSource.instance.addEventListener("onBannerAdLoadFailed", onBannerAdLoadFailed);
IronSource.instance.addEventListener("onBannerAdClicked", onBannerAdClicked);
IronSource.instance.addEventListener("onBannerAdScreenPresented", onBannerAdScreenPresented);
IronSource.instance.addEventListener("onBannerAdScreenDismissed", onBannerAdScreenDismissed);
IronSource.instance.addEventListener("onBannerAdLeftApplication", onBannerAdLeftApplication);

Implementation:

//Invoked once the banner has loaded
private function onBannerAdLoaded(event:DataEvent):void {}
//Invoked when the banner loading process has failed.
private function onBannerAdLoadFailed(event:DataEvent):void {
    var errorCode:String;
    var errorDescription:String;
    if (event.data) {
        var error:Object = JSON.parse(event.data);
        errorDescription = error.error_description;
        errorCode = error.error_code;
     }
}
// Invoked when end user clicks on the banner ad
private function onBannerAdClicked(event:DataEvent):void {}
//Notifies the presentation of a full screen content following user click
private function onBannerAdScreenPresented(event:DataEvent):void {}
//Notifies the presented screen has been dismissed
private function onBannerAdScreenDismissed(event:DataEvent):void {}
//Invoked when the user leaves the app
private function onBannerAdLeftApplication(event:DataEvent):void {}

Step 2. Load Banner Ad

To load a Banner ad, call the following method:

IronSource.instance.loadBanner(IronSource.SIZE_BANNER, IronSource.POSITION_BOTTOM);

Banner Dimensions & Position

When loading the banner, make sure to configure your Banner Size and Position:

Banner Placements

We support placements, as well as capping and pacing for Banners on the ironSource dashboard. Learn how to set up placements, capping and pacing for Banners to optimize your app’s user experience here.

If you’ve set up placements for your Banner, call the following method to serve a Banner ad in a specific location:

IronSource.instance.loadBanner(IronSource.SIZE_BANNER, IronSource.POSITION_BOTTOM, YOUR_PLACEMENT_NAME);

You will receive the onBannerAdLoaded and the banner will show on your app.

Hide & Display Banner

In order to provide maximum flexibility in the ad experience, you now have the ability to hide and present banners on your app.

Once you’ve loaded and served a banner, you can choose to hide this banner and re-show it at a later point in your app.

To hide the banner, call this function:

IronSource.instance.hideBanner();

To then show this same banner again, call this function:

IronSource.instance.displayBanner();

Step 3. Destroy the Banner Ad

Once you’ve successfully served a Banner, we recommend calling the below function to destroy the previous Banner.

IronSource.instance.destroyBanner();

After you call this method, the Banner in question can no longer be used. In the case you want to serve it again, you will need to request a new Banner using the loadBanner method.

Step 4.  Integrate a Banner Provider

Next, integrate the ad network adapters to serve Banners through ironSource Mediation. We currently support Admob, AppLovin.

Done!
You are now all set up to serve Banners in your application. Verify your integration with our Integration Helper.

What’s Next? 

Follow our integration guides to integrate additional ad units:

• Rewarded Video
• Interstitial
• Offerwall

Interested in integrating more mediation adapters? Check out our supported Mediation Networks.