Interstitial/Rewarded Ads in Android

• Creating a Zone
• Requesting Ads
  • Request Options
• Showing Ads
  • Show Options
• Getting The Result of Rewarded Ads

The implementation of interstitial and rewarded ads (banner and video) is the same. You have to choose the zone type in the panel.

Creating a Zone

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

Requesting Ads

To request an ad in your application, use the following method:

Yelloadwise.requestAd(CONTEXT,
        ZONE_ID,
        new YelloadwiseAdRequestOptions(),
        new YelloadwiseAdRequestListener() {
            @Override
            public void onAdAvailable(String adId) {
              // KEEP adId
            }

            @Override
            public void onError(String message) {
            }
        });

The first argument is CONTEXT.
The second argument is the ZONE_ID which you can get from your panel.
The third argument OPTIONS is of type YelloadwiseAdRequestOptions. You can configure your ad request with this argument. The fourth argument is YelloadwiseAdRequestListener.

The details of YelloadwiseAdRequestListener methods are shown in the table below:

Request Options

You can change the way a video is cached with the help of the argument options, such as the lines below:

YelloadwiseAdRequestOptions options = new YelloadwiseAdRequestOptions();
options.setCacheType(CACHE_TYPE);

The CACHE_TYPE attribute can take the values below:

To lower the data usage, only use the CACHE_TYPE_CACHED option when the probability of user watching the ad is high.

Showing Ads

You can start showing the ad using the following lines of code:

Yelloadwise.showAd(CONTEXT,
        ZONE_ID,
        AD_ID,
        new YelloadwiseShowOptions(),
        new YelloadwiseAdShowListener() {
            @Override
            public void onOpened() {
            }

            @Override
            public void onClosed() {
            }

            @Override
            public void onError(String message) {
            }

            @Override
            public void onRewarded(boolean completed) {
            }
        });

The first argument is CONTEXT. The second argument is ZONE_ID, which you used to request an ad.
The third argument is AD_ID, which you get in the onAdAvailable callback method. The fourth argument is YelloadwiseShowOptions that you can use to configure how to show your ad.
The fifth argument is YelloadwiseAdShowListener that you can use to follow the steps of showing the ad.

The YelloadwiseAdShowListener methods are shown in the table below:

Show Options

You can configure how to show your ad with the help of the showOptions argument.

YelloadwiseShowOptions showOptions = new YelloadwiseShowOptions();
showOptions.setBackDisabled(true|false);
showOptions.setImmersiveMode(true|false);
showOptions.setShowDialog(true|false);
showOptions.setRotationMode(ROTATION_MODE);

You can give each of the methods above true or false to enable or disable that functionality. The possible values for ROTATION_MODE is explained further down.

The functionality of each method is explained in the table below:

The setRotationMode attribute can take the values below:

Getting The Result of Rewarded Ads

If the completed variable in the rewarded method is true in the rewarded ads, you can give the user her/his reward.