마이그레이션 가이드

• 대시보드와 앱 설정을 먼저 전환한 뒤 SDK 의존성과 코드를 변경하세요.
• 전체 전환 순서는 DARO 2.0 SDK 마이그레이션 가이드, 지원 기간은 2.0.0 미만의 레거시 SDK 지원 안내에서 확인할 수 있습니다.

​

1. 대시보드 업데이트

• DARO 대시보드에서 전환할 앱을 확인하고 업데이트를 완료하세요.
• 해당 앱의 Integration Key와 Ad Unit Key를 확인하세요.

​

2. 기존 키 파일과 설정 제거

• 프로젝트의 daro-key.txt와 android-daro-key.txt를 삭제하세요.
• gradle.properties와 빌드 스크립트에서 기존 daroAppKey 설정을 제거하세요.
• 앱에서 직접 선언한 기존 DARO_APP_KEY 메타데이터와 수동 앱 키 설정을 제거하세요.

​

3. DARO 연동 도구 설정

• 시작하기의 앱 설정에 따라 저장소와 DARO 플러그인을 설정하세요.
• 앱 모듈의 기존 so.daro.a 또는 so.daro.m 플러그인 ID를 so.daro로 교체하고, 루트 build.gradle의 so.daro:daro-plugin classpath도 해당 문서에 적힌 버전으로 올리세요.

plugins {
    id("com.android.application")
    id("so.daro")
}

​

4. Integration Key 및 앱 설정

• 앱 모듈의 src/main/AndroidManifest.xml에서 <application> 안에 대시보드에서 복사한 Integration Key를 입력하세요.

<meta-data
    android:name="DARO_INTEGRATION_KEY"
    android:value="YOUR_INTEGRATION_KEY" />

• DARO_INTEGRATION_KEY를 매니페스트에 설정할 때는 ${...} 형태의 placeholder 대신 실제 키 값을 입력하세요.

​

5. app-ads.txt 업데이트

• app-ads.txt 설정 가이드에 따라 대시보드에서 제공하는 최신 내용을 게시하세요.
• 대시보드에 등록한 웹사이트에서 파일에 접근할 수 있는지 확인하세요.

​

6. SDK 의존성과 코드 변경

• 시작하기에 안내된 so.daro:daro-sdk 의존성을 추가하세요.
• 기존 so.daro:daro-a(Non-Reward) 또는 so.daro:daro-m(Reward) 의존성을 제거하세요. 두 아티팩트는 DARO 2.0.1 SDK에서 so.daro:daro-sdk 하나로 통합되었습니다.
• 2.0.0 미만의 레거시 SDK와 DARO 2.0.1 SDK를 함께 추가하지 마세요.

​

초기화와 import

• 초기화에 사용하는 import를 droom.daro.sdk.Daro로 변경하세요.
• 초기화 설정은 droom.daro.SDKConfig를 사용합니다.

import android.app.Application
import droom.daro.SDKConfig
import droom.daro.sdk.Daro

class AppApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        Daro.init(
            application = this,
            sdkConfig = SDKConfig.Builder()
                .setDebugMode(false)
                .setAppMuted(false)
                .build()
        )
    }
}

• 광고를 요청하기 전에 SDK를 초기화하세요.
• 아동 대상 설정을 사용하는 앱은 개인정보 보호 설정에 따라 setCoppa를 초기화 전에 호출하세요.

​

광고 포맷별 확인

• 애드유닛 생성자의 placement 인자를 제거하세요.
• 대시보드에서 복사한 Ad Unit Key를 key에 지정합니다.
• 아래 포맷 가이드에서 로드·표시·종료 처리를 함께 확인하세요.

• so.daro:daro-compose-util을 사용했다면 해당 의존성을 제거하세요. Compose 기능은 daro-sdk에 통합되어 있습니다.
• droom.daro.compose.DaroBanner와 droom.daro.compose.DaroNative 등 기존 import는 그대로 유지할 수 있습니다.
• Compose를 사용하는 앱은 Compose 런타임 1.7.0 이상을 사용하세요.
• 로드 실패 처리는 onAdLoadFail(error: DaroError)와 error.errorMessage를 사용하세요.
• 자세한 내용은 에러 처리를 참고하세요.

​

배포 전 확인

• 업데이트한 앱에서 초기화와 사용 중인 모든 광고 포맷의 로드·표시·종료를 확인하세요.
• 리워드 비디오 광고의 보상 콜백과 서버 콜백을 사용한다면 함께 확인하세요.
• 2.0.0 미만의 레거시 SDK를 사용하는 배포 버전에는 기존 Ad Unit ID를 유지하세요.