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.
Before You Start
- Make sure that you have correctly integrated the ironSource Air Plugin into your application. Integration is outlined here.
- You will need to integrate one of our mediation adapters with Banner support to serve this ad unit.
Step 1. Load Banner Ad
To load a Banner ad, call the following method:
- Load the Banner view by calling this method (in this example it’s the BANNER banner size):
IronSource.instance.loadBanner(IronSourceBannerSize.BANNER, IronSourceBannerPosition.BOTTOM);
See table below for details about our supported standard banner sizes:IronSourceBannerSize Description Dimensions (WxH) (points in iOS, dp in Android) BANNER Standard Banner 320 x 50 LARGE Large Banner 320 x 90 RECTANGLE Medium Rectangular Banner 300 x 250 SMART
Smart Banner
(Adjusted for both mobile and tablet)iOS:
If (iPhone) 320 x 50
If (iPad) 728 x 90
Android:
If (screen height ≤ 720) 320 x 50
If (screen height > 720) 728 x 90See table below for details about our supported standard banner positions:
IronSourceBannerPosition Description TOP Banner will be positioned at the top center of the screen BOTTOM Banner will be positioned at the bottom center of the screen - Another option is initiating the banner with Custom size, using this signature (WxH) (points in iOS, dp in Android):
IronSource.instance.loadBanner(new IronSourceBannerSize(320, 50), IronSourceBannerPosition.BOTTOM);
You will receive the onBannerAdLoadedEvent
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.
Unlike with the Android and iOS native implementations, when banner is loaded for the first time in Unity, it will show itself, and there won’t be a need to call displayBanner().
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 2. 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 );
- EventName is a string containing the event you want to listen to.
- functionToCall is the function to call when the event is fired.
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 3. Additional Load Settings
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(IronSourceBannerSize.BANNER, IronSourceBannerPosition.BOTTOM, (string) "YOUR_PLACEMENT_NAME");
Step 4. Destroy the Banner Ad
To destroy a banner, call the following method:
IronSource.instance.destroyBanner();
A destroyed banner can no longer be loaded. If you want to serve it again, you must initiate it again.
Step 5. Integrate a Banner Provider
Next, integrate the ad network adapters to serve Banners through ironSource Mediation. We currently support ironSource, Admob, AppLovin, Facebook, Fyber and Inmobi Banners.
For better understanding of bannerSize’s behaviour per network, please follow tables (one for iOS, another for Android):
iOS | BANNER | LARGE | RECTANGLE | SMART |
ironSource | Banner | Large | Banner / Leaderboard | |
AdMob | Banner | Large Banner | IAM Medium Rectangle | Banner / Leaderboard |
AppLovin | Banner | Banner | Medium Rectangle | Banner / Leader |
Standard Banner | Large Banner | Medium Rectangle | Banner / Leader | |
Fyber | Banner | Banner | Medium Rectangle | Banner / Leader |
InMobi | Banner_320_50 | Banner_320_50 | Banner_300_250 | Banner_320_50 / Banner_728_90 |
Android | BANNER | LARGE | RECTANGLE | SMART |
ironSource | Banner | Large | Banner / Leaderboard |
|
AdMob | Banner | Large Banner | IAM Medium Rectangle | Banner / Leaderboard |
AppLovin | Banner | Banner | Medium Rectangle | Banner / Leader |
Standard Banner | Large Banner | Medium Rectangle | Banner / Leader | |
Fyber | Banner | Banner | Medium Rectangle | Banner / Leader |
InMobi | Banner_320_50 | Banner_320_50 | Banner_300_250 | Banner_320_50 / Banner_728_90 |
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:
Interested in integrating more mediation adapters? Check out our supported Mediation Networks.