Banner integration for Adobe Air
Integrate banner ads by initializing the SDK, creating banner ad objects post-initialization, and setting appropriate ad sizes and positions.
Read time 3 minutesLast updated 4 hours ago
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 Unity LevelPlay by completing the following steps:
- Implement the Banner Events
- Load Banner Ad
- Destroy the Banner Ad
- Integrate a Banner Provider
Prerequisites
- Ensure that you have correctly integrated the ironSource Air Plugin into your application. Integration is outlined here.
- Integrate one of our mediation adapters with Banner support to serve this ad unit.
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 );
Note
- 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("levelPlayBannerAdLoaded", levelPlayBannerAdLoaded); IronSource.instance.addEventListener("levelPlayBannerAdLoadFailed", levelPlayBannerAdLoadFailed); IronSource.instance.addEventListener("levelPlayBannerAdClicked", levelPlayBannerAdClicked); IronSource.instance.addEventListener("levelPlayBannerAdLeftApplication", levelPlayBannerAdLeftApplication); IronSource.instance.addEventListener("levelPlayBannerAdScreenPresented", levelPlayBannerAdScreenPresented); IronSource.instance.addEventListener("levelPlayBannerAdScreenDismissed", levelPlayBannerAdScreenDismissed);
private function levelPlayBannerAdLoaded(event:Event):void { //level Play Banner Ad Loaded } private function levelPlayBannerAdLoadFailed(event:Event):void { //level Play Banner Ad Load Failed } private function levelPlayBannerAdClicked(event:Event):void { //level Play Banner Ad Clicked } private function levelPlayBannerAdLeftApplication(event:Event):void { //level Play Banner Ad Left Application } private function levelPlayBannerAdScreenPresented(event:Event):void { //level Play Banner Ad Screen Presented } private function levelPlayBannerAdScreenDismissed(event:Event):void { //level Play Banner Ad Screen Dismissed }
Step 2. Load Banner Ad
To load a Banner ad, call the following method:IronSource.instance.loadBanner(IronSourceBannerSize.BANNER, IronSource.POSITION_BOTTOM);
Banner Dimensions & Position
When loading the banner, make sure to configure your Banner Size and Position:Sizes | Description | Dimensions | Ad Network Support |
|---|---|---|---|
| BANNER | Standard Banner Best for Phones & Tablets | 50 X screen width | AppLovin, Digital Turbine, Google, Liftoff Monetize, Meta, Mintegral, Unity Ads |
| LARGE_BANNER | Large Banner Best for Tablets and Larger Devices | 90 X screen width | Admob, AppLovin |
| RECTANGLE_BANNER | Large Rectangular Banner Best for Scrollable Feeds or Between Game Levels | 250 X screen width | Admob, AppLovin |
| SMART_BANNER | Smart Banner Renders ads that automatically resize to fit the device’s size and orientation | 50 (screen height ≤ 720) X screen width 90 (screen height > 720) X screen width | Admob, AppLovin |
Position | Description |
|---|---|
| POSITION_TOP | Banner will be positioned at the top center of the screen |
| POSITION_BOTTOM | Banner will be positioned at the bottom center of the screen |
Banner Placements
We support placements, as well as capping and pacing for Banners on the Unity LevelPlay dashboard. If you've set up placements for your Banner, call the following method to serve a Banner ad in a specific location:You will receive theIronSource.instance.loadBanner(IronSourceBannerSize.BANNER, IronSource.POSITION_BOTTOM, YOUR_PLACEMENT_NAME);
levelPlayBannerAdLoadedHide & 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. After 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:To then show this same banner again, call this function:IronSource.instance.hideBanner();
IronSource.instance.displayBanner();
Step 3. Destroy the Banner Ad
After you've successfully served a Banner, we recommend calling the below function to destroy the previous Banner.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 [icode]loadBanner[/icode] method.IronSource.instance.destroyBanner();
Step 4. Integrate a Banner Provider
Next, integrate the ad network adapters to serve Banners through Unity LevelPlay Mediation. You can find the supported networks below, and bannerSize behaviour for each network:Banner Support
BANNER | LARGE | RECTANGLE | SMART | |
|---|---|---|---|---|
| ironSource | Banner | Large | Banner / Leaderboard | |
| Banner | Banner | Medium Rectangle | Banner / Leaderboard | |
| Banner | Banner | Medium Rectangle | Banner / Leaderboard | |
| Banner | Large* | Medium Rectangle | Banner / Leaderboard | |
| Banner | Large | Medium Rectangle | Banner / Leaderboard | |
| Banner | Banner | - | Leaderboard | |
| Banner | Banner | Medium Rectangle | Banner / Leaderboard |