시작하기

광고 단위(Ad Unit)는 앱의 광고 지면과 포맷을 정의합니다. 업데이트된 대시보드에서 해당 광고 단위의 Ad Unit Key를 복사해 생성자의 adUnitKey에 넣으세요. 예제의 YOUR_AD_UNIT_KEY는 이 값을 넣는 자리입니다. 앱 단위의 Integration Key와는 다른 값입니다. 기존 Ad Unit ID(UUID)도 계속 입력할 수 있습니다.

시작하기 전에

프로젝트에 DARO SDK를 통합하기 전에 필요한 사항들을 확인하세요.

요구사항

안드로이드 minSdkVersion : 23

app-ads.txt 파일 설정(링크)이 잘 되었는지 다시 한 번 확인해주세요.

minSdk 26 미만일 경우 Desugaring 설정을 필요로 합니다.

android {
    ...

    compileOptions {
        isCoreLibraryDesugaringEnabled = true
        sourceCompatibility = JavaVersion.VERSION_1_8
        targetCompatibility = JavaVersion.VERSION_1_8
    }

    ...
}

...

dependencies {
    ...

    coreLibraryDesugaring("com.android.tools:desugar_jdk_libs:2.0.4")

    ...
}

android {
    ...

    compileOptions {
        coreLibraryDesugaringEnabled true
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }

    ...
}

...

dependencies {
    ...

    coreLibraryDesugaring 'com.android.tools:desugar_jdk_libs:2.0.4'

    ...
}

기존 버전에서 업그레이드하는 경우

먼저 Android 마이그레이션 가이드에 따라 대시보드를 업데이트하고 기존 키 파일과 앱 키 설정을 제거하세요. 그다음 아래 순서로 DARO 2.0.9 SDK를 연동하세요.

앱 설정하기

프로젝트 단위 빌드 설정

프로젝트 루트의 settings.gradle.kts(Kotlin DSL) 또는 settings.gradle(Groovy DSL)에 아래 저장소를 추가하세요.
이미 dependencyResolutionManagement 블록이 있다면 그 안의 repositories에 추가하세요.

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        maven { url = uri("https://artifact.bytedance.com/repository/pangle") }
        maven { url = uri("https://android-sdk.is.com/") }
        maven { url = uri("https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea") }
        maven { url = uri("https://repo.pubmatic.com/artifactory/public-repos") }
        maven { url = uri("https://maven.ogury.co") }
    }
}

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        maven { url 'https://artifact.bytedance.com/repository/pangle' }
        maven { url 'https://android-sdk.is.com/' }
        maven { url 'https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea' }
        maven { url 'https://repo.pubmatic.com/artifactory/public-repos' }
        maven { url 'https://maven.ogury.co' }
    }
}

build.gradle(root)에 daro 플러그인 추가

build.gradle(root) 파일에 daro 플러그인을 추가합니다.

DARO 플러그인은 daro-sdk와 별도로 버전을 지정합니다. 기존 연동에서 플러그인을 업데이트할 때도 루트 build.gradle의 classpath 버전을 변경하세요.

Latest version

daro-plugin : 2.0.5

buildscript {
    repositories {
        google()
        mavenCentral()
        maven { url = uri("https://artifacts.applovin.com/android") }
    }
    dependencies {
        classpath("so.daro:daro-plugin:2.0.5")
    }
}

buildscript {
    repositories {
        google()
        mavenCentral()
        maven { url 'https://artifacts.applovin.com/android' }
    }
    dependencies {
        classpath 'so.daro:daro-plugin:2.0.5'
    }
}

build.gradle(app)에 daro plugin 적용

build.gradle(app)에 daro plugin을 적용합니다.

plugins {
    ...
    id("so.daro")
    ...
}

plugins {
    ...
    id 'so.daro'
    ...
}

AndroidManifest.xml에 DARO_INTEGRATION_KEY 선언

앱 모듈의 src/main/AndroidManifest.xml에서 <application> 안에 Integration Key를 선언합니다.

<application
    ...>

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

    ...
</application>

