Banners

🚧

Before you begin!

Make sure that you have completed the Adobe Air Plugin installation before you begin integrating the Banners ad unit

Integrating the Banners ad unit

Step 1: Set the banner

var banner:Banner = new Banner("YOUR_APPNEXT_PLACEMENT_ID");
banner.setBannerSize(Banner.SIZE_BANNER);
banner.setPosition(Banner.POSITION_CENTER | Banner.POSITION_BOTTOM);
banner.addEventListener(AdEvent.AD_LOADED, adLoadedHandler);
banner.loadAd();

function adLoadedHandler(event: Event): void {
	banner.show();
}

Step 2: Configure the BannerAdRequest (Optional)

By default, the banner settings will be loaded with pre-defined settings. You can change these settings by defining the BannerAdRequest object

Setters that are relevant to all banner sizes:

• setCategories - String. Set preferred ad categories
• setPostback - String. Postback parameters that will be posted to your server after user installed an app (make sure to encode the values)

Setters that are relevant only to the MEDIUM_RECTANGLE banner size:

• setCreativeType - The MEDIUM_RECTANGLE size can show video in addition to static creative. When video is in use, the file will be streamed (default value is ALL - managed by Appnext)
  • BannerAdRequest.TYPE_ALL
  • BannerAdRequest.TYPE_VIDEO
  • `BannerAdRequest.TYPE_STATIC*
• setAutoPlay - Boolean. When a video is set in the creative, this setter defining if the video will autoplay or not (default value is false)
• setMute - Boolean. When a video is set in the creative, this setter is defining if the video will start on muted volume or not. Un-mute/Mute button is located in the video creative. (default value is true - video is muted)
• setVideoLength - When a video is set in the creative, this setter is defining the preferred length of the video. (default value is SHORT)
  • BannerAdRequest.VIDEO_LENGTH_SHORT - Up to 15 seconds long videos
  • BannerAdRequest.VIDEO_LENGTH_LONG - 20-60 seconds long videos

// All sizes example
BannerAdRequest banner_request = new BannerAdRequest();
banner_request
       .setCategories("category1, category2")
       .setPostback("Postback string");
// ...
banner.loadAd(banner_request);


// MEDIUM_RECTANGLE size example
BannerAdRequest banner_request = new BannerAdRequest();
banner
  .setCategories("category1, category2")
  .setPostback("Postback string")
  .setCreativeType(BannerAdRequest.TYPE_VIDEO)
  .setAutoPlay(true)
  .setMute(false)
  .setVideoLength(BannerAdRequest.VIDEO_LENGTH_SHORT);
// ...

Step 3: Banner Events

• AdEvent.AD_LOADED - The banner was successfully loaded, and it’s ready to be shown to the user
• AdEvent.AD_IMPRESSION - The banner was viewed by the user, and an impression was reported to Appnext
• AdEvent.AD_CLICKED - The banner was clicked by the user
• AdEvent.AD_ERROR - An error has occurred

The following possible errors can be passed in the AdEvent.AD_ERROR handler:

• NoInternetConnection;
• NoPlacementID;
• AdNotReady;
• PreparingViews;
• LoadingAd;
• NoAds;

App Categories

Integration Support

Should you have any problems integrating the product, log a ticket with us by emailing [email protected].