AdBox Android SDK

Dependencies

Add the Prebid Mobile SDK dependency to build.gradle (Module: app):

implementation 'org.prebid:prebid-mobile-sdk:3.3.1'

Configuration

Define constants for connecting to the IA.BOX server:

const val SERVER_URL   = "https://ia.box/ads/prebid"
const val ACCOUNT_ID   = "test"          // Bundle ID
const val CONFIG_ID    = "test_banner"   // placement name

SDK Initialization

Called once at app startup (e.g. in onCreate of Application or Activity):

PrebidMobile.setPrebidServerAccountId(ACCOUNT_ID)
PrebidMobile.setTimeoutMillis(10000)    // bidding timeout, ms
PrebidMobile.setShareGeoLocation(true)  // pass geolocation

PrebidMobile.initializeSdk(applicationContext, SERVER_URL) { status ->
    runOnUiThread {
        if (status == InitializationStatus.SUCCEEDED) {
            // SDK is ready
        }
    }
}

Banner

Layout (XML)

Add a container to the screen layout:

<FrameLayout
    android:id="@+id/bannerContainer"
    android:layout_width="match_parent"
    android:layout_height="wrap_content" />

Loading a banner

val bannerView = BannerView(
    context,
    CONFIG_ID,
    AdSize(300, 250)  // standard mobile banner
)

bannerView.setBannerListener(object : BannerViewListener {
    override fun onAdLoaded(bannerView: BannerView?) { }
    override fun onAdDisplayed(bannerView: BannerView?) { }
    override fun onAdFailed(bannerView: BannerView?, exception: AdException?) { }
    override fun onAdClicked(bannerView: BannerView?) { }
    override fun onAdClosed(bannerView: BannerView?) { }
})

bannerContainer.addView(bannerView)
bannerView.loadAd()

Cleanup when removing banner

bannerView.destroy()
bannerContainer.removeAllViews()

Resource cleanup

Call in onDestroy() of Activity or Fragment to avoid memory leaks:

override fun onDestroy() {
    super.onDestroy()
    bannerView?.destroy()
}

Do not forget to call destroy() for all created BannerView and InterstitialAdUnit instances.