NestAdsOfferwallQuiz

public class NestAdsOfferwallQuiz

Kotlin

package com.nestads.sdk.offerwall.quiz

오퍼월 퀴즈 기능을 제공하는 클래스입니다. 사용자가 퀴즈를 풀고 보상을 받을 수 있는 기능을 구현할 수 있습니다.

---

Public Methods

public fun setQuizEventsListener(listener: OfferwallQuizEventsListener): Unit

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

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

설명:

퀴즈 완료(onQuizCompleted) 이벤트가 발생했을 때 콜백을 받을 수 있습니다.

Example:

quiz.setQuizEventsListener(object : OfferwallQuizEventsListener {
    override fun onQuizCompleted(quizEvent: OfferwallQuizEvent, score: Int) {
        println("Quiz completed: ${quizEvent.title}")
        println("Score: $score")
    }
})

---

public fun getQuizList(onSuccess: (OfferwallQuizResponse) -> Unit, onFailure: (OfferwallAdError) -> Unit): Unit

사용 가능한 퀴즈 목록을 조회합니다.

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

Example:

quiz.getQuizList(
    onSuccess = { response ->
        println("Title: ${response.titleText}")
        response.events.forEach { quiz ->
            println("Quiz: ${quiz.title} - ${quiz.point} points")
        }
    },
    onFailure = { error ->
        println("Error: ${error.message}")
    }
)

---

public fun clickQuiz(quizId: String): Unit

특정 퀴즈를 클릭했을 때 호출합니다.

매개변수	설명
quizId	클릭한 퀴즈의 ID

설명:

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

• 퀴즈 클릭 이벤트를 트래킹하고 퀴즈를 시작합니다.

Example:

quiz.clickQuiz("quiz_123")

---

Data Models

OfferwallQuizEvent

개별 퀴즈 이벤트 정보를 나타내는 데이터 클래스입니다.

data class OfferwallQuizEvent(
    val id: String,
    val title: String,
    val description: String? = null,
    val imageUrl: String,
    val landingUrl: String,
    val point: String,
    val status: String? = null,
    val completed: Boolean? = null,
    val impressionOrder: Int? = null,
    val placementId: String? = null
)

속성	설명
id	퀴즈 고유 ID
title	퀴즈 제목
description	퀴즈 설명 (nullable)
imageUrl	퀴즈 이미지 URL
landingUrl	퀴즈 랜딩 URL
point	퀴즈 완료 시 획득 포인트
status	퀴즈 상태
completed	퀴즈 완료 여부
impressionOrder	노출 순서
placementId	플레이스먼트 ID

---

OfferwallQuizResponse

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

data class OfferwallQuizResponse(
    val success: Boolean? = null,
    val titleText: String? = null,
    val completedImageUrl: String? = null,
    val completedImageWidth: Int? = null,
    val completedImageHeight: Int? = null,
    val events: List<OfferwallQuizEvent> = emptyList(),
    val message: String? = null
)

속성	설명
success	API 호출 성공 여부
titleText	퀴즈 목록 타이틀 텍스트
completedImageUrl	완료 이미지 URL
completedImageWidth	완료 이미지 너비
completedImageHeight	완료 이미지 높이
events	퀴즈 이벤트 목록
message	응답 메시지

---

Usage Example

// 퀴즈 인스턴스 생성
val quiz = NestAdsOfferwallQuiz()

// 이벤트 리스너 설정
quiz.setQuizEventsListener(object : OfferwallQuizEventsListener {
    override fun onQuizCompleted(quizEvent: OfferwallQuizEvent, score: Int) {
        println("Quiz '${quizEvent.title}' completed!")
        println("Your score: $score")
        println("Points earned: ${quizEvent.point}")
    }
})

// 퀴즈 목록 조회
quiz.getQuizList(
    onSuccess = { response ->
        if (response.success == true) {
            println("Available quizzes: ${response.titleText}")

            response.events.forEach { quizEvent ->
                println("- ${quizEvent.title}")
                println("  Points: ${quizEvent.point}")
                println("  Completed: ${quizEvent.completed ?: false}")
            }
        }
    },
    onFailure = { error ->
        println("Failed to load quizzes: ${error.message}")
    }
)

// 퀴즈 클릭
quiz.clickQuiz("quiz_123")

---

Integration with Mission

퀴즈와 미션은 함께 사용될 수 있습니다:

val mission = NestAdsOfferwallMission()
val quiz = NestAdsOfferwallQuiz()

// 미션 리스너 설정
mission.setEventsListener(object : OfferwallMissionEventsListener {
    override fun onCompleted(mission: Mission) {
        println("Mission completed!")
    }

    override fun onProgressed(mission: Mission) {
        println("Mission progress updated")
    }

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

// 퀴즈 리스너 설정
quiz.setQuizEventsListener(object : OfferwallQuizEventsListener {
    override fun onQuizCompleted(quizEvent: OfferwallQuizEvent, score: Int) {
        println("Quiz completed with score: $score")
        // 퀴즈 완료 후 미션 상태 업데이트 확인
        mission.getMissionStatus(
            onSuccess = { status ->
                println("Mission status: ${status.current}/${status.total}")
            },
            onFailure = { }
        )
    }
})

// 퀴즈와 미션 목록 동시 조회
quiz.getQuizList(
    onSuccess = { quizResponse ->
        println("Quizzes loaded: ${quizResponse.events.size}")
    },
    onFailure = { }
)

mission.getMissionList(
    onSuccess = { missions ->
        println("Missions loaded: ${missions.size}")
    },
    onFailure = { }
)