Android SDK 마이그레이션 가이드

Non-Reward 앱

Non-Reward 앱 Migration

프로젝트 세팅

프로젝트 단위 빌드 설정

daro-plugin 의존성을 변경합니다.

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}")
    }
}

build.gradle(app)에 daro plugin 적용

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

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

key file 설정

일반
flavor 별 분기가 필요한 경우

daro-services.json룰 삭제하고 아래처럼 daro-key.txt를 다운받아 아래처럼 추가합니다.

app/
└── daro-key.txt

daroAppKey 를 설정합니다.

Show gradle.properties 에 설정하기

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

Show app 모듈 gradle에 직접 설정하기

app 모듈 build.gradle에 아래와 같이 설정합니다.

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

daro-key.txt는 DARO 대시보드에서 다운받을 수 있습니다.

daroAppKey는 DARO 대시보드에서 확인할 수 있습니다.

Daro SDK 의존성 추가

다음과 같이 필요 sdk 및 버전이 변경됩니다.

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
    ...
}

daro-core, daro-a 2가지 모두 implementation 해야합니다.

daro-compose-util모듈 의존성 추가를 통해 compose에서도 광고를 사용하실 수 있습니다.

코드 구현하기

SDK 초기화 변경

Daro SDK 초기화 방식이 변경됩니다.

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)
    }
}

Daro 클래스의 패키지가 변경되었습니다.
- droom.daro.lib.Daro -> droom.daro.Daro
Coroutine에서 호출하는 대신 메인 스레드에서 직접 호출가능합니다.

DaroNetworkConfiguration, DaroLogLevel 설정 지원이 중단됩니다.

광고 Load에 사용하는 Ad Unit Id 변경

과거에 사용하던 Ad Unit Id가 새로운 SDK에서는 사용이 불가능합니다.
이에 따라 Daro 대시보드에서 변경된 Ad Unit Id를 받아서 코드에 적용해주세요

기존의 Ad Unit Id를 사용하면 광고 load에 실패하게 됩니다.. 반드시 Ad Unit Id를 교체해주세요.

광고 구현 로직 변경

Show 배너/MREC 광고

Xml 방식으로 뷰를 구현하는 방식 지원이 중단됩니다.
광고 load에 필요한 클래스들이 변경됩니다.
- droom.daro.lib.banner.DaroAdBannerView -> droom.daro.view.DaroAdBannerAdView
- droom.daro.lib.adunit.DaroAdBannerUnit -> droom.daro.core.DaroBannerAdUnit
refreshSeconds 필드가 제거됩니다.
이제부터 다로 대시보드에서 remote로 새로고침 주기를 설정할 수 있습니다.
자세한 내용은 연동 문서를 참조해주세요

Show 네이티브 광고

Xml 방식으로 뷰를 구현하는 방식 지원이 중단됩니다.
광고 load에 필요한 클래스들이 변경됩니다.
- droom.daro.lib.banner.DaroAdNativeView -> droom.daro.view.DaroNativeAdView
- droom.daro.lib.adunit.DaroAdNativeUnit -> droom.daro.core.DaroNativeAdUnit

네이티브 광고를 받아서 광고를 그리는 방식이 변경됩니다.

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()

template을 사용하는 경우 배경색, 폰트 등을 customize가 가능해집니다.
refreshSeconds 필드가 제거됩니다.
이제부터 다로 대시보드에서 remote로 새로고침 주기를 설정할 수 있습니다.
자세한 내용은 연동 문서를 참조해주세요

Show 인터스티셜 광고

광고 load에 필요한 클래스들이 변경됩니다.
- droom.daro.lib.interstitial.DaroInterstitialAdLoader -> droom.daro.loader.DaroInterstitialAdLoader
- droom.daro.lib.adunit.DaroAdInterstitialUnit -> droom.daro.core.adunit.DaroInterstitialAdUnit

광고 호출 시 success, fail을 처리하는 방식이 lamda 대신 listener를 통해 처리하도록 변경됩니다.

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()

자세한 내용은 연동 문서를 참조해주세요

Show 리워드 비디오 광고

광고 load에 필요한 클래스들이 변경됩니다.
- droom.daro.lib.reward.DaroRewardedAdLoader -> droom.daro.loader.DaroRewardedAdLoader
- droom.daro.lib.adunit.DaroAdRewardedUnit -> droom.daro.core.adunit.DaroRewardedAdUnit

광고 호출 시 success, fail을 처리하는 방식이 lamda 대신 listener를 통해 처리하도록 변경됩니다.

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()

자세한 내용은 연동 문서를 참조해주세요

Show 라이트 팝업 광고

