Android SDK Migration Guide

Non-Reward App

Non-Reward App Migration

Project Setup

Project-level build configuration

Change the daro-plugin dependency.

Latest version

daro-plugin :

buildscript {
    repositories {
        google()
        mavenCentral()
    }
    dependencies {
        // as-is
        // classpath("com.github.delightroom:daro-android-plugin:0.4.4")

        // to-be
        classpath("so.daro:daro-plugin:{version}")
    }
}

Apply the DARO plugin to build.gradle(app)

plugins {
    ...
    // as-is
    // id("droom.daro.a")

    // to-be
    id("so.daro.a")
    ...
}

Key file setup

General
If separate configuration per flavor is needed

Delete daro-services.json and download daro-key.txt and add it as follows.

app/
└── daro-key.txt

Configure daroAppKey.

Show Configure in gradle.properties

android.useAndroidX=true
android.enableJetifier=true
daroAppKey={APP_KEY}

Show Configure directly in app module gradle

Configure as follows in the app module build.gradle.

buildscript{
    extra["daroAppKey"] = "APP_KEY"
}

Delete daro-services.json and download daro-key.txt and add it as follows.

app/
└── src/
    ├── flavorA/
    │   └── daro-key.txt
    └── flavorB/
        └── daro-key.txt

Configure daroAppKey.

Show Configure in gradle.properties

android.useAndroidX=true
android.enableJetifier=true
daroAppKey.FlavorA={APP_KEY}
daroAppKey.FlavorB={APP_KEY}

Show Configure directly in app module gradle

Configure as follows in the app module build.gradle.

buildscript{
    extra["daroAppKey.FlavorA"] = "APP_KEY"
    extra["daroAppKey.FlavorB"] = "APP_KEY"
}

Please make sure the first letter of the Flavor is capitalized

daro-key.txt can be downloaded from the DARO dashboard.

daroAppKey can be found in the DARO dashboard.

Add Daro SDK dependency

The required SDK and versions change as follows.

Latest version

daro-core :
daro-a :
daro-compose-util :

dependencies {
    ...
    //as-is
    // implementation("com.github.delightroom:daro-android:0.x.x")

    //to-be
    implementation("so.daro:daro-core:{version}")
    implementation("so.daro:daro-a:{version}")

    implementation("so.daro:daro-compose-util:{version}") // Compose-Only
    ...
}

Both daro-core and daro-a must be implemented.

By adding the daro-compose-util module dependency, you can use ads in Compose.

Implementing Code

SDK initialization changes

The Daro SDK initialization method changes.

import android.app.Application
// import droom.daro.lib.Daro
import droom.daro.Daro
import kotlinx.coroutines.CoroutineScope

class SampleApp: Application() {

        override fun onCreate() {
        super.onCreate()

        // CoroutinScope.launch {
        //    Daro.init(application = this@SampleApp,)
        //}
        Daro.init(application = this@SampleApp)
    }
}

The package for the Daro class has changed.
- droom.daro.lib.Daro -> droom.daro.Daro
Instead of calling in a Coroutine, it can be called directly on the main thread.

Support for DaroNetworkConfiguration and DaroLogLevel settings has been discontinued.

Change Ad Unit ID used for ad loading

The Ad Unit ID used previously cannot be used in the new SDK.
Please get the new Ad Unit ID from the Daro dashboard and apply it to your code.

Using the existing Ad Unit ID will cause ad loading to fail. Be sure to replace the Ad Unit ID.

Change ad implementation logic

Show Banner/MREC Ad

Support for XML-based view implementation has been discontinued.
Classes required for ad loading have changed.
- droom.daro.lib.banner.DaroAdBannerView -> droom.daro.view.DaroAdBannerAdView
- droom.daro.lib.adunit.DaroAdBannerUnit -> droom.daro.core.DaroBannerAdUnit
The refreshSeconds field has been removed.
From now on, you can set the refresh interval remotely from the Daro dashboard.
For details, please refer to the integration documentation

Show Native Ad

Support for XML-based view implementation has been discontinued.
Classes required for ad loading have changed.
- droom.daro.lib.banner.DaroAdNativeView -> droom.daro.view.DaroNativeAdView
- droom.daro.lib.adunit.DaroAdNativeUnit -> droom.daro.core.DaroNativeAdUnit

The method of receiving and rendering native ads has changed.

val adBinder = DaroNativeAdBinder.Builder(view)
    .setIconViewId(${iconViewId})
    .setBodyTextViewId(${bodyViewId})
    .setCallToActionViewId(${callToActionViewId})
    .setMediaViewGroupId(${mediaViewGroupId})
    .setTitleViewId(${titleViewId})
    .build()

val adUnit = DaroNativeAdUnit(
    key = ${key},
    placement = ${placement},
    adBinder = adBInder
)

val adView = DaroNativeAdView(
    context = context,
    adUnit = adUnit
)

adView.load()

When using templates, you can now customize background color, fonts, etc.
The refreshSeconds field has been removed.
From now on, you can set the refresh interval remotely from the Daro dashboard.
For details, please refer to the integration documentation

Show Interstitial Ad

