OfferwallUser

public class OfferwallUser

Kotlin

package com.nestads.sdk.offerwall.model

사용자 정보를 담는 클래스입니다. 로그인 시 사용됩니다.

---

Constructor

public constructor(userId: String, gender: Gender? = null, birthYear: Int? = null, customProperties: Map<String, Any> = emptyMap())

OfferwallUser 인스턴스를 생성합니다.

매개변수	설명
userId	사용자 고유 식별자 (필수)
gender	(Optional) 사용자 성별
birthYear	(Optional) 사용자 출생 연도
customProperties	(Optional) 커스텀 속성 맵

Example:

val user = OfferwallUser(
    userId = "user123",
    gender = OfferwallUser.Gender.MALE,
    birthYear = 1995,
    customProperties = mapOf("level" to 10, "vip" to true)
)

---

Nested Classes

public enum class Gender

사용자 성별을 나타내는 열거형 클래스입니다.

Enum Constants

상수	값	설명
MALE	"M"	남성
FEMALE	"F"	여성

Example:

val gender = OfferwallUser.Gender.MALE

---

public class Builder

OfferwallUser를 빌드하는 Builder 클래스입니다.

Constructor

public constructor(userId: String)

매개변수	설명
userId	사용자 고유 식별자

Methods

public fun setGender(gender: Gender): Builder

사용자 성별을 설정합니다.

매개변수	설명
gender	사용자 성별 (Gender.MALE 또는 Gender.FEMALE)

Returns: Builder 인스턴스 (메서드 체이닝)

Example:

builder.setGender(OfferwallUser.Gender.MALE)

---

public fun setBirthYear(year: Int): Builder

사용자 출생 연도를 설정합니다.

매개변수	설명
year	출생 연도 (예: 1995)

Returns: Builder 인스턴스 (메서드 체이닝)

Example:

builder.setBirthYear(1995)

---

public fun setCustomProperty(key: String, value: Any): Builder

사용자 커스텀 속성을 설정합니다. 여러 번 호출하여 여러 속성을 설정할 수 있습니다.

매개변수	설명
key	속성 키
value	속성 값 (Any 타입)

Returns: Builder 인스턴스 (메서드 체이닝)

Example:

builder
    .setCustomProperty("level", 10)
    .setCustomProperty("vip", true)
    .setCustomProperty("nickname", "Player1")

---

public fun build(): OfferwallUser

설정된 값으로 OfferwallUser 인스턴스를 생성합니다.

Returns: OfferwallUser 인스턴스

Example:

val user = OfferwallUser.Builder("user123")
    .setGender(OfferwallUser.Gender.MALE)
    .setBirthYear(1995)
    .setCustomProperty("level", 10)
    .build()

---

Usage Example

기본 생성 (userId만 사용)

val user = OfferwallUser(userId = "user123")
NestAdsOfferwall.login(user)

Constructor로 모든 정보 설정

val user = OfferwallUser(
    userId = "user123",
    gender = OfferwallUser.Gender.FEMALE,
    birthYear = 1998,
    customProperties = mapOf(
        "level" to 25,
        "vip" to true,
        "region" to "KR"
    )
)
NestAdsOfferwall.login(user)

Builder 패턴 사용

val user = OfferwallUser.Builder("user123")
    .setGender(OfferwallUser.Gender.MALE)
    .setBirthYear(1995)
    .setCustomProperty("level", 10)
    .setCustomProperty("vip", false)
    .setCustomProperty("points", 1500)
    .build()

NestAdsOfferwall.login(user)

로그인 리스너와 함께 사용

val user = OfferwallUser.Builder("user123")
    .setGender(OfferwallUser.Gender.MALE)
    .setBirthYear(1995)
    .build()

val loginListener = object : OfferwallLoginListener {
    override fun onSuccess() {
        Log.d("NestAds", "로그인 성공")
    }

    override fun onFailure(errorType: OfferwallLoginListener.ErrorType) {
        Log.e("NestAds", "로그인 실패: $errorType")
    }
}

NestAdsOfferwall.login(user, loginListener)

---