Android API

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

AdchainSdk

메인 SDK 클래스 (Singleton).

initialize()

SDK를 초기화합니다.

fun initialize(
    application: Application,
    config: AdchainSdkConfig,
    listener: AdchainSdkInitListener
)

파라미터:

이름	타입	필수	설명
application	Application	O	Application 인스턴스
config	AdchainSdkConfig	O	SDK 설정
listener	AdchainSdkInitListener	O	초기화 콜백

login()

사용자 로그인.

fun login(
    user: AdchainSdkUser,
    listener: AdchainSdkLoginListener
)

파라미터:

이름	타입	필수	설명
user	AdchainSdkUser	O	사용자 정보
listener	AdchainSdkLoginListener	O	로그인 콜백

logout()

로그아웃.

fun logout()

openOfferwall()

전체 화면 오퍼월 열기.

fun openOfferwall(
    activity: Activity,
    placementId: String = "",
    listener: AdchainOfferwallListener? = null
)

파라미터:

이름	타입	필수	설명
activity	Activity	O	현재 Activity
placementId	String	X	배치 ID
listener	AdchainOfferwallListener?	X	오퍼월 콜백

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() - 이벤트 즉시 전송

• openOfferwallWithUrl(...) - 커스텀 URL 오퍼월

• 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() - 뷰 정리

리스너 인터페이스

AdchainSdkInitListener

interface AdchainSdkInitListener {
    fun onSuccess()
    fun onFailure(error: AdchainError)
}

AdchainSdkLoginListener

interface AdchainSdkLoginListener {
    fun onSuccess()
    fun onFailure(error: AdchainError)
}

AdchainOfferwallListener

interface AdchainOfferwallListener {
    fun onOpen()
    fun onClose()
    fun onError(error: AdchainError)
}

AdchainError

에러 정보 클래스.

data class AdchainError(
    val code: Int,
    val message: String
)

주요 에러 코드:

코드	의미
1001	초기화 실패
1002	로그인 실패
2001	네트워크 에러
3001	오퍼월 로딩 실패

다음 단계

• iOS API

• React Native API