Migrate to banner ad unit API for Android

Prerequisites

• The min supported SDK is 8.6.0. You can download the latest SDK here.
• Ensure that you initialize the SDK using LevelPlay Initialization API.
• Find the AdUnitID in LevelPlay dashboard.

Create Banner Ad Object and Set Size

// Create the banner view and set the ad unit idLevelPlayBannerAdView levelPlayBanner = new LevelPlayBannerAdView(context, "adUnitId");

// Create the banner view and set the ad unit idval levelPlayBanner = LevelPlayBannerAdView(context, "adUnitId")

Banner Sizes

 LevelPlayAdSize adSize = LevelPlayAdSize.createAdaptiveAdSize(context);

 val adSize = createAdaptiveAdSize(context)

levelPlayBanner.setAdSize(LevelPlayAdSize.MEDIUM_RECTANGLE);

levelPlayBanner.setAdSize(LevelPlayAdSize.MEDIUM_RECTANGLE) 

Placements

// Set the placement namelevelPlayBanner.setPlacementName("placementName");

// Set the placement namelevelPlayBanner.setPlacementName("placementName")

Set Banner Listener

• It is recommended to set the listener before loading the banner ad.
• Each banner ad should have its own listener implementation.
• Callbacks run on the main thread.

levelPlayBanner.setBannerListener(new LevelPlayBannerAdViewListener() {    @Override    public void onAdLoaded(@NonNull LevelPlayAdInfo adInfo) {    // Ad was loaded successfully     }    @Override    public void onAdLoadFailed(@NonNull LevelPlayAdError error) {    // Ad load failed    }    @Override    public void onAdDisplayed(@NonNull LevelPlayAdInfo adInfo) {    // Ad was displayed and visible on screen    }    @Override    public void onAdDisplayFailed(@NonNull LevelPlayAdInfo adInfo, @NonNull LevelPlayAdError error) {    // Ad failed to be displayed on screen    }    @Override    public void onAdClicked(@NonNull LevelPlayAdInfo adInfo) {    // Ad was clicked    }    @Override    public void onAdExpanded(@NonNull LevelPlayAdInfo adInfo) {    // Ad is opened on full screen    }    @Override    public void onAdCollapsed(@NonNull LevelPlayAdInfo adInfo) {    // Ad is restored to its original size    }    @Override    public void onAdLeftApplication(@NonNull LevelPlayAdInfo adInfo)     // User pressed on the ad and was navigated out of the app     });

levelPlayBanner.setBannerListener(object: LevelPlayBannerAdViewListener {    override fun onAdLoaded(adInfo: LevelPlayAdInfo) {    // Ad was loaded successfully     }    override fun onAdLoadFailed(error: LevelPlayAdError) {    // Ad load failed    }    override fun onAdDisplayed(adInfo: LevelPlayAdInfo) {    // Ad was displayed and visible on screen    }    override fun onAdDisplayFailed(adInfo: LevelPlayAdInfo, error: LevelPlayAdError) {    // Ad failed to be displayed on screen    }    override fun onAdClicked(adInfo: LevelPlayAdInfo) {    // Ad was clicked    }    override fun onAdExpanded(adInfo: LevelPlayAdInfo) {    // Ad is opened on full screen    }    override fun onAdCollapsed(adInfo: LevelPlayAdInfo) {    // Ad is restored to its original size    }    override fun onAdLeftApplication(adInfo: LevelPlayAdInfo) {    // User pressed on the ad and was navigated out of the app     }})

LevelPlay Ad Info

Load Banner Ad

// Load the banner adlevelPlayBanner.loadAd();

// Load the banner adlevelPlayBanner.loadAd()

Pause and Resume Banner Refresh

• pauseAutoRefresh - pauses auto-refresh of the banner ad.
• resumeAutoRefresh - resumes auto-refresh of the banner ad after it has been paused.

// Pause refreshlevelPlayBanner.pauseAutoRefresh();// Resume refreshlevelPlayBanner.resumeAutoRefresh();

// Pause refreshlevelPlayBanner.pauseAutoRefresh()// Resume refreshlevelPlayBanner.resumeAutoRefresh()

Destroy Banner Ad

levelPlayBanner.destroy()

levelPlayBanner.destroy();

Multiple Ad Unit Banner APIs

Full Implementation Example of Banner Ads

public void createAndLoadBanner() {    // Create the banner view and set the ad unit id    LevelPlayBannerAdView levelPlayBanner = new LevelPlayBannerAdView(context, "adUnitId");        // Set the placement name (optional)    levelPlayBanner.setPlacementName("placementName");        // Create the adaptive ad size to support both adaptive, banner and leaderboard (recommended)      LevelPlayAdSize adSize = LevelPlayAdSize.createAdaptiveAdSize(context);        // Required when using createAdaptiveAdSize()    if (adSize != null) {        levelPlayBanner.setAdSize(adSize);    }        // Add the banner view to the container    ViewGroup adContainer = findViewById(android.R.id.adContainer);    adContainer.addView(levelPlayBanner);        // Load the banner ad    levelPlayBanner.loadAd();        // To get actual banner layout size (either custom/standard size or adaptive)    height = adSize.getHeight();    width = adSize.getWidth();}

fun createAndLoadBanner() {    // Create the banner view and set the ad unit id    val levelPlayBanner = LevelPlayBannerAdView(context, "adUnitId")        // Set the placement name    levelPlayBanner.setPlacementName("placementName")        // Create the adaptive ad size to support both adaptive, banner and leaderboard    val adSize = createAdaptiveAdSize(context)        // Required when using createAdaptiveAdSize()    adSize?.let { levelPlayBanner.setAdSize(it) }        // Add the banner view to the container    val adContainer = findViewById<ViewGroup>(R.id.adContainer)    adContainer.addView(levelPlayBanner)        // Load the banner ad    levelPlayBanner.loadAd()        // Get width and height for the container    val width = adSize?.getWidth()    val height = adSize?.getHeight()}

LevelPlay Mediation Demo App