Android Admob 사용자를 위한 Adrop adapter 연결 가이드

사전 준비사항

가장 최신 버전의 Android Stuido 를 업데이트 또는 설치해주세요.

Adrop은 다음의 환경에서 동작합니다.

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

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

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

3. Kotlin 1.8.20 버전 이상

---

Adrop SDK 를 설치하기 전에, 앱에 연결할 플랫폼에 앱등록이 선행되어져야 해요.

*생성된 플랫폼이 없다면, 플랫폼 배포 가이드를 참고하여 플랫폼을 생성해 주세요. *애드컨트롤에 앱 서비스 등록이 안되어 있다면, 앱 등록 가이드 를 확인해주세요.

1. Adrop 설정 파일 추가하기

설정 파일 준비하기 가이드를 참고해 주세요.

2. 앱에 Adrop SDK를 추가하기

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

Kotlin (build.gradle.kts)

// AdMob SDK
implementation("com.google.android.gms:play-services-ads:23.1.0")
implementation("com.google.android.material:material:1.12.0")

// Adrop SDK
implementation("io.adrop:adrop-ads:[1.4.4,2.0)")

// Adrop AdMob Mediation Adapter
implementation("io.adrop:adrop-ads-admob-adapter:0.1.3")

Groovy (build.gradle)

1. Dependency 설정 후, 안드로이드 '프로젝트'와 Gradles 파일의 싱크를 맞춰주세요.

3. Adrop 초기화(initialize)하기

마지막으로, 초기화 코드를 앱에 추가해주세요.

1. Adrop을 Import해주세요.

2. 앱의 사용 언어에 맞게 Adrop instance를 초기화해주세요.

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

4.Activity에서 광고 로드

Kotlin

import com.google.android.gms.ads.AdSize
import com.google.android.gms.ads.AdView
import com.google.android.gms.ads.AdListener
import com.google.android.gms.ads.LoadAdError
import io.adrop.ads.mediation.admob.AdropAdRequest

val adView = AdView(context)
adView.setAdSize(AdSize.MEDIUM_RECTANGLE)
adView.adUnitId = "YOUR_ADMOB_UNIT_ID"

adView.adListener = object : AdListener() {
  override fun onAdLoaded() { }
  override fun onAdFailedToLoad(error: LoadAdError) { }
  override fun onAdClicked() { }
}

val request = AdropAdRequest.Builder()
  .setUnitId("YOUR_ADROP_UNIT_ID")
  .build()

adView.loadAd(request)
container.addView(adView)

5. 적용하기

앱 수익화 담당자 혹은 광고 담당자에게 다음 설정을 요청합니다.