안드로이드 SDK 설정

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

지원 OS 버전

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

Gradle 설정

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

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

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

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

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

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

초기화

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

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

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

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

오퍼월 표시

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

Adison.showOfferwall()

Adison.showOfferwall();

로그인 연동

Adison.setUid("573E010013647A49B8F6B3E35E8B3C4")

• uid는 추후 적립 처리가 가능하도록 별도로 암호화 한 사용 식별값을 설정해주시기 바랍니다.

• 개인정보(이메일, 이름, 전화번호, 식별가능한 사용자 ID 등)을 사용하면 안됩니다.

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

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

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

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

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

 Adison.setOfferwallListener(new AdisonOfferwallListener() {
    @Override
    public void requestLogin(@Nullable Context context) {
        // 사용자 식별자를 setUid로 처리해 주세요.
    }
});

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

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

Adison.setUid(null)