Interstitial Ads

Interstitials are static or video ads presented before, during or after the user interacts with your app.

The user can view and then immediately dismiss them. This is a non-rewarded format for the user.

The DT FairBid SDK supports both static and video interstitials.

Making the Request

Below is an example of making a request for an Intersitial.

Example Request

import com.fyber.fairbid.ads.Interstitial;
 
String placementId = "12345";
Interstitial.request(placementId);

Adding Callbacks

The callback code below is required for the SDK to properly track the activity of your ad

Interstitial.setInterstitialListener(new InterstitialListener() {
    @Override
    public void onShow(String placementId, ImpressionData impressionData) {
        // Called when the interstitial from placement 'placementId' shows up. In case the ad is a video, audio play will start here.
    }
 
    @Override
    public void onClick(String placementId) {
        // Called when the interstitial from placement 'placementId' is clicked
    }
 
    @Override
    public void onHide(String placementId) {
        // Called when the interstitial from placement 'placementId' hides. In case the ad is a video, audio play will stop here.
    }
 
    @Override
    public void onShowFailure(String placementId, ImpressionData impressionData) {
        // Called when an error arises when showing the interstitial from placement 'placementId'
    }
 
    @Override
    public void onAvailable(String placementId) {
        // Called when a interstitial from placement 'placementId' becomes available
    }
 
    @Override
    public void onUnavailable(String placementId) {
        // Called when a interstitial from placement 'placementId' becomes unavailable
    }
  
  	@Override
    public void onRequestStart(String placementId) {
        // Called when a interstitial from placement 'placementId' is going to be requested
    }
});

Example Showing an Ad

The following example checks to see if a Placement is available and if it is, uses the show request to display the ad.

Showing an Ad

String placementId = "12345";
if (Interstitial.isAvailable(placementId)) {
    Interstitial.show(placementId, context);
}

Rewarded Ads

Rewarded ads are an engaging ad format that shows a short video ad to the user and in exchange the user will earn a reward. The user must consent and watch the video completely through to the end in order to earn the reward.

Importing the Class

Before you can make a request to display a Rewarded ad, you must import the Rewarded class.

import com.fyber.fairbid.ads.Rewarded;

Make an Ad Request

After importing the Rewarded class, you must must make a request to display the Rewarded ads.

Requesting a Rewarded Ad

import com.fyber.fairbid.ads.Rewarded;
 
String placementId = "12345";
Rewarded.request(placementId);

Adding Callbacks

The callback code below is required for SDK to properly track the activity of your ad

Callbacks

Rewarded.setRewardedListener(new RewardedListener() {
    @Override
    public void onShow(String placementId, ImpressionData impressionData) {
        // Called when the rewarded ad from placement 'placementId' shows up. In case the ad is a video, audio play will start here.
    }
 
    @Override
    public void onClick(String placementId) {
        // Called when the rewarded ad from placement 'placementId' is clicked
    }
 
    @Override
    public void onHide(String placementId) {
        // Called when the rewarded ad from placement 'placementId' hides. In case the ad is a video, audio play will stop here.
    }
 
    @Override
    public void onShowFailure(String placementId, ImpressionData impressionData) {
        // Called when an error arises when showing the rewarded ad from placement 'placementId'
    }
 
    @Override
    public void onAvailable(String placementId) {
        // Called when a rewarded ad from placement 'placementId' becomes available
    }
 
    @Override
    public void onUnavailable(String placementId) {
        // Called when a rewarded ad from placement 'placementId' becomes unavailable
    }
 
    @Override
    public void onCompletion(String placementId, boolean userRewarded) {
        // Called when a rewarded ad from placement 'placementId' finishes playing 
    }
 
    @Override
    public void onRequestStart(String placementId) {
        // Called when a rewarded ad from placement 'placementId' is going to be requested
    }
});

Example showing an ad

The following example checks to see if a placement is available and if it is, uses the show request to display the ad.

Showing an Ad

String placementId = "12345";
if (Rewarded.isAvailable(placementId)) {
    Rewarded.show(placementId, context);
}

Server Side Rewarding

For details on configuring Server Side Rewarding, click here.

Medium Rectangle Ads

Medium Rectangle (MREC) are 300x250 sized ads, serving both static and video, and positioned within editorial content of the app. There is no close button on MREC ads, and they are not skippable. Similar to Banner ads, MREC ads are refreshed according to a set refresh rate of between 10-120 seconds.

Showing an MREC

Implement the code below to show an MREC:

fun showBanner() {
    val bannerOptions = BannerOptions().withSize(BannerSize.MREC)
            // if you don't specify your container view,
            // we'll display it at the bottom of the screen
            .placeInContainer(YOUR_CONTAINER_VIEW_GOES_HERE)
    Banner.show("placementId", bannerOptions, activity)
}

private void showBanner() {
    BannerOptions bannerOptions = new BannerOptions().withSize(BannerSize.MREC)
        // if you don't specify your container view,
        // we'll display it at the bottom of the screen
        .placeInContainer(YOUR_CONTAINER_VIEW_GOES_HERE);
    Banner.show("placementId", bannerOptions, activity);
}