InMobi

In this article, you will learn how to use Nimbus to request and render ads using InMobi SDK.

How it works

The SDK provides a helper method that will inject a InMobi bidding token into the outbound request to Nimbus when using the NimbusAdManager. Adding a InMobi placement ID to the Nimbus request will signal to InMobi it can bid on the upcoming ad opportunity and render the bid using the InMobi Ad SDK if it wins.

Prerequisites

• Nimbus SDK 2.34.0 or higher

• Android Build Configuration meets the following requirements

  • Compile SDK: 34+

• Completed the InMobi app setup and obtained a unique InMobi Account Id.

• InMobi Demand setup completed in Nimbus with newly created InMobi Ad Units. A unique placement ID must be provided each of the following ad types

  • Banner

  • Interstitial

  • Rewarded

  • InMobi Native ads are currently not supported

Setup

Add the Nimbus InMobi Extension to your build.gradle(.kts) file

The InMobi Ads SDK will be automatically included using the preferred version defined by the Nimbus SDK. You may optionally import a newer version of the InMobi Ads SDK if one is available.

dependencies {
    implementation("com.adsbynimbus.android:extension-inmobi:2.+")
    // Optionally import a new InMobi Ads SDK
    implementation("com.inmobi.monetization:inmobi-ads-kotlin:10.+")
}

The minimum required InMobi SDK version is 10.8.0

Initialize the InMobi SDK

Initialize the InMobi SDK by setting the account Id obtained from the InMobi Dashboard using InMobi provided helper method.

    InMobiSdk.setLogLevel(InMobiSdk.LogLevel.DEBUG)
    InMobiSdk.init(context, accountId, consentObject, object : SdkInitializationListener {
        override fun onInitializationComplete(error: Error?) {
            Log.v("InMobi", "InMobi SDK initialized with ${error?.message}")
        }
    })

Requesting InMobi Bids

To include InMobi in the NimbusRequest, call the withInMobi helper method and pass in the corresponding ad placement ID for the type of ad being requested.

The ad placement ID passed to NimbusRequest must match the ID setup in the Nimbus dashboard.

Banner

For NimbusRequests that are rendered inline with NimbusAdManager.showAd or via manual rendering, call NimbusRequest.withInMobi(placementId)

Kotlin

import android.view.ViewGroup
import com.adsbynimbus.*
import com.adsbynimbus.openrtb.request.Format
import com.adsbynimbus.request.*

lateinit var nimbusAdManager: NimbusAdManager

fun bannerRequest(
    container: ViewGroup,
    position: String, 
    listener: NimbusAdManager.Listener,
) {
    val request = NimbusRequest.forBannerAd(
        position = position, 
        format = Format.BANNER_320_50,
    ).apply {
        // Replace with your InMobi Banner ID
        withInMobi(placementId = 123456)
    }
    nimbusAdManager.showAd(request, container, listener)
}

fun mrecMolocoRequest(
    container: ViewGroup,
    position: String, 
    listener: NimbusAdManager.Listener,
) {
    val request = NimbusRequest.forBannerAd(
        position = position, 
        format = Format.MREC,
    ).apply {
        // Replace with your InMobi MREC ID
        withInMobi(placementId = 123456)
    }
    nimbusAdManager.showAd(request, container, listener)
}

Java

Interstitial

For interstitial NimbusRequests loaded with NimbusAdManager.showBlockingAd, call NimbusRequest.withInMobi(placementId)

Changing the value of closeButtonDelaySeconds when calling showBlockingAd has no effect on InMobi interstitial ads.

Kotlin

import android.app.Activity
import com.adsbynimbus.*
import com.adsbynimbus.request.*

lateinit var nimbusAdManager: NimbusAdManager

fun interstitialRequest(
    activity: Activity,
    position: String, 
    listener: NimbusAdManager.Listener,
) {
    val request = NimbusRequest.forInterstitialAd(position = position).apply {
        // Replace with your InMobi Interstitial placement ID
        withInMobi(placementId = "123456")
    }
    nimbusAdManager.showBlockingAd(request, activity, listener)
}

Java

Rewarded

For rewarded NimbusRequests call NimbusRequest.withInMobi(placementId)

InMobi Rewarded ads will play to completion before they can be dismissed; changing the value of closeButtonDelaySeconds when calling showRewardedAd will have no effect.

Kotlin

import android.app.Activity
import com.adsbynimbus.*
import com.adsbynimbus.request.*

lateinit var nimbusAdManager: NimbusAdManager

fun rewardedRequest(
    activity: Activity,
    position: String, 
    listener: NimbusAdManager.Listener,
) {
    val request = NimbusRequest.forRewardedVideo(position = position).apply {
        // Replace with your InMobi Rewarded ID
        withInMobi(placementId = 123456)
    }
    nimbusAdManager.showRewardedAd(request, closeButtonDelaySeconds = 30, activity, listener)
}

Java

Troubleshooting

A successful integration with InMobi will render any number of creatives that do not look like Nimbus test ads. If you do not see InMobi ads rendering, verify the following before proceeding further.

• The NimbusRequest has a matching withInMobi call with the correct placement IDs used for Nimbus

• Nimbus test mode is enabled in the SDK

• Other SDK demand partners are temporarily disabled

• Confirm with your Nimbus Account Manager InMobi demand has been enabled