Banner

Banner

Banners are rectangular, system-initiated ads that served in a designated area around your live app content.

BannerAd Formats:

Step 1. Init Banner Ad

The OpenMediation SDK fires several events to inform you of Banner Ad activity. To display Banner Ads, one needs to create a brand new BannerAd object, setup its listeners and load the ads.

The following snippet demonstrates how to use the BannerAd class to create BannerAd objects and implement the BannerAdListener interface to receive Banner Ad events. The SDK will notify the Listener of all possible events listed below:

import com.openmediation.sdk.banner.AdSize;
import com.openmediation.sdk.banner.BannerAd;
import com.openmediation.sdk.banner.BannerAdListener;
...
BannerAd bannerAd = new BannerAd(placementId, new BannerAdListener() {

      /** 
       * Invoked when Banner Ad are available.
       */
      @Override
      public void onBannerAdLoaded(String placementId, View view) {
          // bannerAd is load success
      }

      /** 
       * Invoked when the end user clicked on the Banner Ad
       */
      @Override
      public void onBannerAdClicked(String placementId) {
         // bannerAd click
      }

      /** 
       * Invoked when the call to load a Banner Ad has failed
       * String error contains the reason for the failure.
      */
      @Override
      public void onBannerAdLoadFailed(String placementId, Error error) {
         // bannerAd fail
      }
});
// default size
bannerAd.setAdSize(AdSize.BANNER);

See table below for details about our supported standard banner sizes:

Step 2. Load BannerAd

Invoke loadAd method to request and cache the Banner Ad before it is available for display to users. It is strongly recommended to invoke this method a short while before the ad is to be shown.  

bannerAd.loadAd()

Step 3. Show BannerAd

After the Banner Ad is successfully loaded by calling the loadAd in Step 2, you will be notified when the ad is ready to be shown through the onAdReady callback which will inform you the availability of ad inventory. 

Once you receive the onAdReady callback, you  can use code below to show and serve the Banner Ad to your users.

 private RelativeLayout adParent;
 ...
 adParent = this.findViewById(R.id.banner_ad_container);
 ...

 @Override
 public void onBannerAdLoaded(String placementId, View view) {
    // bannerAd is loaded successfully
    if (null != view.getParent()) {
        ((ViewGroup) view.getParent()).removeView(view);
    }
    adParent.removeAllViews();
    RelativeLayout.LayoutParams layoutParams = new RelativeLayout.LayoutParams(
    RelativeLayout.LayoutParams.WRAP_CONTENT, RelativeLayout.LayoutParams.WRAP_CONTENT);
    layoutParams.addRule(RelativeLayout.CENTER_IN_PARENT);
    adParent.addView(view, layoutParams);
}

■ R.id.banner_ad_container code as following:

<RelativeLayout
   android:id="@+id/banner_ad_container"
   android:layout_width="match_parent"
   android:layout_height="wrap_content">

</RelativeLayout>

Step 4. Destroy BannerAd Object

It is recommended to invoke destroy method to release BannerAd object when the Activity be destroyed.

@Override
public void onDestroy() {
   if (bannerAd != null) {
      bannerAd.destroy();
   }
   super.onDestroy();
}

Step 5. Integrate a Banner Provider

You can find the supported networks below, and bannerSize behaviour for each network below: