MultiAds

1.1.7indexed

Lightweight, visual-first advertising SDK simplifying interstitial, rewarded and banner ad integration with visual state indicators, automatic retries, reactive ad switching, and lifecycle-aware loading control.

AndroidNative·saifullah-nurani/MultiAds

Stars

—

Used by

dependents

—

Health

/ 100

💎 MultiAds

A Premium, Lightweight & Mediated Kotlin Multiplatform Ad Library for Android and iOS

🤖 Android (SDK 21+) • 🍏 iOS (14.1+) • 🎨 Compose Multiplatform • ⚡ Waterfall Mediation

MultiAds provides a complete, performance-optimized, and unified solution to load and show ads across both Android and iOS platforms. It wraps official native SDKs to ensure maximum rendering reliability and ad delivery rates.

Key Features 🌟

Modules

Version

The latest release version for all multiplatform artifacts:

val multiAdsVersion = "1.1.7"

Repositories

Some ad SDK repositories must be added in the consumer app:

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        maven(url = "https://artifact.bytedance.com/repository/pangle/")
        maven(url = "https://android-sdk.is.com/")
    }
}

Installation

KMM / Compose Multiplatform

Add modules in commonMain:

sourceSets {
    commonMain.dependencies {
        implementation("io.github.saifullah-nurani.ads:multi-ads:1.1.7")

        // Optional standalone modules
        implementation("io.github.saifullah-nurani.ads:admob:1.1.7")
        implementation("io.github.saifullah-nurani.ads:applovin:1.1.7")
        implementation("io.github.saifullah-nurani.ads:pangle:1.1.7")
        implementation("io.github.saifullah-nurani.ads:vungle:1.1.7")
        implementation("io.github.saifullah-nurani.ads:inmobi:1.1.7")
        implementation("io.github.saifullah-nurani.ads:ironsource:1.1.7")
        implementation("io.github.saifullah-nurani.ads:man:1.1.7")
    }
}

Android-only

Use Android AAR variants:

dependencies {
    implementation("io.github.saifullah-nurani.ads:multi-ads-android:1.1.7")

    // Optional standalone modules
    implementation("io.github.saifullah-nurani.ads:admob-android:1.1.7")
    implementation("io.github.saifullah-nurani.ads:applovin-android:1.1.7")
    implementation("io.github.saifullah-nurani.ads:pangle-android:1.1.7")
    implementation("io.github.saifullah-nurani.ads:vungle-android:1.1.7")
    implementation("io.github.saifullah-nurani.ads:inmobi-android:1.1.7")
    implementation("io.github.saifullah-nurani.ads:ironsource-android:1.1.7")
    implementation("io.github.saifullah-nurani.ads:man-android:1.1.7")
}

R8 / ProGuard

consumer-rules.pro is already bundled in every published module.

That means:

public models/config classes are already kept
module API packages are already protected
required SDK keep rules are already included

In normal usage you do not need to manually copy extra ProGuard rules from this repo into your app.

Initialization

Initialize each SDK once before loading ads.

Compose commonMain

val admobReady = rememberAdmobAdsInit(
    androidAppId = "ANDROID_APP_ID",
    iosAppId = "IOS_APP_ID"
)

val appLovinReady = rememberAppLovinAdsInit(
    androidSdkKey = ,
    iosSdkKey = 
)

 pangleReady = rememberPangleAdsInit(
    androidAppId = ,
    iosAppId = 
)

 vungleReady = rememberVungleAdsInit(
    androidAppId = ,
    iosAppId = 
)

 inMobiReady = rememberInMobiAdsInit(
    androidAccountId = ,
    iosAccountId = 
)

 ironSourceReady = rememberIronSourceAdsInit(
    androidAppKey = ,
    iosAppKey = 
)

 metaReady = rememberMetaAudienceNetworkAdsInit()

Shared non-Compose init

AdmobAds.init(context)

AppLovinAds.init(
    context = context,
    androidSdkKey = "ANDROID_SDK_KEY",
    iosSdkKey = "IOS_SDK_KEY"
)

PangleAds.init(
    context = context,
    androidAppId = "ANDROID_APP_ID",
    iosAppId = "IOS_APP_ID"
)

VungleAds.init(
    context = context,
    androidAppId = ,
    iosAppId = 
)

InMobiAds.(
    context = context,
    androidAccountId = ,
    iosAccountId = 
)

IronSourceAds.(
    context = context,
    androidAppKey = ,
    iosAppKey = 
)

