시작하기

애드유닛은 앱에서 광고를 표시할 지면과 광고 포맷을 설정한 단위입니다. DARO 2.0.1 SDK에는 업데이트된 대시보드의 Ad Unit Key를 복사해 입력하세요. 앱 설정에 쓰는 Integration Key와는 다른 값입니다. API 인자 adUnitId, unitId, key와 예제의 YOUR_AD_UNIT_ID는 이름을 그대로 사용하지만, 입력할 값은 해당 애드유닛의 Ad Unit Key입니다. 기존 애드유닛 ID를 사용한 연동도 계속 지원합니다. 리포트·콜백의 식별자를 새 연동용 키와 혼동하지 마세요.

시작하기 전에

프로젝트에 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.1 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 플러그인을 추가합니다.

Latest version

daro-plugin : 2.0.0

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

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

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 대시보드에서 앱 단위로 발급받을 수 있습니다.

이 예제는 모든 빌드 변형에서 같은 앱을 사용하는 설정입니다. 앱 모듈의 src/main/AndroidManifest.xml에 해당 앱의 Integration Key를 실제 값으로 입력하세요. DARO_INTEGRATION_KEY를 매니페스트에 설정할 때는 ${...} 형태의 placeholder 대신 실제 키 값을 입력하세요.

app-ads.txt 업데이트

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

DARO SDK 추가

DARO SDK를 추가합니다.

Latest version

daro-sdk : 2.0.1

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

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

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에 포함된 난독화 규칙은 Gradle 빌드 시 자동으로 적용됩니다. 별도로 복사할 필요가 없습니다.

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를 호출하세요.

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

DARO 2.0 SDK 마이그레이션

다로 시작하기

SDK 통합하기

DARO 사용하기

FAQ

레거시 SDK

시작하기 전에

요구사항

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

앱 설정하기

SDK 초기화하기

앱 음소거 설정

​시작하기 전에

​요구사항

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

​앱 설정하기

​SDK 초기화하기

​앱 음소거 설정

시작하기 전에

요구사항

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

앱 설정하기

SDK 초기화하기

앱 음소거 설정