Fullscreen (Interstitial)

Integrate fullscreen ads

This guide shows you how to integrate fullscreen ads of RTBSDK into your app.

Create RTBFullscreenAd Instance

Create an instance of RTBFullscreenAd:

val fullscreenAd = RTBFullscreenAd(this)

Listen to Callbacks

Through the use of RTBFullscreenDelegate, you can listen to the different callbacks.

fullscreenAd.delegate = this

Request Ad

To load a fullscreen ad, you will need to pass an instance of RTBFullscreenRequestConfiguration with placementID and the bundleId. Please contact our support for getting the needed IDs.

val rtbFullscreenRequestConfiguration = RTBFullscreenRequestConfiguration(<PLACEMENT_ID>, <BUNDLE_ID>)
rtbFullscreenRequestConfiguration.sellerId = "<SELLERID>" // Optional
fullscreenAd.load(rtbFullscreenRequestConfiguration)

You will be notified about the loading success/failure through the RTBFullscreenDelegate

Optional - set user targeting

You can pass user targeting data to each request, allowing ads to be more relevant to your audience. Each field in RTBUserTargeting is optional.

rtbFullscreenRequestConfiguration.userTargeting = RTBUserTargeting(userID = "<USER_ID>", gender = RTBGender.MALE, keywords = listOf("keyword1", "keyword2"), yearOfBirth = 1990)
// yearOfBirth must be a 4-digit number, otherwise it will be ignored

Show Ad

After the ad gets loaded, it can be presented by calling:

fullscreenAd?.show(this)

The currency of bidFloor and priceCPM parameters is USD.

Complete Code Example

class MainActivity : AppCompatActivity(), RTBFullscreenDelegate {

    private var fullscreenAd: RTBFullscreenAd? = null

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        fullscreenAd = RTBFullscreenAd(this)

        // Set the interstitial delegate to listen to events
        fullscreenAd?.delegate = this

        // Request a fullscreen ad using the placement ID and bundle ID
        val rtbFullscreenRequestConfiguration = RTBFullscreenRequestConfiguration(<PLACEMENT_ID>, <BUNDLE_ID>)
        rtbFullscreenRequestConfiguration.sellerId = "<SELLERID>" // Optional
        fullscreenAd.load(rtbFullscreenRequestConfiguration)
    }

    // RTBFullscreenDelegate implementation:
    override fun fullscreenAdDidReceiveAd(fullscreenAd: RTBFullscreenAd, bidInfo: RTBBidInfo, networkName: String)
        // An ad has been loaded
        // Show the ad:
        fullscreenAd.show(this)
    }

    override fun fullscreenAdDidFailToReceiveAd(fullscreenAd: RTBFullscreenAd, error: String, networkName: String) {
        // Failed to load an ad
    }

    override fun fullscreenAdDidRecordClick(fullscreenAd: RTBFullscreenAd, networkName: String) {
        // The ad received a click
    }

    override fun fullscreenAdDidPauseForAd(fullscreenAd: RTBFullscreenAd, networkName: String) {
        // The app paused for displaying a fullscreen ad
    }

    override fun fullscreenAdDidResumeAfterAd(fullscreenAd: RTBFullscreenAd, networkName: String) {
        // The app resumed after dismissing a fullscreen ad
    }

}