Adrop에 안드로이드 앱 등록하기

사전 준비사항

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

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

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

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

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

4. Kotlin 1.8.20 버전 이상

이메일 또는 구글 계정을 통해 Adrop에 로그인하세요.

---

콘솔에서 Adrop 추가하기

앱에 Adrop을 추가하려면, Adrop 콘솔과 공개 안드로이드 프로젝트 모두의 작업이 진행되어야 합니다.

• 예) Adrop 설정 파일을 콘솔에서 다운로드 받으면, 안드로이드 프로젝트에도 같은 파일을 옮겨주세요.

1. Adrop 프로젝트 생성

먼저 Android 앱에 연결할 Adrop 프로젝트를 만들어주세요.

2. Adrop에 앱 등록하기

안드로이드를 위한 Adrop 콘솔을 사용하기 위해 '프로젝트'에 앱 등록이 먼저 필요합니다.

앱에서 실제로 사용하는 앱 패키지 명을 정확히 입력했는지 한 번 더 확인해주세요. 앱 패키지 명은 대소문자를 구분하며 한번 등록된 후에는 Adrop 안드로이드 앱에 대해 변경할 수 없습니다.

1. Adrop 콘솔로 이동해주세요.

2. 프로젝트 페이지 상단 중앙에 Android 아이콘을 클릭해서 설치를 시작해주세요.

3. Android package name 입력란에 앱 패키지 명을 입력해주세요.

   • 앱 패키지 명은 사용자의 디바이스 및 Google Play Store에서 앱을 고유하게 식별하는 이름입니다. 종종 애플리케이션 ID라고도 합니다.

   • 모듈(앱 수준) Gradle 파일에서 앱의 패키지 명을 찾습니다.

     • app/build.gradle 활용 예시 : com.yourcompany.yourproject

4. 앱 닉네임을 입력해주세요.

   • 앱 닉네임 : Adrop 콘솔에서 본인에게만 표시되는 내부 편의를 위한 식별자입니다.

5. '앱 등록'을 클릭하세요.

3. Adrop 설정 파일 추가하기

1. 먼저 adrop_service.json을 다운로드 받고, Adrop 안드로이드 플랫폼 설정 파일을 받아주세요.

2. 받은 설정 파일을 assets 디렉토리 아래에 추가해주세요.

   • android/app/src/main/assets/adrop_service.json

     

4. 앱에 Adrop SDK를 추가하기

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

Kotlin (build.gradle.kts)

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

Groovy (build.gradle)

dependencies {
   implementation "io.adrop:adrop-ads:0.5.4"
}

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

5. 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);
}

다음 단계

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

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