광고 load에 필요한 클래스들이 변경됩니다.
- droom.daro.lib.lightpopup.DaroLightPopupAdLoader -> `droom.daro.loader.DaroLightPopupAdLoader
- droom.daro.lib.adunit.DaroAdLightPopupUnit -> droom.daro.core.adunit.DaroLightPopupAdUnit

광고 호출 시 success, fail을 처리하는 방식이 lamda 대신 listener를 통해 처리하도록 변경됩니다.

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()

자세한 내용은 연동 문서를 참조해주세요

Reward 앱

Reward 앱 Migration

프로젝트 세팅

프로젝트 단위 빌드 설정

daro-plugin 의존성을 변경합니다.

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")
    }
}

build.gradle(app)에 daro plugin 적용

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

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

key file 설정

일반
flavor 별 분기가 필요한 경우

daro-services.json룰 삭제하고 아래처럼 daro-key.txt를 다운받아 아래처럼 추가합니다.

app/
└── daro-key.txt

daroAppKey 를 설정합니다.

Show gradle.properties 에 설정하기

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

Show app 모듈 gradle에 직접 설정하기

app 모듈 build.gradle에 아래와 같이 설정합니다.

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

daro-key.txt는 DARO 대시보드에서 다운받을 수 있습니다.

daroAppKey는 DARO 대시보드에서 확인할 수 있습니다.

Daro SDK 의존성 추가

다음과 같이 필요 sdk 및 버전이 변경됩니다.

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
    ...
}

daro-core, daro-m 2가지 모두 implementation 해야합니다.

daro-compose-util모듈 의존성 추가를 통해 compose에서도 광고를 사용하실 수 있습니다.

코드 구현하기

SDK 초기화 변경

Daro 클래스의 패키지가 변경되었습니다.

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

DaroLogLevel 세팅 지원이 중단됩니다.

광고 Load에 사용하는 Ad Unit Id 변경

과거에 사용하던 Ad Unit Id가 새로운 SDK에서는 사용이 불가능합니다.
이에 따라 Daro 대시보드에서 변경된 Ad Unit Id를 받아서 코드에 적용해주세요

기존의 Ad Unit Id를 사용하면 광고 load에 실패하게 됩니다.. 반드시 Ad Unit Id를 교체해주세요.

광고 구현 로직 변경

Show 배너/MREC 광고

Xml 방식으로 뷰를 구현하는 방식 지원이 중단됩니다.
광고 load에 필요한 클래스들이 변경됩니다.
- room.daro.m.banner.DaroMBannerView -> droom.daro.view.DaroAdBannerAdView
- droom.daro.m.adunit.DaroMAdBannerUnit -> droom.daro.core.DaroBannerAdUnit
refreshSeconds 필드가 제거됩니다.
이제부터 다로 대시보드에서 remote로 새로고침 주기를 설정할 수 있습니다.
자세한 내용은 연동 문서를 참조해주세요

Show 네이티브 광고

Xml 방식으로 뷰를 구현하는 방식 지원이 중단됩니다.
광고 load에 필요한 클래스들이 변경됩니다.
- droom.daro.m.nativead.DaroMNativeView -> droom.daro.view.DaroNativeAdView
- droom.daro.m.adunit.DaroMAdNativeUnit -> droom.daro.core.DaroNativeAdUnit

AdBinder를 설정하는 방식이 변경됩니다.

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()

SDK 에서 기본적으로 제공하는 Template이 추가되었습니다.
refreshSeconds 필드가 제거됩니다.
이제부터 다로 대시보드에서 remote로 새로고침 주기를 설정할 수 있습니다.
자세한 내용은 연동 문서를 참조해주세요

Show 인터스티셜 광고

광고 load에 필요한 클래스들이 변경됩니다.
- droom.daro.m.interstitial.DaroMInterstitialAdLoader -> droom.daro.loader.DaroInterstitialAdLoader
- droom.daro.m.adunit.DaroMAdInterstitialUnit -> droom.daro.core.adunit.DaroInterstitialAdUnit

광고 호출 시 success, fail을 처리하는 방식이 lamda 대신 listener를 통해 처리하도록 변경됩니다.

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()

자세한 내용은 연동 문서를 참조해주세요

Show 리워드 비디오 광고

광고 load에 필요한 클래스들이 변경됩니다.
- droom.daro.m.reward.DaroMRewardedAdLoader -> droom.daro.loader.DaroRewardedAdLoader
- droom.daro.m.adunit.DaroMAdRewardedUnit -> droom.daro.core.adunit.DaroRewardedAdUnit

광고 호출 시 success, fail을 처리하는 방식이 lamda 대신 listener를 통해 처리하도록 변경됩니다.

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()

자세한 내용은 연동 문서를 참조해주세요

Show 라이트 팝업 광고

광고 load에 필요한 클래스들이 변경됩니다.
- droom.daro.m.lightpopup.DaroMLightPopupAdLoader -> `droom.daro.loader.DaroLightPopupAdLoader
- droom.daro.m.adunit.DaroMAdLightPopupUnit -> droom.daro.core.adunit.DaroLightPopupAdUnit

광고 호출 시 success, fail을 처리하는 방식이 lamda 대신 listener를 통해 처리하도록 변경됩니다.

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()

자세한 내용은 연동 문서를 참조해주세요

모든 광고에서 extraParameter, localExtraParameter를 설정하는 매서드 지원이 중단됩니다.

다로 시작하기

SDK 통합하기

DARO 사용하기

FAQ

Android SDK 마이그레이션 가이드

Non-Reward 앱

프로젝트 세팅

코드 구현하기

Reward 앱

프로젝트 세팅

코드 구현하기

다로 시작하기

SDK 통합하기

DARO 사용하기

FAQ

​Non-Reward 앱

​프로젝트 세팅

​코드 구현하기

​Reward 앱

​프로젝트 세팅

​코드 구현하기

Non-Reward 앱

프로젝트 세팅

코드 구현하기

Reward 앱

프로젝트 세팅

코드 구현하기