Documentation

Interstitial

Waterfall

Integration remains consistent with the approach outlined in Google AdMob, ensuring seamless compatibility with existing configurations. No further modifications are necessary, streamlining the implementation process and minimizing any additional overhead.

Prebid

Overview

Loading interstitial ads consists of several stages:

  1. Loading BidMachine InterstitialRequest
  2. Setting up AdMob AdRequest by loaded BidMachine InterstitialRequest
  3. Loading AdMob InterstitialAd with configured AdMob AdRequest

Loading BidMachine InterstitialRequest

Create a new InterstitialRequest instance with AdRequestListener.
Execute request on the InterstitialRequest instance to start loading.
When the onRequestSuccess callback is triggered, it means that the request has been successfully loaded and you can proceed to AdMob AdRequest settings.

// Create new BidMachine InterstitialRequest instance
InterstitialRequest interstitialRequest = BidMachineAdRequestBuilderFactory.createInterstitialRequestBuilder()
        .setListener(new InterstitialRequest.AdRequestListener() {
            @Override
            public void onRequestSuccess(@NonNull InterstitialRequest interstitialRequest,
                                         @NonNull AuctionResult auctionResult) {
                runOnUiThread(() -> loadAdMobInterstitial(interstitialRequest));
            }
        })
        .build();

// Request an ad from BidMachine without loading it
interstitialRequest.request(...);
// Create new BidMachine request
val interstitialRequest = BidMachineAdRequestBuilderFactory.createInterstitialRequestBuilder()
        .setListener(object : InterstitialRequest.AdRequestListener {
            override fun onRequestSuccess(interstitialRequest: InterstitialRequest, auctionResult: AuctionResult) {
                runOnUiThread { loadAdMobInterstitial(interstitialRequest) }
            }
        })
        .build().also {
            // Request an ad from BidMachine without loading it
            it.request(context)
        }

Setting up AdMob AdRequest

Ways to set up AdMob AdRequest by BidMachine InterstitialRequest:

  1. Create a new AdMob AdRequest instance
AdRequest adRequest = BidMachineUtils.createAdRequest(interstitialRequest);
val adRequest = BidMachineUtils.createAdRequest(interstitialRequest)
  1. Create a new AdMob AdRequest.Builder instance
AdRequest.Builder adRequestBuilder =
    BidMachineUtils.createAdRequestBuilder(interstitialRequest);
AdRequest adRequest = adRequestBuilder.build();
val adRequestBuilder = BidMachineUtils.createAdRequestBuilder(interstitialRequest)
val adRequest = adRequestBuilder.build()
  1. Fill an existing AdMob AdRequest.Builder instance
AdRequest.Builder adRequestBuilder = new AdRequest.Builder();
BidMachineUtils.appendRequest(adRequestBuilder, interstitialRequest);
AdRequest adRequest = adRequestBuilder.build();
val adRequestBuilder = AdRequest.Builder()
BidMachineUtils.appendRequest(adRequestBuilder, interstitialRequest)
val adRequest = adRequestBuilder.build()

Loading AdMob InterstitialAd

Use the AdMob AdRequest that was created during the previous step to load the AdMob InterstitialAd.

InterstitialAd.load(..., ..., adRequest, ...);
InterstitialAd.load(..., ..., adRequest, ...)

📘

Sample App

You can find Sample App with BidMachineSDK and AdMob here: Github Interstitial