Android SDK Integration Guide

Official integration guide for embedding Suloro Ads into native Android applications using Kotlin and Jetpack Compose.

1. Configure Maven Repository

Add the official Suloro Maven repository to your settings.gradle.kts file:

settings.gradle.kts

dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
        // Official Suloro Private & Production Maven Repository
        maven { url = uri("https://dl.suloro.com/android") }
    }
}

Add the SDK dependency to your app/build.gradle.kts file:

app/build.gradle.kts

dependencies {
    implementation("com.suloro.ads:suloro-ads:1.0.0")
    implementation("com.squareup.okhttp3:okhttp:4.12.0")
    implementation("io.coil-kt:coil-compose:2.6.0")
}

2. Initialize Network Client

Initialize once in your Application class or main entry activity:

MainActivity.kt

import com.suloro.ads.SuloroAds

class MainActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        SuloroAds.initialize(this)
    }
}

3. Banner Placement (Jetpack Compose)

BannerView.kt

@Composable
fun MainScreen() {
    Column(modifier = Modifier.fillMaxSize()) {
        Box(modifier = Modifier.weight(1f))
        
        // Docked Responsive Banner Ad (Test: SA-BA-987654321012)
        SuloroBannerAdView(
            adUnitId = "SA-BA-987654321012",
            modifier = Modifier.fillMaxWidth().height(52.dp)
        )
    }
}

4. Fullscreen Interstitial Ad

InterstitialDemo.kt

val interstitial = InterstitialAd(activity)
interstitial.load("SA-TEST-INTERSTITIAL-01", object : SuloroAdListener {
    override fun onAdLoaded(ad: SuloroAd) = interstitial.show()
    override fun onAdFailed(err: String) { /* Fallback */ }
})

5. Rewarded Experience

RewardedDemo.kt

val rewarded = RewardedAd(activity)
rewarded.load("SA-TEST-REWARDED-01", object : SuloroRewardedListener {
    override fun onUserEarnedReward(ad: SuloroAd, rewardType: String, amount: Int) {
        // Grant reward to user
    }
})