Android API

Android SDK의 주요 클래스와 메서드 레퍼런스입니다.

AdchainSdk

메인 SDK 클래스 (Singleton).

initialize()

SDK를 초기화합니다. 초기화는 백그라운드에서 비동기로 진행됩니다.

fun initialize(
    application: Application,
    sdkConfig: AdchainSdkConfig
)

파라미터:

이름	타입	필수	설명
application	Application	O	Application 인스턴스
sdkConfig	AdchainSdkConfig	O	SDK 설정

초기화 상태 확인:

if (AdchainSdk.isInitialized()) {
    // 초기화 완료
}

login()

사용자 로그인.

fun login(
    adchainSdkUser: AdchainSdkUser,
    listener: AdchainSdkLoginListener?
)

파라미터:

이름	타입	필수	설명
adchainSdkUser	AdchainSdkUser	O	사용자 정보
listener	AdchainSdkLoginListener?	X	로그인 콜백 (ErrorType enum 사용)

logout()

로그아웃.

fun logout()

openOfferwall()

전체 화면 오퍼월 열기.

fun openOfferwall(
    context: Context,
    placementId: String,
    callback: OfferwallCallback? = null,
    eventCallback: OfferwallEventCallback? = null
)

파라미터:

이름	타입	필수	설명
context	Context	O	Context (Activity 또는 Application)
placementId	String	O	배치 ID (통계 추적용)
callback	OfferwallCallback?	X	오퍼월 생명주기 콜백
eventCallback	OfferwallEventCallback?	X	커스텀 이벤트 콜백 (v1.0.24+)

openOfferwallWithUrl()

커스텀 URL로 오퍼월을 엽니다. 기본 오퍼월 URL이 아닌 특정 URL로 직접 오퍼월을 열어야 할 때 사용합니다.

fun openOfferwallWithUrl(
    url: String,
    context: Context,
    placementId: String,
    callback: OfferwallCallback? = null,
    eventCallback: OfferwallEventCallback? = null
)

파라미터:

이름	타입	필수	설명
url	String	O	오퍼월로 열 커스텀 URL
context	Context	O	Context (Activity 또는 Application)
placementId	String	O	배치 ID (통계 추적용)
callback	OfferwallCallback?	X	오퍼월 생명주기 콜백
eventCallback	OfferwallEventCallback?	X	커스텀 이벤트 콜백 (v1.0.24+)

사용 예시:

AdchainSdk.openOfferwallWithUrl(
    url = "https://custom-offerwall.example.com/page",
    context = this,
    placementId = "custom_page",
    callback = object : OfferwallCallback {
        override fun onOpened() { }
        override fun onClosed() { }
        override fun onError(message: String) { }
        override fun onRewardEarned(amount: Int) { }
        override fun onHeightChanged(height: Int) { }
    }
)

용도:

• 특정 캠페인 페이지로 직접 이동

• 테스트/스테이징 환경 URL 사용

• 외부 파트너 오퍼월 URL 직접 지정

참고: placementId는 URL에 추가되지 않고 이벤트 추적용으로만 사용됩니다.

trackEvent()

이벤트 추적.

fun trackEvent(
    eventName: String,
    payload: Map<String, Any> = emptyMap()
)

파라미터:

이름	타입	필수	설명
eventName	String	O	이벤트 이름
payload	Map<String, Any>	X	추가 데이터

기타 메서드

• isInitialized(): Boolean - 초기화 상태 확인

• isLoggedIn: Boolean - 로그인 상태 (프로퍼티)

• getCurrentUser(): AdchainSdkUser? - 현재 사용자 정보

• flushEvents() - 이벤트 즉시 전송

• openAdjoeOfferwall(...) - Adjoe 오퍼월

AdchainSdkConfig

SDK 설정 데이터 클래스.

data class AdchainSdkConfig(
    val appKey: String,
    val appSecret: String,
    val environment: Environment = Environment.PRODUCTION
)

필드:

이름	타입	필수	설명
appKey	String	O	앱 키
appSecret	String	O	앱 시크릿
environment	Environment	X	환경 (기본: PRODUCTION)

AdchainSdkUser

사용자 정보 데이터 클래스.

data class AdchainSdkUser(
    val userId: String,
    val gender: Gender = Gender.UNKNOWN,
    val birthYear: Int? = null
)

필드:

이름	타입	필수	설명
userId	String	O	사용자 ID
gender	Gender	X	성별 (기본: UNKNOWN)
birthYear	Int?	X	출생연도

Gender enum:

• Gender.MALE

• Gender.FEMALE

• Gender.OTHER

• Gender.UNKNOWN

AdchainOfferwallView

임베디드 오퍼월 View.

class AdchainOfferwallView(context: Context) : FrameLayout(context)

메서드:

• fun load(placementId: String) - 오퍼월 로드

• fun setListener(listener: AdchainOfferwallListener) - 리스너 설정

• fun destroy() - 뷰 정리

리스너 인터페이스

AdchainSdkLoginListener

interface AdchainSdkLoginListener {
    fun onSuccess()
    fun onFailure(errorType: ErrorType)

    enum class ErrorType {
        NOT_INITIALIZED,
        INVALID_USER_ID,
        NETWORK_ERROR,
        AUTHENTICATION_FAILED,
        UNKNOWN
    }
}

OfferwallCallback

interface OfferwallCallback {
    fun onOpened()
    fun onClosed()
    fun onError(message: String)
    fun onRewardEarned(amount: Int)
    fun onHeightChanged(height: Int)
}

OfferwallEventCallback

WebView와 Native 간 커스텀 이벤트 통신용 (v1.0.24+)

interface OfferwallEventCallback {
    fun onCustomEvent(eventType: String, payload: Map<String, Any?>)
    fun onDataRequest(requestId: String, requestType: String, params: Map<String, Any?>)
}

다음 단계

• iOS API

• React Native API