MetaAudienceNetworkAds.(context)

Shared property helpers

All standalone modules support a request tag.

Standalone module usage

AdMob

import io.github.saifullah.nurani.ads.admob.compose.AdmobBannerAd
import io.github.saifullah.nurani.ads.admob.compose.rememberAdmobInterstitialAd
import io.github.saifullah.nurani.ads.admob.compose.rememberAdmobRewardedAd
import io.github.saifullah.nurani.ads.admob.compose.rememberAdmobRewardedInterstitialAd

val interstitial = rememberAdmobInterstitialAd(properties = admob)
val rewarded = rememberAdmobRewardedAd(properties = admob)
val rewardedInterstitial = rememberAdmobRewardedInterstitialAd(properties = admob)

AdmobBannerAd(
    properties = admob,
    testModeEnabled = true,
    expandWhenReady = true
)

AppLovin

import io.github.saifullah.nurani.ads.applovin.compose.AppLovinBannerAd
import io.github.saifullah.nurani.ads.applovin.compose.rememberAppLovinInterstitialAd
import io.github.saifullah.nurani.ads.applovin.compose.rememberAppLovinRewardedAd

val interstitial = rememberAppLovinInterstitialAd(properties = appLovin)
val rewarded = rememberAppLovinRewardedAd(properties = appLovin)

AppLovinBannerAd(
    properties = appLovin,
    testModeEnabled = true,
    expandWhenReady = true
)

Pangle

import io.github.saifullah.nurani.ads.pangle.compose.PangleBannerAd
import io.github.saifullah.nurani.ads.pangle.compose.rememberPangleInterstitialAd
import io.github.saifullah.nurani.ads.pangle.compose.rememberPangleRewardedAd

val interstitial = rememberPangleInterstitialAd(properties = pangle)
val rewarded = rememberPangleRewardedAd(properties = pangle)

PangleBannerAd(
    properties = pangle,
    testModeEnabled = true,
    expandWhenReady = true
)

Vungle

import io.github.saifullah.nurani.ads.vungle.compose.VungleBannerAd
import io.github.saifullah.nurani.ads.vungle.compose.rememberVungleInterstitialAd
import io.github.saifullah.nurani.ads.vungle.compose.rememberVungleRewardedAd

val interstitial = rememberVungleInterstitialAd(properties = vungle)
val rewarded = rememberVungleRewardedAd(properties = vungle)

VungleBannerAd(
    properties = vungle,
    testModeEnabled = true,
    expandWhenReady = true
)

InMobi

import io.github.saifullah.nurani.ads.inmobi.compose.InMobiBannerAd
import io.github.saifullah.nurani.ads.inmobi.compose.rememberInMobiInterstitialAd
import io.github.saifullah.nurani.ads.inmobi.compose.rememberInMobiRewardedAd

val interstitial = rememberInMobiInterstitialAd(properties = inmobi)
val rewarded = rememberInMobiRewardedAd(properties = inmobi)

InMobiBannerAd(
    properties = inmobi,
    testModeEnabled = true,
    expandWhenReady = true
)

IronSource

import io.github.saifullah.nurani.ads.ironsource.compose.IronSourceBannerAd
import io.github.saifullah.nurani.ads.ironsource.compose.rememberIronSourceInterstitialAd
import io.github.saifullah.nurani.ads.ironsource.compose.rememberIronSourceRewardedAd

val interstitial = rememberIronSourceInterstitialAd(properties = ironSource)
val rewarded = rememberIronSourceRewardedAd(properties = ironSource)

IronSourceBannerAd(
    properties = ironSource,
    testModeEnabled = true,
    expandWhenReady = true
)

Waterfall module (`multi-ads`)

multi-ads loads networks by priority and can keep multiple requests active concurrently.

Waterfall config

import io.github.saifullah.nurani.ads.multi.models.waterfallConfig

val waterfall = waterfallConfig {
    maxConcurrentLoads(2)
    admob("ADMOB_UNIT_ID", priority = 1)
    applovin("APPLOVIN_UNIT_ID", priority = 2)
    pangle("PANGLE_UNIT_ID", priority = 3)
    vungle("VUNGLE_PLACEMENT_ID", priority = 4)
    inmobi(123456789L, priority = 5)
    ironsource("IRONSOURCE_PLACEMENT_NAME", priority = )
}

Interstitial

import io.github.saifullah.nurani.ads.multi.compose.rememberMultiInterstitialAd