Integration Key는 DARO 대시보드에서 앱 단위로 발급받을 수 있습니다.

이 예제는 모든 빌드 변형에서 같은 DARO 앱을 사용하는 설정입니다. flavor나 buildType에 따라 다른 앱을 쓴다면 빌드 변형마다 다른 Integration Key 사용하기를 참고하세요.

app-ads.txt 업데이트

app-ads.txt 설정 가이드에 따라 대시보드에서 제공하는 최신 내용을 반영하세요.

DARO SDK 추가

DARO SDK를 추가합니다.

Latest version

daro-sdk : 2.0.9

dependencies {
    ...
    implementation("so.daro:daro-sdk:2.0.9")
    ...
}

dependencies {
    ...
    implementation 'so.daro:daro-sdk:2.0.9'
    ...
}

daro-sdk는 droom.daro.compose 패키지의 DaroBanner, DaroNative 등 Compose 컴포넌트를 제공합니다.
처음 연동하는 경우 별도의 daro-compose-util 의존성 없이 바로 사용할 수 있습니다. 앱에는 Compose 런타임 1.7.0 이상이 필요합니다.
기존에 so.daro:daro-compose-util을 사용했다면 해당 의존성을 제거하고 daro-sdk에서 제공하는 Compose 컴포넌트를 사용하세요. 기존 import는 그대로 유지할 수 있습니다.

SDK 초기화하기

중요: SDK 초기화 후 광고 로드

광고를 로드하기 전에 Daro.init()를 호출하여 광고 SDK를 초기화합니다.
초기화 전 광고를 요청하면 광고가 정상적으로 표시되지 않을 수 있습니다.

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

class AppApplication : Application() {

  override fun onCreate() {
    super.onCreate()

    // Daro SDK 초기화
    Daro.init(
      application = this,
      sdkConfig = SDKConfig.Builder()
          .setDebugMode(false) // (디버그 모드, default : false — 운영 빌드에서는 반드시 false)
          .setAppMuted(false) // (앱 음소거 설정, default : false)
          .build()
    )
  }
}

setDebugMode(true)는 테스트 빌드에서만 사용하세요. 운영 빌드에서는 반드시 false로 설정하세요.

앱 음소거 설정

앱 오프닝, 배너, 인터스티셜 광고, 리워드 비디오 광고, 리워드 인터스티셜 광고, 네이티브 광고 포맷의 경우 setAppMuted(...) 메서드를 사용하여 앱 볼륨이 음소거되었음을 DARO SDK에 알릴 수 있습니다.

// 앱 음소거 설정
Daro.setAppMuted(true)


// 앱 음소거 해제
Daro.setAppMuted(false)

네이티브 광고는 로드 시점의 음소거 상태를 동영상 재생에 적용하므로, 네이티브 광고를 로드하기 전에 setAppMuted를 호출하세요.

앱 음소거 사용 시 주의사항앱 음소거 설정 시 음소거 상태에서 재생이 불가한 일부 동영상 광고 소재가 요청에서 제외될 수 있어, 광고 풀이 소폭 감소하고 수익에 영향을 줄 수 있습니다.

고급 설정

빌드 변형마다 다른 Integration Key 사용하기

daro-plugin 2.0.4 이상은 Integration Key를 빌드 변형마다 해석합니다. flavor나 buildType에 따라 다른 DARO 앱을 쓰는 경우 아래 두 방식 중 하나로 빌드 변형별 키를 선언하세요.

방식 A. 소스셋 매니페스트에 선언

src/<flavor>/AndroidManifest.xml 또는 src/<buildType>/AndroidManifest.xml의 <application> 안에 DARO_INTEGRATION_KEY를 선언합니다.
이 방식을 쓰면 src/main/AndroidManifest.xml의 DARO_INTEGRATION_KEY는 지우세요.

<manifest xmlns:android="http://schemas.android.com/apk/res/android">
    <application>
        <meta-data
            android:name="DARO_INTEGRATION_KEY"
            android:value="YOUR_DEV_INTEGRATION_KEY" />
    </application>
</manifest>

