안드로이드 SDK 설정

안드로이드는 SDK는 Private Maven 저장소에 등록되어 있습니다. 아래의 가이드를 통해 저장소 주소와 SDK 의존성을 설정해 주시기 바랍니다.

지원 OS 버전

AdiSON 오퍼월 SDK는 안드로이드 OS 버전 6.0(API 레벨 23) 이상에서 사용하실 수 있습니다.

Gradle 설정

Gradle 7.0 미만 (기존 방식)

• 프로젝트 단위 build.gradle 파일에 아래의 Repository를 추가합니다.

Kotlin

allprojects {
    repositories {
        // AdiSON 오퍼월 저장소    
        maven("https://repo.nbt.com/repository/adison-ads-android")
    }
}

Groovy

Gradle 7.0 이상 (권장 방식)

settings.gradle 파일 내 dependencyResolutionManagement 블록에 저장소를 추가합니다.

Kotlin

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        maven(url = "https://repo.nbt.com/repository/adison-ads-android")
    }
}

Groovy

SDK 라이브러리 추가

• 모듈 단위 build.gradle 에 아래 Dependency를 추가합니다.

Groovy

android {
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
}

dependencies {
    // AdiSON 오퍼월 SDK
    implementation ('co.adison:adison-offerwall-sdk:{SDK_VER}') {
        transitive = true  // 종속성 연동을 위한 값
    }
    
    implementation('com.google.android.gms:play-services-ads-identifier:17.0.0')
}

최신 버전은 Android SDK 릴리즈 정보 를 참고해주세요.

구글 광고 ID 획득 및 처리를 위하여 구글 플레이 서비스의 Ads 라이브러리를 반드시 추가하여야 합니다.

Gradle 스크립트 수정 후 Android Studio의 [File > Sync Project with Gradle File] 을 통해 SDK 설치를 완료합니다.

초기화

• Adison.initialize() 함수를 이용하여 Adison 초기화

initialize() 함수는 반드시 Main Application이 초기화 되는 시점에 같이 초기화 되도록 구성해 주시기 바랍니다.

Kotlin

Adison.initialize(this.applicationContext, PUB_APP_KEY)
Adison.setServer(Server.Development)  // 초기에는 개발환경으로 설정
Adison.debugEnable = true  // 디버그 로그 표시 

Java

서버 설정

Kotlin

Adison.setServer(Server.DEVELOPMENT) // 초기 개발 서버 설정

Value	Description
DEVELOPMENT	개발 서버
PRODUCTION	운영 서버

오퍼월 표시

Adison.showOfferwall() 함수를 호출하여 오퍼월을 표시합니다.

Kotlin

Adison.showOfferwall()

Java

로그인 연동

Kotlin

Adison.setUid("573E010013647A49B8F6B3E35E8B3C4")

UID 생성 설계 요건

UID는 사용자마다 고유(unique)하며 변하지 않는 값이어야 합니다.

유저가 탈퇴 후 재가입한 경우가 아니라면 같은 사용자는 앱 재설치, 기기 변경, 재로그인 이후에도 항상 동일한 UID를 가져야 합니다.

1. UID는 광고 중복 제거 등을 위해 사용자를 식별할 수 있는 난수값이어야 합니다.

2. UID는 총 80자 한도에서 설정해주시기 바랍니다.

3. UID 를 통해 유저 식별자를 전달받는 것은 개인정보를 전달받지 않기 위한 조치이므로 애디슨 측에 생성 로직을 설명해주시면 안됩니다.

4. UID는 매체사 앱에서 SDK에 전달해야 하며, 애디슨은 SDK를 통해 UID를 수집합니다.

5. 매체사 적립 서버는 UID를 기반으로 리워드 적립 처리를 할 수 있어야 합니다.

로그인 처리

아래 그림과 같이 오퍼월 표시 이전에 사용자 식별자를 입력해 주시기 바랍니다. 로그인 연동 후 오퍼월을 표시해 주세요.

오퍼월 표시 전 로그인 처리

로그인을 지연하여 처리하는 경우

사용자의 적극적인 참여를 유도하기 위해 오퍼월을 먼저 경험한 이후 사용자 식별자가 필수인 시점(광고 참여와 문의하기 이동) 전으로 로그인을 지연하여 처리가 가능합니다. listener를 등록하고 사용자 식별자 입력 전에 오퍼월을 표시하면 해당 시점에 requestLogin()을 콜백으로 호출하여 로그인을 요청합니다. 로그인 연동 이후 해당 화면을 종료하고 오퍼월 화면으로 재진입하면 내부에서 식별자 변경을 인지하여 사용자의 기존 액션을 이어서 진행합니다.

오퍼월 표시 후 로그인 처리

Kotlin

Adison.setOfferwallListener(object: AdisonOfferwallListener() {
    override fun requestLogin(context: Context?) {
        // 사용자 식별자를 setUid로 처리해 주세요.
    }
})

Java

로그인 연동 해제가 필요한 경우

사용자가 로그아웃을 하거나 서비스를 탈퇴하는 경우에는 애디슨 오퍼월에 사용 식별값 해제하여 연결 관계를 끊을 수 있습니다.

로그아웃, 탈퇴 등의 경우 SDK에서도 반드시 로그인 연동을 해제해 주셔야 합니다.

Kotlin

Adison.setUid(null)