val interstitial = rememberMultiInterstitialAd(
    waterfallConfig = waterfall,
    testModeEnabled = true,
    initialLoad = true,
    tag = "session-123"
)

Rewarded

import io.github.saifullah.nurani.ads.multi.compose.rememberMultiRewardedAd

val rewarded = rememberMultiRewardedAd(
    waterfallConfig = waterfall,
    testModeEnabled = true,
    initialLoad = true,
    tag = "session-123",
    onUserRewarded = {
        // reward user
    }
)

Banner

Simple overload:

import io.github.saifullah.nurani.ads.core.AdSize
import io.github.saifullah.nurani.ads.core.BannerAd
import io.github.saifullah.nurani.ads.multi.compose.MultiBannerAd

MultiBannerAd(
    waterfallConfig = waterfall,
    testModeEnabled = true,
    expandWhenReady = true,
    animateExpansion = true,
    adSize = BannerAd.Fixed(AdSize.BANNER),
    tag = "banner-session"
)

Advanced DSL config:

Shared waterfall config object

Use MultiAdsConfig when you want one place for tag/logger/retry/refresh/test mode:

import io.github.saifullah.nurani.ads.multi.models.multiAdsConfig

val config = multiAdsConfig {
    isTestModeEnabled = true
    tag = "global-session"
    waterfall {
        maxConcurrentLoads(2)
        admob("ADMOB_UNIT_ID", 1)
        applovin("APPLOVIN_UNIT_ID", 2)
    }
}

Then:

import io.github.saifullah.nurani.ads.multi.compose.MultiBannerAd
import io.github.saifullah.nurani.ads.multi.compose.rememberMultiInterstitialAd
import io.github.saifullah.nurani.ads.multi.compose.rememberMultiRewardedAd
import io.github.saifullah.nurani.ads.multi.models.multiBannerAdConfig

val interstitial = rememberMultiInterstitialAd(multiAdsConfig = config)
val rewarded = rememberMultiRewardedAd(multiAdsConfig = config)

MultiBannerAd(
    multiAdsConfig = config,
    config = multiBannerAdConfig {
        expandWhenReady = true
    }
)

Multi callbacks

multi-ads supports network-aware callbacks:

MultiAdLoadCallback
MultiAdContentCallback
MultiAdListener for banners

These callbacks tell you which network actually loaded or showed the ad.

App open support in waterfall

MultiAppOpenAd currently supports:

AdMob
AppLovin

Example:

val appOpenWaterfall = waterfallConfig {
    maxConcurrentLoads(2)
    admob("ADMOB_APP_OPEN_ID", 1)
    applovin("APPLOVIN_APP_OPEN_ID", 2)
}

val appOpenAd = MultiAppOpenAd(context).apply {
    waterfallConfig = appOpenWaterfall
    testModeEnabled = true
    tag = "app-open-session"
}

appOpenAd.loadAd()

Native app-open auto show

Compose app-open helpers were removed. Use native registration APIs instead.

Android

Available in:

AdmobNativeAppOpen
AppLovinNativeAppOpen
PangleNativeAppOpen
MultiNativeAppOpen

Example:

import android.app.Application
import androidx.lifecycle.Lifecycle
import io.github.saifullah.nurani.ads.admob.AdmobNativeAppOpen

AdmobNativeAppOpen.register(
    application = application,
    adUnitId = "APP_OPEN_ID",
    initialLoad = true,
    testModeEnabled = true
) {
    anyActivity()
    // or:
    // activity<MainActivity>(Lifecycle.Event.ON_RESUME)
    // fragment<HomeFragment>(Lifecycle.Event.ON_RESUME)
}

iOS

Available in:

AdmobNativeAppOpen
AppLovinNativeAppOpen
PangleNativeAppOpen
MultiNativeAppOpen

Example:

import io.github.saifullah.nurani.ads.admob.AdmobNativeAppOpen
import io.github.saifullah.nurani.ads.core.IosAppOpenLifecycleState

val handle = AdmobNativeAppOpen.register(
    adUnitId = "APP_OPEN_ID",
    initialLoad = true,
    testModeEnabled = true
) {
    appDidBecomeActive()
    // or:
    // appWillEnterForeground()
    // viewController<MyViewController>(IosAppOpenLifecycleState.VIEW_DID_APPEAR)
}

If you use view-controller based rules, forward lifecycle manually:

handle.notifyViewWillAppear(viewController)
handle.notifyViewDidAppear(viewController)

Dispose when no longer needed:

handle.dispose()

Android SDK setup reminders

Some SDKs still require their normal manifest / plist setup:

AdMob: APPLICATION_ID in AndroidManifest and GADApplicationIdentifier in Info.plist
AppLovin: SDK key in Android manifest / placeholders and Info.plist
Pangle: app id initialization before load
Vungle: app id initialization before load
InMobi: account id initialization before load

Sample app

The sample module contains working showcase screens for:

standalone networks
multi-network waterfall
banner, interstitial, rewarded, and app-open scenarios

License

MIT. See LICENSE.

Related libraries

Surfaced from shared tags and platforms — no rankings paid for.

KScan★ 336

ismai117Enables easy barcode scanning in apps using Google’s MLKit on Android and Apple's AVFoundation on iOS, supporting QR and EAN-13 formats with simple integration.Shared: ui, compose-multiplatform, compose

Alert-KMP★ 103

KhubaibKhan4Facilitates native notification displays across Android, iOS, Web, and Desktop using JetBrains Compose. Features customizable notifications, event handling, and local notifications support with a unified API.Shared: ui, sdk, compose-multiplatform

summon★ 158

codeyousefPowerful type-safe frontend framework delivers reactive state management, component-based architecture, and comprehensive styling for building elegant, responsive applications with declarative syntax and enhanced UI capabilities.Shared: ui, state-management, compose-multiplatform

compose-shimmer★ 1.0k

valentinilkOffers shimmering animation for UI elements, integrated via a simple modifier. Includes customization options like theming and animation boundaries. Supports advanced usage scenarios and custom modifiers.Shared: ui, compose-multiplatform, compose

JetLime★ 605

pushpalroyHighly customizable UI library for creating vertical and horizontal timeline views. Supports extended events, various alignment options, custom styles, animations, and dynamic content updates in a timeline format.Shared: ui, compose-multiplatform, compose

JetCo★ 375

developerchunkReady-to-use, customizable Compose UI components — charts, cards, steppers, controls — offering polished visuals, interactive behaviors, performance optimizations, and easy integration into declarative UI projects.Shared: ui, compose-multiplatform, compose

Core	`core`	Shared abstractions	Shared configurations, retry/refresh policies, callback managers
AdMob	`admob`	Banner, Interstitial, Rewarded, Rewarded Interstitial, App Open	Google Mobile Ads SDK implementation
AppLovin	`applovin`	Banner, Interstitial, Rewarded, App Open	AppLovin MAX SDK implementation
Pangle	`pangle`	Banner, Interstitial, Rewarded, App Open	ByteDance PAGAdSDK implementation
Vungle	`vungle`	Banner, Interstitial, Rewarded	Liftoff Vungle Ads SDK implementation
InMobi	`inmobi`	Banner, Interstitial, Rewarded	InMobi Ads SDK implementation
IronSource	`ironsource`	Banner, Interstitial, Rewarded	Unity IronSource SDK implementation
Meta	`man`	Banner, Interstitial, Rewarded	Meta Audience Network SDK implementation
Waterfall	`multi-ads`	Mediation Banner, Interstitial, Rewarded, App Open	Priority-concurrency mediated waterfall orchestration

MultiAds

💎 MultiAds

Key Features 🌟

Modules

Version

Repositories

Installation

KMM / Compose Multiplatform

Android-only

R8 / ProGuard

Initialization

Compose commonMain

Shared non-Compose init

Shared property helpers

Standalone module usage

AdMob

AppLovin

Pangle

Vungle

InMobi

IronSource

Meta

Waterfall module (multi-ads)

Waterfall config

Interstitial

Rewarded

Banner

Shared waterfall config object

Multi callbacks

App open support in waterfall

Native app-open auto show

Android

iOS

Android SDK setup reminders

Sample app

License

Related libraries

💎 MultiAds

Key Features 🌟

Modules

Version

Repositories

Installation

KMM / Compose Multiplatform

Android-only

R8 / ProGuard

Initialization

Compose commonMain

Shared non-Compose init

Shared property helpers

Standalone module usage

AdMob

AppLovin

Pangle

Vungle

InMobi

IronSource

Meta

Waterfall module (multi-ads)

Waterfall config

Interstitial

Rewarded

Banner

Shared waterfall config object

Multi callbacks

App open support in waterfall

Native app-open auto show

Android

iOS

Android SDK setup reminders

Sample app

License

Related libraries

Waterfall module (`multi-ads`)

Waterfall module (`multi-ads`)