Getting started

This guide will walk you through the steps to integrate the bidapp SDK into your Kotlin Multiplatfrom project, enabling you to monetize your applications with ads effectively.

Installing the bidapp plugin

In the commonMain.dependencies section of your shared module build.gradle file, add the following line to integrate the Bidapp kotlin multiplatform library

commonMain.dependencies {
    ...
    implementation("io.bidapp:kmp:0.3.0")
    ...
}

Save and Sync the build.gradle file

Get the pubid string

Request pubid by sending email to [email protected]

Integrate Networks SDK Adapters

Bidapp SDK contains implementations of adapters to other Networks SDKs.

To install them follow the instructions:

Android Platform SetupiOS Platfrom Setup

If you want to receive release updates for adapters, subscribe to our GitHub repository: GitHub repository

Initialize the SDK

Initialize the SDK in your app onCreate() method of your launch Activity

Ad assets that are fully cached result in a better user experience. Therefore, always initialize the Bidapp SDK on startup to give mediated networks the maximum amount of time to cache ads. This is especially important with video ads.

val bidConfig = BIDConfiguration()
val pubid = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx";
BidappAds.start(pubId, bidConfig, activity)

The activity is only passed from the Android application; for iOS, a null value is passed."

Consent and Data APIs

In order to ensure you obtain consent from your users in applicable jurisdictions on behalf of our monetization partners and correctly pass consent flag values to Bidapp, please review App Policy Settings