Content Ignite Mobile SDK

​

Prerequisites

​

Targeting

• Use Xcode 16.0 or higher.
• Target iOS 17.2 or higher.

​

Updating your Info.plist

1. Before installing, update the application Info.plist to A GADApplicationIdentifier key with a string value of your Ad Manager app ID found in the Ad Manager UI and of the form ca-app-pub-################~##########. If you do not have this ID, please contact the Content Ignite team.
2. Next add a SKAdNetworkItems key to your Info.plist with SKAdNetworkIdentifier values for Google (cstr6suwn9.skadnetwork) and select third-party buyers who have provided these values to Google.

​

Installation

​

Swift Package Manager

1. In Xcode, install the Content Ignite Mobile SDK UIKit Package using File > Add Package Dependencies…
2. When the prompt appears, search for the following URL for the UIKit version of the SDK:

https://gitlab.com/content-ignite/content-ignite-mobile-sdk-ios-uikit

3. Select the version of the Content Ignite Mobile SDK UIKit Package you want to use. For new projects, we recommend using the Up to Next Major Version.

​

CocoaPods

1. Open your project’s Podfile and add this line to your app’s target build configuration:

pod 'Content-Ignite-Mobile-UIKit'

2. In a terminal, run:

pod install --repo-update

3. In your project’s build settings:

• Add the -ObjC linker flag to Other linker flags.

​

Initialising the SDK

• publisherId: String: A unique identifier to identify the publisher in the Fusion platform.

ℹ️ When creating an instance of CIMobileAdsConfiguration it is possible to enable optional features on the SDK, currently the only feature which can be enabled is debugging using the setDebugFeature API. This is discussed further in the Using the Debug Features section.

let configuration = CIMobileAdsConfiguration.Builder(
    publisherId: "<PUBLISHER-ID>"
)
.setDebugFeature(enabled: true)
.setTestAds(enabled: true)
.build()

• setTestAds(enabled: Boolean) was added to CIMobileAdsConfiguration.Builder in 1.7.0 to control whether test ads are enabled, this was previously only possible from the debug menu. If this is set the Debug Menu option will be hidden and if not set the Debug Menu option will be used.

• configuration: An instance of CIMobileAdsConfiguration.

ℹ️ If you are currently using Google Mobile Ads SDK, it is no longer necessary to initialise this separately, and this code should be removed.

import CIMobileSDK

class AppDelegate: UIResponder, UIApplicationDelegate {
    
    func application(
        _ application: UIApplication, 
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]? = nil
        ) -> Bool {
        
        let configuration = CIMobileAdsConfiguration.Builder(
            publisherId: "<PUBLISHER-ID>"
        )
        .setDebugFeature(enabled: true)
        .build()

        Task {
            let status = try await CIMobileAds.shared.initialise(
                configuration: configuration
            )
            switch status {
            case .succeeded:
                print("CIMobileSDK initialisation succeeded")
            case .failed:
                print("CIMobileSDK initialisation failed")
            }
        }
        
        return true
    }
}

​

Select an ad format

​

App Open

​

Banner

​

Interstitial