# pop.onl Android SDK

Free ad mediation. pop.onl calls each ad network's own SDK directly, in the waterfall order you set on
[pop.onl](https://pop.onl); no other mediation sits in between. Formats: rewarded and interstitial.

- Core `onl.pop:ads` has no dependencies (Android framework only).
- One adapter per network, `onl.pop:ads-<network>`, which brings that network's SDK with it.
- minSdk 24, Java 17.

## Install

`settings.gradle.kts`:

```kotlin
dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
        maven { url = uri("https://maven.pop.onl") }
        // Only for the networks you add (each publishes on its own server):
        maven { url = uri("https://artifact.bytedance.com/repository/pangle") }                        // pangle
        maven { url = uri("https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea") } // mintegral
        maven { url = uri("https://cboost.jfrog.io/artifactory/chartboost-ads/") }                      // chartboost
        maven { url = uri("https://s3.amazonaws.com/smaato-sdk-releases/") }                            // smaato
        maven { url = uri("https://maven.ogury.co") }                                                   // ogury
        maven { url = uri("https://aa-sdk.s3-eu-west-1.amazonaws.com/android_repo") }                   // superawesome
        maven { url = uri("https://ysonetwork.s3.eu-west-3.amazonaws.com/sdk/android") }                // ysonetwork
    }
}
```

`app/build.gradle.kts` — the core plus one line per network you turned on at pop.onl:

```kotlin
dependencies {
    implementation("onl.pop:ads:0.1.0")
    implementation("onl.pop:ads-admob:0.1.0")
    implementation("onl.pop:ads-unityads:0.1.0")
    // ...
}
```

## Use

```kotlin
class App : Application() {
    override fun onCreate() {
        super.onCreate()
        PopOnlAds.setConsent(true)          // from your consent dialog (GDPR); leave unset if unknown
        PopOnlAds.setChildDirected(false)   // COPPA
        PopOnlAds.initialize(this, "YOUR_APP_KEY")
    }
}

// In an Activity:
if (PopOnlAds.isRewardedReady("level_end")) {
    PopOnlAds.showRewarded(this, "level_end") { earned -> if (earned) giveCoins() }
}
if (PopOnlAds.isInterstitialReady()) PopOnlAds.showInterstitial(this, "between_levels")
```

The app key is on pop.onl → Apps. Adapters on the classpath register themselves; nothing else to call.
Ads load in the background and reload after each show. Callbacks run on the main thread.

## Networks

| Network | Adapter | Set on pop.onl (app) | Line id |
|---|---|---|---|
| AdMob | `ads-admob` | app_id (also put it in AndroidManifest `com.google.android.gms.ads.APPLICATION_ID`) | ad unit id |
| Unity Ads | `ads-unityads` | game_id | placement id |
| Pangle | `ads-pangle` | app_id | placement id |
| Liftoff (Vungle) | `ads-liftoff` | app_id | placement reference id |
| Mintegral | `ads-mintegral` | app_id, app_key | `placement_id/unit_id` |
| InMobi | `ads-inmobi` | account_id | placement id (number) |
| Chartboost | `ads-chartboost` | app_id, app_signature | location |
| DT Exchange | `ads-dtexchange` | app_id | spot id |
| Yandex | `ads-yandex` | — | ad unit id |
| BIGO Ads | `ads-bigo` | app_id | slot id |
| myTarget | `ads-mytarget` | — | slot id (number) |
| Smaato | `ads-smaato` | publisher_id | ad space id |
| Ogury | `ads-ogury` | asset_key | ad unit id |
| Start.io | `ads-startio` | app_id | ad tag (optional) |
| LINE (FiveAd) | `ads-line` | app_id | slot id |
| SuperAwesome | `ads-superawesome` | — | placement id (number) |
| YSO Network | `ads-ysonetwork` | — | key |

Bidding-only networks (Meta, AppLovin, Moloco, Amazon, PubMatic, MobileFuse, Verve) are listed on pop.onl but
have no adapter yet: they sell through bidding, which pop.onl does not run yet.

## Build from source

```bash
./gradlew publish     # writes every module to build/repo
```

Checking the adapters with no downloads, against a local Gradle cache:

```bash
tools/offline-libs.sh ~/.gradle/caches/modules-2/files-2.1 /tmp/offline-libs
./gradlew --offline -Ppoponl.offlineLibs=/tmp/offline-libs compileReleaseKotlin
```
