안드로이드 SDK 설정

지원 OS 버전

AdiSON 오퍼월 SDK는 안드로이드 OS 버전 4.1(API 레벨 16, 코드네임 젤리빈) 이상에서 사용하실 수 있습니다.

Gradle 설정

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

Groovy
Kotlin
Groovy
allprojects {
repositories {
// AdiSON 오퍼월 저장소
maven {
url 'https://nbt.bintray.com/adison-offerwall'
}
}
}
Kotlin
allprojects {
repositories {
// AdiSON 오퍼월 저장소
maven("https://nbt.bintray.com/adison-offerwall")
}
}
  • 모듈 단위 .gradle 에 아래 Dependency 추가합니다. 최신 버전은 1.3.26 입니다.

Groovy
Groovy
dependencies {
// AdiSON 오퍼월 SDK
implementation ('co.adison:adison-offerwall-sdk:{version}@aar') {
transitive = true // 종속성 연동을 위한 값
}
}
  • 구글 광고 ID 처리를 위하여 구글 플레이 서비스의 Ads 라이브러리를 추가합니다.

implementation('com.google.android.gms:play-services-ads-identifier:17.0.0')

오퍼월 표시

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

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

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

로그인 요청 처리

  • Adison.setOfferwallListener() 함수를 사용하여 이벤트 수신자 설정

requestLogin()

  • 광고 목록과 상세는 uid가 설정되지 않아도 게스트 사용자로 표시가 가능합니다.

  • 이외에 광고 참여, 문의하기 등 uid가 명시적으로 필요하지만 설정되지 않은 경우 리스너의 requestLogin 콜백 메소드를 통해 로그인을 요청하고 있습니다.

Kotlin
Java
Kotlin
Adison.setOfferwallListener(object: AdisonOfferwallListener() {
override fun requestLogin(context: Context?) {
// 로그인 요청 처리
}
override fun onParticipateFailure(error: AdisonError?) {
// 삭제 예정
}
override fun onError(exception: Throwable?) {
// 삭제 예정
}
});
Java
Adison.setOfferwallListener(new AdisonOfferwallListener() {
@Override
public void requestLogin(@Nullable Context context) {
// 로그인 요청 처리
}
@Override
public void onParticipateFailure(@Nullable AdisonError error) {
// 삭제 예정, 처리하지 않음
}
@Override
public void onError(@Nullable Throwable exception) {
// 삭제 예정, 처리하지 않
}
});
  • Adison.showOfferwall() 함수를 호출하여 오퍼월 목록 표시

Kotlin
Java
Kotlin
Adison.showOfferwall()
Java
Adison.showOfferwall();

기타 사항

  • 초기화에 사용된 App ID가 Dev App ID일 경우 Adison.setServer() 함수를 이용해 대상 서버를 Development로 변경

  • 사용자가 로그인 한 경우 Adison.setUid() 함수를 사용하여 사용자 아이디 설정

  • Debug Log 출력이 필요한 경우 Adison.setDebugEnabled() 함수 사용