Android

1

사전 준비사항

가장 최신 버전의 Android Stuido 를 업데이트 또는 설치해주세요. Adrop은 다음의 환경에서 동작합니다.

1. API 레벨 23(M) 혹은 그 이상을 타겟팅

2. Android 6.0 혹은 그 이상 버전을 사용 minSdkVersion 23

3. 다음의 버전을 충족하는 Jetpack (AndroidX)을 사용 com.android.tools.build:gradle v7.6.3 버전 이상 compileSdkVersion 34

4. Kotlin 2.1.0 버전 이상

2

Adrop SDK를 추가하기

GitHub - OpenRhapsody/adrop-ads-example-androidGitHub

1. 앱 레벨의 모듈 Gradle 파일(대부분 <project>/build.gradle.kts 또는<project>/build.gradle)에 Adrop 라이브러리에 추가해주세요.

Kotlin (build.gradle.kts)

dependencies {
   implementation("io.adrop:adrop-ads:1.7.2")
}

Groovy (build.gradle)

1. Dependency를 걸고 나서, 안드로이드 '프로젝트'와 Gradles 파일의 싱크를 맞춰주세요.

3

Adrop 초기화(initialize)

앱 시작 시 SDK 를 초기화 하세요.

Kotlin

import io.adrop.ads.Adrop
// ..

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)
    
    // 1. Application Context를 사용하세요.
    // 2. production = true 를 사용하세요.
    // 3. 특정 국가에서 이 SDK를 사용하고 있다면, 
    //    ISO 3166 alpha-2 국가 코드 array를 전달하세요.
    Adrop.initialize(
        application, 
        production = true,
        targetCountries = arrayOf<String>())
    // 테마 설정하기
    Adrop.setTheme(AdropTheme.AUTO)

}

Java

초기화 파라미터

파라미터	타입	설명
context	Application	앱 Application 인스턴스
production	Boolean	프로덕션 여부
targetCountries	Array<String>	타겟 국가 코드 배열 (빈 배열: 전체 국가)

4

테마 설정 (선택사항)

광고 테마를 설정하려면 setTheme 을 호출하세요

Kotlin

Adrop.setTheme(AdropTheme.AUTO)

Java

테마	설명
AdropTheme.AUTO	시스템 설정에 따라 광고 소재 적용
AdropTheme.LIGHT	광고 소재 라이트 모드 적용
AdropTheme.DARK	광고 소재 다크 모드 적용

5

UID 설정 (선택사항)

앱에서 관리하는 uid를 설정하려면 setUID 을 호출 하세요

Kotlin

Adrop.setUID("YOUR_UID")

Java

---

Backfill Ads 사용

Backfill Ads 를 사용하려면 추가 설정이 필요합니다.

1

Repository 추가

setting.gradle.kts 또는 settings.gradle에 pangle repository를 추가하세요.

settings.gradle.kts

dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
        maven { url = uri("https://artifact.bytedance.com/repository/pangle") }
    }
}

settings.gradle

2

Dependency 추가

app/build.gradle 에 adrop-ads-backfill을 추가하세요.

build.gradle.kts

dependencies {
    implementation("io.adrop:adrop-ads-backfill:1.7.2")
}

build.gradle

3

Proguard 추가

proguard-rules.pro에 추가하세요

-keep class io.adrop.** { *; }
-dontwarn io.adrop.**

4

AndroidManifest.xml 추가

공유받은 AdMob application id로 교체해서 추가해주세요.

<application>
    ...

    <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="YOUR_ADMOB_APPLICATION_ID"/>
</application>