NestAdsOfferwallMission

public class NestAdsOfferwallMission

Kotlin

package com.nestads.sdk.offerwall.mission

오퍼월 미션 기능을 제공하는 클래스입니다. 사용자가 특정 미션을 완료하고 보상을 받을 수 있는 기능을 구현할 수 있습니다.

---

Public Methods

public fun setEventsListener(listener: OfferwallMissionEventsListener): Unit

미션 관련 이벤트를 수신하기 위한 리스너를 설정합니다.

매개변수	설명
listener	미션 이벤트를 처리할 리스너

설명:

다음 이벤트가 발생했을 때 콜백을 받을 수 있습니다:

• 미션 완료 (onCompleted)

• 미션 진행 (onProgressed)

• 미션 새로고침 (onRefreshed)

Example:

mission.setEventsListener(object : OfferwallMissionEventsListener {
    override fun onCompleted(mission: Mission) {
        println("Mission completed: ${mission.title}")
    }

    override fun onProgressed(mission: Mission) {
        println("Mission progress: ${mission.progress}/${mission.total}")
    }

    override fun onRefreshed(unitId: String?) {
        println("Mission list refreshed")
    }
})

---

public fun getOfferwallMissionResponse(): OfferwallMissionResponse?

현재 미션 응답 데이터를 가져옵니다.

Returns: 미션 응답 데이터 또는 null

---

public fun getMissionList(onSuccess: (List<Mission>) -> Unit, onFailure: (OfferwallAdError) -> Unit): Unit

사용 가능한 미션 목록을 조회합니다.

매개변수	설명
onSuccess	미션 목록 조회 성공 시 호출되는 콜백
onFailure	미션 목록 조회 실패 시 호출되는 콜백

Example:

mission.getMissionList(
    onSuccess = { missions ->
        missions.forEach { mission ->
            println("Mission: ${mission.title}")
        }
    },
    onFailure = { error ->
        println("Error: ${error.message}")
    }
)

---

public fun getMissionStatus(onSuccess: (MissionStatus) -> Unit, onFailure: (OfferwallAdError) -> Unit): Unit

전체 미션의 진행 상태를 조회합니다.

매개변수	설명
onSuccess	미션 상태 조회 성공 시 호출되는 콜백
onFailure	미션 상태 조회 실패 시 호출되는 콜백

Example:

mission.getMissionStatus(
    onSuccess = { status ->
        println("Current: ${status.current}/${status.total}")
        println("Completed: ${status.isCompleted}")
        println("Can claim reward: ${status.canClaimReward}")
    },
    onFailure = { error ->
        println("Error: ${error.message}")
    }
)

---

public fun clickMission(missionId: String): Unit

특정 미션을 클릭했을 때 호출합니다.

매개변수	설명
missionId	클릭한 미션의 ID

설명:

• NestAds Offerwall이 사용 가능한 상태일 때만 동작합니다.

• 미션 클릭 이벤트를 트래킹합니다.

Example:

mission.clickMission("mission_123")

---

public fun clickGetReward(): Unit

보상 받기 버튼을 클릭했을 때 호출합니다.

설명:

• NestAds Offerwall이 사용 가능한 상태일 때만 동작합니다.

• 미션 완료 후 보상 받기 액션을 처리합니다.

Example:

mission.clickGetReward()

---

Companion Object Methods

@JvmStatic public fun refreshMissionList(unitId: String?): Unit

미션 목록을 새로고침합니다.

매개변수	설명
unitId	유닛 ID (nullable)

설명:

• 미션 목록을 서버로부터 다시 불러옵니다.

• NestAds Offerwall이 사용 가능한 상태일 때만 동작합니다.

Example:

NestAdsOfferwallMission.refreshMissionList("unit_123")

---

Data Models

Mission

개별 미션 정보를 나타내는 데이터 클래스입니다.

data class Mission(
    val id: String,
    val title: String,
    val description: String,
    val imageUrl: String,
    val landingUrl: String,
    val point: String,
    val status: String? = null,
    val progress: Int? = null,
    val total: Int? = null,
    val type: MissionType? = MissionType.NORMAL,
    val impressionOrder: Int? = null,
    val placementId: String? = null
)

속성	설명
id	미션 고유 ID
title	미션 제목
description	미션 설명
imageUrl	미션 이미지 URL
landingUrl	미션 랜딩 URL
point	미션 완료 시 획득 포인트
status	미션 상태
progress	현재 진행 상황
total	목표 달성 수
type	미션 타입 (NORMAL, OFFERWALL_PROMOTION)
impressionOrder	노출 순서
placementId	플레이스먼트 ID

---

MissionStatus

전체 미션의 진행 상태를 나타내는 데이터 클래스입니다.

data class MissionStatus(
    val current: Int,
    val total: Int,
    val isCompleted: Boolean = false,
    val canClaimReward: Boolean = false
)

속성	설명
current	현재 완료한 미션 수
total	전체 미션 수
isCompleted	모든 미션 완료 여부
canClaimReward	보상 수령 가능 여부

---

OfferwallMissionResponse

미션 API 응답 데이터를 나타내는 데이터 클래스입니다.

data class OfferwallMissionResponse(
    val success: Boolean? = null,
    val events: List<Mission> = emptyList(),
    val current: Int = 0,
    val total: Int = 0,
    val rewardUrl: String? = null,
    val message: String? = null,
    val titleText: String? = null,
    val descriptionText: String? = null,
    val bottomText: String? = null,
    val rewardIconUrl: String? = null,
    val bottomIconUrl: String? = null
)

속성	설명
success	API 호출 성공 여부
events	미션 목록
current	현재 완료한 미션 수
total	전체 미션 수
rewardUrl	보상 URL
message	응답 메시지
titleText	타이틀 텍스트
descriptionText	설명 텍스트
bottomText	하단 텍스트
rewardIconUrl	보상 아이콘 URL
bottomIconUrl	하단 아이콘 URL

---

MissionType

미션 타입을 나타내는 enum 클래스입니다.

enum class MissionType(val value: String) {
    NORMAL("normal"),
    OFFERWALL_PROMOTION("offerwall_promotion")
}

---

Usage Example

// 미션 인스턴스 생성
val mission = NestAdsOfferwallMission()

// 이벤트 리스너 설정
mission.setEventsListener(object : OfferwallMissionEventsListener {
    override fun onCompleted(mission: Mission) {
        println("Mission completed: ${mission.title}")
    }

    override fun onProgressed(mission: Mission) {
        println("Mission progress: ${mission.progress}/${mission.total}")
    }

    override fun onRefreshed(unitId: String?) {
        println("Mission list refreshed")
    }
})

// 미션 목록 조회
mission.getMissionList(
    onSuccess = { missions ->
        missions.forEach { m ->
            println("${m.title}: ${m.point} points")
        }
    },
    onFailure = { error ->
        println("Failed to load missions: ${error.message}")
    }
)

// 미션 클릭
mission.clickMission("mission_123")

// 보상 받기
mission.clickGetReward()

// 미션 목록 새로고침
NestAdsOfferwallMission.refreshMissionList(null)