<manifest xmlns:android="http://schemas.android.com/apk/res/android">
    <application>
        <meta-data
            android:name="DARO_INTEGRATION_KEY"
            android:value="YOUR_PROD_INTEGRATION_KEY" />
    </application>
</manifest>

방식 B. manifestPlaceholders로 선언

매니페스트에는 ${daroIntegrationKey} 플레이스홀더만 둡니다.
값은 build.gradle(app)의 productFlavors 또는 buildTypes에서 지정합니다.

src/main/AndroidManifest.xml

<application
    ...>

    <meta-data
        android:name="DARO_INTEGRATION_KEY"
        android:value="${daroIntegrationKey}" />

    ...
</application>

android {
    flavorDimensions += "environment"
    productFlavors {
        create("dev") {
            dimension = "environment"
            manifestPlaceholders["daroIntegrationKey"] = "YOUR_DEV_INTEGRATION_KEY"
        }
        create("prod") {
            dimension = "environment"
            manifestPlaceholders["daroIntegrationKey"] = "YOUR_PROD_INTEGRATION_KEY"
        }
    }
}

android {
    flavorDimensions "environment"
    productFlavors {
        dev {
            dimension "environment"
            manifestPlaceholders["daroIntegrationKey"] = "YOUR_DEV_INTEGRATION_KEY"
        }
        prod {
            dimension "environment"
            manifestPlaceholders["daroIntegrationKey"] = "YOUR_PROD_INTEGRATION_KEY"
        }
    }
}

문제 해결

SafeDK 오류로 Release 빌드가 실패하는 경우

Configuration Cache 직렬화 오류가 발생하는 경우

Configuration Cache를 사용하는 Release 빌드가 캐시 저장 단계에서 실패하고, 오류 로그에 safedkAdjustInputs... 또는 safedkInstrumentation... 작업과 함께 다음과 같은 메시지가 표시되는 경우에 적용하세요.

cannot serialize object of type 'com.android.build.gradle.internal.tasks.R8Task'
cannot serialize object of type 'org.gradle.api.internal.project.DefaultProject'

이 오류가 발생하면 다음 순서로 SafeDK 작업의 Configuration Cache 사용을 우회할 수 있습니다.

루트 build.gradle의 classpath에 지정한 daro-plugin 버전을 2.0.3 이상으로 업데이트하세요. daro-sdk 버전은 변경하지 않아도 됩니다.
프로젝트 루트의 gradle.properties에 다음 설정을 추가하세요.
gradle.properties
daro.safedkConfigurationCacheWorkaround=true
실패했던 Release 빌드를 다시 실행해 결과를 확인하세요. 다른 작업의 오류가 남아 있다면 해당 오류도 별도로 확인해야 합니다.

이 설정은 SafeDK 기능과 작업을 유지하면서 해당 작업이 포함된 빌드의 Configuration Cache 저장·재사용을 막습니다. 다음 빌드에서 설정 단계가 다시 실행되어 설정 시간이 늘어날 수 있으며, Gradle의 빌드 출력 캐시와는 별개입니다.

오류가 발생하지 않는 프로젝트는 이 옵션을 켤 필요가 없습니다. 기본값은 비활성화이며, 공급사의 호환 수정본을 해당 앱 환경에서 검증한 뒤 옵션을 제거하거나 false로 되돌리세요.

옵션을 켠 뒤에도 Manifest 직렬화 오류가 발생하는 경우

daro-plugin 2.0.1에서 위 옵션을 켰는데도 process<Variant>Manifest 작업이 실패하고, 오류에 com.safedk.gradleplugin.configurators.ManifestConfigurator와 ReferenceQueue 직렬화 문제가 표시된다면 플러그인을 2.0.3 이상으로 업데이트하고 daro.safedkConfigurationCacheWorkaround=true 설정을 유지한 뒤 같은 Release 빌드를 다시 실행하세요. 2.0.2부터는 이 옵션이 SafeDK가 Manifest 작업에 추가한 처리에도 적용됩니다. 즉시 업데이트하기 어려운 경우에는 실패했던 Release 빌드 명령에 --no-configuration-cache를 추가해 다시 실행하세요. 예를 들어 앱 모듈 이름이 app이고 빌드 variant가 release라면 다음 명령을 사용합니다.

