Implementing Native Ads

• Creating a Zone
• Creating an AdHolder
• Requesting Ads
• Showing Ads
• Removing Ads

Creating a Zone

First, create a native zone from the Tapsell panel and use the zoneId when requesting or showing an ad.

Creating an AdHolder

You should add a ViewGroup to the page in which you want to show the native ad as space for displaying it. In other words, you need to create an ad container.

<?xml version="1.0" encoding="utf-8"?>
<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
             android:layout_width="match_parent"
             android:layout_height="match_parent">

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

  </FrameLayout>

</FrameLayout>

Then create a custom layout according to the way you want the ad to be displayed, so that rootView type iscom.google.android.gms.ads.nativead.NativeAdView and id and the type of different sections are according to the following table:

• If there is no button for clicking, you can use clickable view.
• View types could be inheriting from the aforementioned types.
• You should specify 2 views to display the ad photo. One of them is ir.tapsell.sdk.nativeads.views.RatioImageView for Tepsell and the other isir.tapsell.plus.adNetworks.admob.AdMobMediaView for AdMob. Both of these can be placed exactly on top of each other. Tepsell Plus displays the desired view according to the advertisement ready for display.

  In version 1.2.3-rc4 and above, if you do not use the default layout, and you have designed and implemented a layout yourself, replace com.google.android.gms.ads.formats.MediaView withir.tapsell.plus .adNetworks.admob.AdMobMediaView.

• You can use the prepared view for this purpose with the following id or as a construction guide: native_banner

To use AdMobMediaView correctly, you need to add play-services-ads dependency to your project:

dependencies {
   def supportedAdmob = "22.6.0"
   implementation("com.google.android.gms:play-services-ads:$supportedAdmob")
}

You can use the Admob test id (ca-app-pub-3940256099942544~3347511713) if you don’t use Admob ads in your project. Otherwise, you can use your dedicated id.

• Give the ad container and the id of the layout to Tapsell to create a AdHolder as the following code:

import ir.tapsell.plus.AdHolder;
import ir.tapsell.plus.TapsellPlus;
...
ViewGroup adContainer = findViewById(R.id.adContainer);
...
AdHolder adHolder = TapsellPlus.createAdHolder(
      CONTEXT, adContainer, R.layout.native_banner);

Requesting Ads

Use the TapsellPlus.requestNativeAd method to request an ad. For example:

import ir.tapsell.plus.AdRequestCallback;
import ir.tapsell.plus.TapsellPlus;
.......
private void requestAd() {
    TapsellPlus.requestNativeAd(
                CONTEXT,
                ZONE_ID_NATIVE,
                new AdRequestCallback() {
                    @Override
                    public void response(TapsellPlusAdModel tapsellPlusAdModel) {
                        super.response(tapsellPlusAdModel);

                        //Ad is ready to show
                        //Put the ad's responseId to your responseId variable
                        nativeAdResponseId = tapsellPlusAdModel.getResponseId();
                        showAd();
                    }

                    @Override
                    public void error(@NonNull String message) {
                    }
                });
}

If you want to request an ad again in the error Callback method, be sure to do so with the help of a variable such as a counter. Because you can set a limit on the number of times to request by using that variable. For example, when you disable this ad position from the panel, if you request again each time in error Callback without limiting the number of times, your app will fall into an infinite loop and its performance will be disrupted.

Showing Ads

After the onResponse method is called, the requested ad is ready to be displayed. You can show the ad using the following lines of code:

private void showAd() {
    TapsellPlus.showNativeAd(CONTEXT, nativeAdResponseId, adHolder,
                new AdShowListener() {
                    @Override
                    public void onOpened(TapsellPlusAdModel tapsellPlusAdModel) {
                        super.onOpened(tapsellPlusAdModel);
                    }

                    @Override
                    public void onError(TapsellPlusErrorModel tapsellPlusErrorModel) {
                        super.onError(tapsellPlusErrorModel);
                    }
                });
}

Removing Ads

At the end of the Activity life cycle, you should call the following method:

private void destroyAd() {
    TapsellPlus.destroyNativeBanner(CONTEXT, nativeAdResponseId);
}

// For example in Activity's onDestory method
@Override
protected void onDestroy() {
    destroyAd();
    super.onDestroy();
}