Android 앱에 Adrop SDK 설치하기

GitHub - OpenRhapsody/adrop-ads-example-androidGitHub

사전 준비사항

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

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

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

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

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

4. Kotlin 1.8.20 버전 이상

---

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

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

1. Adrop 설정 파일 추가하기

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

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.2.0")
}

Groovy (build.gradle)

// build.gradle
dependencies {
   implementation "io.adrop:adrop-ads:1.2.0"
   classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:1.8.20" // 사용하시는 버전으로 바꾸셔도 됩니다
}

// app/build.gradle
apply plugin: "kotlin-android"

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

Java

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

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    
    // 1. Application Context를 사용하세요.
    // 2. production = truse 를 사용하세요.
    // 3. 특정 국가에서 이 SDK를 사용하고 있다면, 
    //    ISO 3166 alpha-2 국가 코드 array를 전달하세요.
    boolean production = true;
    String[] targetCountries = {};
    Adrop.INSTANCE.initialize(getApplication(), production, targetCountries);
}

Next Steps

1. 광고 유닛 등록하기

이제 광고 유닛을 등록하면 사용자에게 광고주의 직광고를 노출할 수 있어요.

광고 유닛 등록 방법을 알려드릴게요.

2. 광고 유닛 노출하기

이미 등록된 광고 유닛이 있다면 광고를 노출해 보세요.

광고 형식	아이콘	설명
배너 광고		서비스 화면 내에 특정 크기의 사각형 이미지로 표시되는 광고
전면 광고		사용자가 주요 화면을 전환할 때, 자연스럽게 전체 화면으로 표시되는 광고
보상형 광고		사용자에게 광고에 참여할 수 있는 기회를 제공하고 그 대가로 앱 내에서 보상을 지급하는 광고
네이티브 광고		노출되는 지면의 콘텐츠와 최대한 비슷한 방식으로 표시되는 광고
팝업		사용자가 앱을 켤 때, 앱 홈 화면 위에서 팝업 형태로 표시할 수 있는 광고 바ㅁㅣㅡㅓㅇ
스플래시 광고		사용자가 앱을 사용 중, 앱 화면이 나타나기 전후 전체 화면으로 표시되는 광고