./gradlew :app:assembleRelease --no-configuration-cache

모듈이나 flavor가 다르면 기존 Release 작업 이름을 그대로 사용하세요. 이 옵션은 해당 실행의 Configuration Cache를 끄며, SafeDK 작업은 그대로 실행합니다. 빌드 출력 캐시는 별도로 유지됩니다. 같은 오류가 계속되면 실패한 작업 이름과 오류 로그를 DARO에 전달하세요.

`build_info.json` 파일을 찾을 수 없어 Release 빌드가 실패하는 경우

clean 후 빌드 출력 캐시(Build Cache)를 복원하는 Release 빌드에서 다음 오류가 발생한다면 플러그인을 업데이트하세요.

FileNotFoundException: .../safedk/properties/.../build_info.json (No such file or directory)

루트 build.gradle의 classpath에 지정한 daro-plugin 버전을 2.0.3 이상으로 업데이트하세요.
kotlin
classpath("so.daro:daro-plugin:2.0.5")
실패했던 Release 빌드를 다시 실행해 결과를 확인하세요.

이 오류에 대한 대응은 플러그인 업데이트로 자동 적용됩니다. 별도 옵션을 추가하거나 daro-sdk 버전을 변경할 필요는 없습니다. Configuration Cache 오류를 우회하기 위해 이미 daro.safedkConfigurationCacheWorkaround=true를 사용 중이라면 업데이트 후에도 유지하세요. 이 옵션만 추가하고 플러그인 버전을 그대로 두면 Build Cache 복원 오류는 해결되지 않습니다.

SDK에 포함된 난독화 규칙은 Gradle 빌드 시 자동으로 적용됩니다. 별도로 복사할 필요가 없습니다.

DARO 2.0 SDK 마이그레이션

다로 시작하기

SDK 통합하기

DARO 사용하기

FAQ

레거시 SDK

시작하기 전에

요구사항

기존 버전에서 업그레이드하는 경우

앱 설정하기

SDK 초기화하기

앱 음소거 설정

고급 설정

빌드 변형마다 다른 Integration Key 사용하기

방식 A. 소스셋 매니페스트에 선언

방식 B. manifestPlaceholders로 선언

문제 해결

SafeDK 오류로 Release 빌드가 실패하는 경우

Configuration Cache 직렬화 오류가 발생하는 경우

옵션을 켠 뒤에도 Manifest 직렬화 오류가 발생하는 경우

`build_info.json` 파일을 찾을 수 없어 Release 빌드가 실패하는 경우

​시작하기 전에

​요구사항

​기존 버전에서 업그레이드하는 경우

​앱 설정하기

​SDK 초기화하기

​앱 음소거 설정

​고급 설정

​빌드 변형마다 다른 Integration Key 사용하기

​방식 A. 소스셋 매니페스트에 선언

​방식 B. manifestPlaceholders로 선언

​문제 해결

​SafeDK 오류로 Release 빌드가 실패하는 경우

​Configuration Cache 직렬화 오류가 발생하는 경우

​옵션을 켠 뒤에도 Manifest 직렬화 오류가 발생하는 경우

​build_info.json 파일을 찾을 수 없어 Release 빌드가 실패하는 경우

시작하기 전에

요구사항

기존 버전에서 업그레이드하는 경우

앱 설정하기

SDK 초기화하기

앱 음소거 설정

고급 설정

빌드 변형마다 다른 Integration Key 사용하기

방식 A. 소스셋 매니페스트에 선언

방식 B. manifestPlaceholders로 선언

문제 해결

SafeDK 오류로 Release 빌드가 실패하는 경우

Configuration Cache 직렬화 오류가 발생하는 경우

옵션을 켠 뒤에도 Manifest 직렬화 오류가 발생하는 경우

`build_info.json` 파일을 찾을 수 없어 Release 빌드가 실패하는 경우