Classes required for ad loading have changed.
- droom.daro.lib.interstitial.DaroInterstitialAdLoader -> droom.daro.loader.DaroInterstitialAdLoader
- droom.daro.lib.adunit.DaroAdInterstitialUnit -> droom.daro.core.adunit.DaroInterstitialAdUnit

The method of handling success and failure when calling ads has changed to use listeners instead of lambda.

val loader = DaroInterstitialAdLoader(
    context = context,
    adUnit = adUnit
)
loader.setListener(object : DaroInterstitialAdLoaderListener {
    override fun onAdLoadSuccess(ad: DaroInterstitialAd, adInfo: DaroAdInfo) {
        // ...
    }
    override fun onAdLoadFail(err: DaroAdLoadError) {
        // ...
    }
})
loader.load()

For details, please refer to the integration documentation

Show Rewarded Video Ad

Classes required for ad loading have changed.
- droom.daro.lib.reward.DaroRewardedAdLoader -> droom.daro.loader.DaroRewardedAdLoader
- droom.daro.lib.adunit.DaroAdRewardedUnit -> droom.daro.core.adunit.DaroRewardedAdUnit

The method of handling success and failure when calling ads has changed to use listeners instead of lambda.

val loader = DaroRewardedAdLoader(
    context = context,
    adUnit = adUnit
)
loader.setListener(object : DaroRewardedAdLoaderListener {
    override fun onAdLoadSuccess(ad: DaroRewardedAd, adInfo: DaroAdInfo) {
        // ...
    }
    override fun onAdLoadFail(err: DaroAdLoadError) {
        // ...
    }
})
loader.load()

For details, please refer to the integration documentation

Show Light Popup Ad

