InMobi

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

How it works

The SDK provides a helper method that will inject an InMobi bidding token into the outbound request to Nimbus when using the NimbusAdManager. Adding an 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.31.0 or higher

• iOS Build Configuration meets the following requirements

  • Use Xcode 16 or higher

  • Supports iOS 13 and up

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

• InMobi Demand setup completed in Nimbus with newly created InMobi Placement IDs. 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 NimbusInMobiKit to your build; the InMobiSDK will be automatically included.

CocoaPods

Podfile

# Include the NimbusSDK and the following subspecs
pod 'NimbusSDK', subspecs: [
    'NimbusKit',              
    'NimbusInMobiKit',            
]

The minimum required InMobi SDK version for Cocoapods is 10.8

Swift Package Manager

Package.swift

import PackageDescription

let package = Package(
    name: "NimbusWithInMobi",
    platforms: [.iOS(.v13)],
    dependencies: [
        .package(url: "https://github.com/adsbynimbus/nimbus-ios-sdk.git", from: "2.31.0"),
    ],
    targets: [
        .target(
            name: "Application",
            dependencies: [
                .product(name: "NimbusKit", package: "nimbus-ios-sdk"),
                // Add the NimbusInMobiKit library
                .product(name: "NimbusInMobiKit", package: "nimbus-ios-sdk"),
            ])
    ]
)

Check out our sample app integrating InMobi using UIKit & Swift Package Manager.

The minimum required InMobi SDK version for Swift Package Manager is 10.8.6

Add the NimbusInMobiAdRenderer

#if canImport(NimbusSDK) // CocoaPods
import NimbusSDK
#else                    // Swift Package Manager
import NimbusInMobiKit
#endif

// After calling Nimbus.initialize
Nimbus.shared.renderers[.inmobi] = NimbusInMobiAdRenderer()

Initialize the InMobi SDK

Initialize the InMobi SDK by setting the Account ID obtained from the InMobi Dashboard on the IMSdk class.

import InMobiSDK

InMobiSDK.IMSdk.initWithAccountID(inmobiAccountId) { error in
    if let error {
        print("InMobi initialization failed with error: \(error)")
    }
}

If the InMobi SDK is initialized elsewhere in code this step can be skipped.

Requesting InMobi Bids

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

The ad unit 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:)

import NimbusKit
import NimbusInMobiKit // if you're using Swift Package Manager
import NimbusSDK       // if you're using CocoaPods

lazy var nimbusAdManager = NimbusAdManager()

func bannerRequest(
    position: String,
    container: UIView,
    delegate: NimbusAdManagerDelegate,
    viewController: UIViewController
) {
    let request = NimbusRequest.forBannerAd(
        position: position,
        format: .banner320x50
    )
    // Replace placementId with your InMobi Banner Placement ID
    request.withInMobi(placementId: #InMobiBannerPlacementId)
    
    nimbusAdManager.delegate = delegate
    nimbusAdManager.showAd(
        request: request,
        container: container,
        adPresentingViewController: viewController)
}

func mrecRequest(
    position: String,
    container: UIView,
    delegate: NimbusAdManagerDelegate,
    viewController: UIViewController
) {
    let request = NimbusRequest.forBannerAd(
        position: position,
        format: .letterbox
    )
    // Replace placementId with your InMobi MREC Placement ID
    request.withInMobi(placementId: #InMobiMRECPlacementId)
    
    nimbusAdManager.delegate = delegate
    nimbusAdManager.showAd(
        request: request,
        container: container,
        adPresentingViewController: viewController)
}

Interstitial

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

Changing the value of closeButtonDelay when calling showBlockingAd has no effect on InMobi interstitial ads as they're rendered by InMobi SDK.

import NimbusKit
import NimbusInMobiKit // if you're using Swift Package Manager
import NimbusSDK       // if you're using CocoaPods

class InMobiInterstitialViewController: UIViewController {
    let adManager = NimbusAdManager()
    
    override func viewDidLoad() {
        super.viewDidLoad()
        
        let request = NimbusRequest.forInterstitialAd(position: #positionName)
        // Replace placementId with your InMobi Interstitital Placement ID
        request.withInMobi(placementId: #InMobiInterstitialPlacementId)
        
        adManager.showBlockingAd(request: request, adPresentingViewController: self)
    }
}

Rewarded

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

import NimbusKit
import NimbusInMobiKit // if you're using Swift Package Manager
import NimbusSDK       // if you're using CocoaPods

class InMobiRewardedViewController: UIViewController {
    let adManager = NimbusAdManager()
    
    override func viewDidLoad() {
        super.viewDidLoad()
        
        let request = NimbusRequest.forRewardedVideo(position: #positionName)
        // Replace placementId with your InMobi Rewarded Placement ID
        request.withInMobi(placementId: #InMobiRewardedPlacementId)
        
        adManager.showRewardedAd(request: request, adPresentingViewController: self)
    }
}

Native

InMobi Native ads are currently not supported.

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

• InMobi renderer is installed as shown above.

• 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