Banner / MREC

Available banner ad sizes:

Banner Size	Description	Devices	AdSize constant
320x50	Banner	Phone and Tablet	BANNER_320x50
728X90	Banner	Tablets	BANNER_728x90
-	Smart Banner	Phone and Tablet	SMART_BANNER
300x250	IAB Medium Rectangle	Phone and Tablet	BANNER_300x250

Setup Banner

Create a banner using your Tappx key, set the size, add it to the view and request an ad using .loadAd() method.

JAVA
Kotlin

TappxBanner banner = new TappxBanner(context, "**YOUR-APP-KEY**");
banner.setAdSize(AdSize.SMART_BANNER);
banner.loadAd();

val banner = TappxBanner(this, "**YOUR-APP-KEY**")
banner.setAdSize(AdSize.SMART_BANNER)
banner.loadAd()

TIP: we recommend sending additional information with your ad requests to improve performance. Check Advanced Settings section.

banner.setListener(new TappxBannerListener() {
       @Override
       public void onBannerLoaded(TappxBanner tappxBanner) {
           Log.v("TappxSDK", "Tappx: onBannerLoaded");
       }
       @Override
       public void onBannerLoadFailed(TappxBanner tappxBanner, TappxAdError tappxAdError) {
           Log.v("TappxSDK", "Tappx: onBannerLoadFailed " + tappxAdError);
       }
       @Override
       public void onBannerClicked(TappxBanner tappxBanner) {
           Log.v("TappxSDK", "Tappx: onBannerClicked");
       }
       @Override
       public void onBannerExpanded(TappxBanner tappxBanner) {
           Log.v("TappxSDK", "Tappx: onBannerExpanded");
       }
       @Override
       public void onBannerCollapsed(TappxBanner tappxBanner) {
           Log.v("TappxSDK", "Tappx: onBannerCollapsed");
       }
});

banner.setListener(object : TappxBannerListener {
       override fun onBannerLoaded(tappxBanner: TappxBanner) {
              Log.v("TappxSDK", "Tappx: onBannerLoaded")
       }
       override fun onBannerLoadFailed(tappxBanner: TappxBanner, tappxAdError: TappxAdError) {
              Log.v("TappxSDK", "Tappx: onBannerLoadFailed $tappxAdError")
       }
       override fun onBannerClicked(tappxBanner: TappxBanner) {
              Log.v("TappxSDK", "Tappx: onBannerClicked")
       }
       override fun onBannerExpanded(tappxBanner: TappxBanner) {
              Log.v("TappxSDK", "Tappx: onBannerExpanded")
       }
       override fun onBannerCollapsed(tappxBanner: TappxBanner) {
              Log.v("TappxSDK", "Tappx: onBannerCollapsed")
       }
})

Destroy (Recommended)

After ad was successful shown and no longer needed, it can be destroyed.

JAVA
Kotlin

banner.destroy();

banner.destroy()

Setting up the Endpoint (Recommended)

Please, if you don’t have an Endpoint contact our supply team at sdk@tappx.com.

You can set your Endpoint when requesting ads from your app project. Add the following lines:

JAVA
Kotlin

banner.loadAd(new AdRequest().setEndpoint("[ENDPOINT]"));

banner.loadAd(AdRequest().setEndpoint("[ENDPOINT]"))

Refreshing ads

By default, banner ads periodically change every 30 seconds. To set the frequency of ad refresh use the following:

JAVA
Kotlin

banner.setRefreshTimeSeconds(45);

banner.setRefreshTimeSeconds(45)

The minimum refresh time is 30 seconds and the maximum is 150 seconds.

To disable automatic ad refresh, use:

JAVA
Kotlin

banner.setEnableAutoRefresh(false);

banner.setEnableAutoRefresh(false)

Examples on GitHub

Banner ads example: Java | Kotlin

MREC ads example: Java | Kotlin

Complete demo: Java | Kotlin

Banner / MREC