Classes required for ad loading have changed.
- droom.daro.lib.lightpopup.DaroLightPopupAdLoader -> `droom.daro.loader.DaroLightPopupAdLoader
- droom.daro.lib.adunit.DaroAdLightPopupUnit -> droom.daro.core.adunit.DaroLightPopupAdUnit

The method of handling success and failure when calling ads has changed to use listeners instead of lambda.

val loader = DaroLightPopupAdLoader(
    context = context,
    adUnit = adUnit
)
loader.setListener(object : DaroLightPopupAdLoaderListener {
    override fun onAdLoadSuccess(ad: DaroLightPopupAd, adInfo: DaroAdInfo) {
        // ...
    }
    override fun onAdLoadFail(err: DaroAdLoadError) {
        // ...
    }
})
loader.load()

For details, please refer to the integration documentation

Reward App

Reward App Migration

Project Setup

Project-level build configuration

Change the daro-plugin dependency.

Latest version

daro-plugin :

buildscript {
    repositories {
        google()
        mavenCentral()
        maven { url = uri("https://artifacts.applovin.com/android") }
    }
    dependencies {
        // as-is
        // classpath("com.github.delightroom:daro-android-plugin:0.4.4")

        // to-be
        classpath("so.daro:daro-plugin:{version}")
        classpath("com.applovin.quality:AppLovinQualityServiceGradlePlugin:5.5.2")
    }
}

Apply the DARO plugin to build.gradle(app)

plugins {
    ...
    // as-is
    // id("droom.daro.m")

    // to-be
    id("so.daro.m")
    ...
}

Key file setup

General
If separate configuration per flavor is needed

Delete daro-services.json and download daro-key.txt and add it as follows.

app/
└── daro-key.txt

Configure daroAppKey.

Show Configure in gradle.properties

android.useAndroidX=true
android.enableJetifier=true
daroAppKey={APP_KEY}

Show Configure directly in app module gradle

Configure as follows in the app module build.gradle.

buildscript{
    extra["daroAppKey"] = "APP_KEY"
}

Delete daro-services.json and download daro-key.txt and add it as follows.

app/
└── src/
    ├── flavorA/
    │   └── daro-key.txt
    └── flavorB/
        └── daro-key.txt

Configure daroAppKey.

Show Configure in gradle.properties

android.useAndroidX=true
android.enableJetifier=true
daroAppKey.FlavorA={APP_KEY}
daroAppKey.FlavorB={APP_KEY}

Show Configure directly in app module gradle

Configure as follows in the app module build.gradle.

buildscript{
    extra["daroAppKey.FlavorA"] = "APP_KEY"
    extra["daroAppKey.FlavorB"] = "APP_KEY"
}

Please make sure the first letter of the Flavor is capitalized

daro-key.txt can be downloaded from the DARO dashboard.

daroAppKey can be found in the DARO dashboard.

Add Daro SDK dependency

The required SDK and versions change as follows.

Latest version

daro-core :
daro-m :
daro-compose-util :

dependencies {
    ...
    //as-is
    // implementation("com.github.delightroom:daro-android-m:0.x.x")

    //to-be
    implementation("so.daro:daro-core:{version}")
    implementation("so.daro:daro-m:{version}")

    implementation("so.daro:daro-compose-util:{version}") // Compose-Only
    ...
}

Both daro-core and daro-m must be implemented.

By adding the daro-compose-util module dependency, you can use ads in Compose.

Implementing Code

SDK initialization changes

The package for the Daro class has changed.

droom.daro.m.Daro -> droom.daro.Daro

Support for DaroLogLevel setting has been discontinued.

Change Ad Unit ID used for ad loading

The Ad Unit ID used previously cannot be used in the new SDK.
Please get the new Ad Unit ID from the Daro dashboard and apply it to your code.

Using the existing Ad Unit ID will cause ad loading to fail. Be sure to replace the Ad Unit ID.

Change ad implementation logic

Show Banner/MREC Ad

Support for XML-based view implementation has been discontinued.
Classes required for ad loading have changed.
- room.daro.m.banner.DaroMBannerView -> droom.daro.view.DaroAdBannerAdView
- droom.daro.m.adunit.DaroMAdBannerUnit -> droom.daro.core.DaroBannerAdUnit
The refreshSeconds field has been removed.
From now on, you can set the refresh interval remotely from the Daro dashboard.
For details, please refer to the integration documentation

Show Native Ad

Support for XML-based view implementation has been discontinued.
Classes required for ad loading have changed.
- droom.daro.m.nativead.DaroMNativeView -> droom.daro.view.DaroNativeAdView
- droom.daro.m.adunit.DaroMAdNativeUnit -> droom.daro.core.DaroNativeAdUnit

The method of setting AdBinder has changed.

val adBinder = DaroNativeAdBinder.Builder(view)
    .setIconViewId(${iconViewId})
    .setBodyTextViewId(${bodyViewId})
    .setCallToActionViewId(${callToActionViewId})
    .setMediaViewGroupId(${mediaViewGroupId})
    .setTitleViewId(${titleViewId})
    .build()

val adUnit = DaroNativeAdUnit(
    key = ${key},
    placement = ${placement},
    adBinder = adBInder
)

val adView = DaroNativeAdView(
    context = context,
    adUnit = adUnit
)

adView.load()

Templates provided by the SDK have been added.
The refreshSeconds field has been removed.
From now on, you can set the refresh interval remotely from the Daro dashboard.
For details, please refer to the integration documentation

Show Interstitial Ad

Classes required for ad loading have changed.
- droom.daro.m.interstitial.DaroMInterstitialAdLoader -> droom.daro.loader.DaroInterstitialAdLoader
- droom.daro.m.adunit.DaroMAdInterstitialUnit -> droom.daro.core.adunit.DaroInterstitialAdUnit

The method of handling success and failure when calling ads has changed to use listeners instead of lambda.

val loader = DaroInterstitialAdLoader(
    context = context,
    adUnit = adUnit
)
loader.setListener(object : DaroInterstitialAdLoaderListener {
    override fun onAdLoadSuccess(ad: DaroInterstitialAd, adInfo: DaroAdInfo) {
        // ...
    }
    override fun onAdLoadFail(err: DaroAdLoadError) {
        // ...
    }
})
loader.load()

For details, please refer to the integration documentation

Show Rewarded Video Ad

Classes required for ad loading have changed.
- droom.daro.m.reward.DaroMRewardedAdLoader -> droom.daro.loader.DaroRewardedAdLoader
- droom.daro.m.adunit.DaroMAdRewardedUnit -> droom.daro.core.adunit.DaroRewardedAdUnit

The method of handling success and failure when calling ads has changed to use listeners instead of lambda.

val loader = DaroRewardedAdLoader(
    context = context,
    adUnit = adUnit
)
loader.setListener(object : DaroRewardedAdLoaderListener {
    override fun onAdLoadSuccess(ad: DaroRewardedAd, adInfo: DaroAdInfo) {
        // ...
    }
    override fun onAdLoadFail(err: DaroAdLoadError) {
        // ...
    }
})
loader.load()

For details, please refer to the integration documentation

Show Light Popup Ad

Classes required for ad loading have changed.
- droom.daro.m.lightpopup.DaroMLightPopupAdLoader -> `droom.daro.loader.DaroLightPopupAdLoader
- droom.daro.m.adunit.DaroMAdLightPopupUnit -> droom.daro.core.adunit.DaroLightPopupAdUnit

The method of handling success and failure when calling ads has changed to use listeners instead of lambda.

val loader = DaroLightPopupAdLoader(
    context = context,
    adUnit = adUnit
)
loader.setListener(object : DaroLightPopupAdLoaderListener {
    override fun onAdLoadSuccess(ad: DaroLightPopupAd, adInfo: DaroAdInfo) {
        // ...
    }
    override fun onAdLoadFail(err: DaroAdLoadError) {
        // ...
    }
})
loader.load()

For details, please refer to the integration documentation

Support for setting extraParameter and localExtraParameter has been discontinued for all ads.

Getting Started

SDK Integration

How to Use DARO

FAQ

Android SDK Migration Guide

Non-Reward App

Project Setup

Implementing Code

Reward App

Project Setup

Implementing Code

Getting Started

SDK Integration

How to Use DARO

FAQ

​Non-Reward App

​Project Setup

​Implementing Code

​Reward App

​Project Setup

​Implementing Code

Non-Reward App

Project Setup

Implementing Code

Reward App

Project Setup

Implementing Code