NestAdsOfferwallQuizDelegate

NestAdsOfferwallQuizDelegate 프로토콜을 통해 Quiz 이벤트를 처리하는 방법을 설명합니다.

@objc public protocol NestAdsOfferwallQuizDelegate: NSObjectProtocol

Quiz 이벤트를 수신하기 위한 프로토콜입니다.

---

Optional Methods

quizDidLoad(_:)

@objc optional func quizDidLoad(_ response: NestAdsOfferwallQuizResponse)

Quiz 데이터 로드에 성공했을 때 호출됩니다.

Parameters

파라미터	타입	설명
response	NestAdsOfferwallQuizResponse	Quiz 응답 데이터

Example

Swift

extension MyViewController: NestAdsOfferwallQuizDelegate {

    @objc func quizDidLoad(_ response: NestAdsOfferwallQuizResponse) {
        print("✅ Quiz 로드 성공")
        print("Quiz 개수: \(response.events.count)")

        // 사용 가능한 Quiz 목록 출력
        for event in response.events {
            print("ID: \(event.id), Title: \(event.title)")
        }
    }
}

---

quizDidLoadFail(_:)

@objc optional func quizDidLoadFail(_ error: NestAdsOfferwallError)

Quiz 데이터 로드에 실패했을 때 호출됩니다.

Parameters

파라미터	타입	설명
error	NestAdsOfferwallError	에러 정보

Example

Swift

extension MyViewController: NestAdsOfferwallQuizDelegate {

    @objc func quizDidLoadFail(_ error: NestAdsOfferwallError) {
        print("❌ Quiz 로드 실패")
        print("Error [\(error.code)]: \(error.message)")
    }
}

---

quizDidComplete(_:rewardAmount:)

@objc optional func quizDidComplete(_ quizEvent: NestAdsOfferwallQuizEvent, rewardAmount: Int)

Quiz를 완료하고 리워드를 획득했을 때 호출됩니다.

Parameters

파라미터	타입	설명
quizEvent	NestAdsOfferwallQuizEvent	완료된 Quiz 이벤트 정보
rewardAmount	Int	획득한 리워드 포인트

Example

Swift

extension MyViewController: NestAdsOfferwallQuizDelegate {

    @objc func quizDidComplete(_ quizEvent: NestAdsOfferwallQuizEvent, rewardAmount: Int) {
        print("✅ Quiz 완료!")
        print("Quiz ID: \(quizEvent.id)")
        print("Quiz Title: \(quizEvent.title)")
        print("리워드: \(rewardAmount) 포인트")

        // 리워드 지급 로직
        UserManager.shared.addPoints(rewardAmount)

        // 축하 메시지 표시
        showRewardAlert(amount: rewardAmount)
    }

    private func showRewardAlert(amount: Int) {
        let alert = UIAlertController(
            title: "🎉 축하합니다!",
            message: "\(amount) 포인트를 획득했습니다!",
            preferredStyle: .alert
        )
        alert.addAction(UIAlertAction(title: "확인", style: .default))
        present(alert, animated: true)
    }
}

---

NestAdsOfferwallQuizResponse

Quiz 로드 응답 모델입니다.

Properties

속성	타입	설명
success	Bool	응답 성공 여부
events	[NestAdsOfferwallQuizEvent]	Quiz 이벤트 목록
titleText	String?	완료 후 표시할 제목
completedImageUrl	String?	완료 이미지 URL
completedImageWidth	Int?	완료 이미지 너비
completedImageHeight	Int?	완료 이미지 높이
message	String?	응답 메시지

---

NestAdsOfferwallQuizEvent

Quiz 이벤트 정보를 포함하는 모델입니다.

Properties

속성	타입	설명
id	String	Quiz 고유 ID
title	String	Quiz 제목
eventDescription	String?	Quiz 설명

---

완전한 사용 예제

Swift

import NestAdsSDK
import NestAdsOfferwallSDK

class QuizViewController: UIViewController {

    private var quiz: NestAdsOfferwallQuiz?

    override func viewDidLoad() {
        super.viewDidLoad()

        // 1. Quiz 인스턴스 생성
        quiz = NestAds.Offerwall.quiz()

        // 2. Delegate 설정
        quiz?.setDelegate(self)

        // 3. Quiz 데이터 로드
        quiz?.load()
    }

    @IBAction func startQuizTapped(_ sender: UIButton) {
        guard let quiz = quiz else {
            print("Quiz 인스턴스가 없습니다")
            return
        }

        // Quiz 실행 (Quiz ID를 사용하여)
        quiz.clickQuiz("quiz_id_123", from: self)
    }
}

extension QuizViewController: NestAdsOfferwallQuizDelegate {

    @objc func quizDidLoad(_ response: NestAdsOfferwallQuizResponse) {
        print("✅ Quiz 로드 성공")
        print("Quiz 개수: \(response.events.count)")

        // Quiz 목록 표시
        for (index, event) in response.events.enumerated() {
            print("\(index + 1). \(event.title) (ID: \(event.id))")
        }
    }

    @objc func quizDidLoadFail(_ error: NestAdsOfferwallError) {
        print("❌ Quiz 로드 실패")
        print("Error: [\(error.code)] \(error.message)")

        // 에러 알림 표시
        let alert = UIAlertController(
            title: "오류",
            message: error.message,
            preferredStyle: .alert
        )
        alert.addAction(UIAlertAction(title: "확인", style: .default))
        present(alert, animated: true)
    }

    @objc func quizDidComplete(_ quizEvent: NestAdsOfferwallQuizEvent, rewardAmount: Int) {
        print("✅ Quiz 완료!")
        print("Quiz: \(quizEvent.title)")
        print("리워드: \(rewardAmount) 포인트")

        // 리워드 지급
        UserManager.shared.addPoints(rewardAmount)

        // 성공 메시지
        let alert = UIAlertController(
            title: "🎉 축하합니다!",
            message: "\(rewardAmount) 포인트를 획득했습니다!",
            preferredStyle: .alert
        )
        alert.addAction(UIAlertAction(title: "확인", style: .default))
        present(alert, animated: true)
    }
}

---

관련 문서

• NestAds.Offerwall - Offerwall API

• NestAdsOfferwallMissionDelegate - Mission 이벤트 Delegate

• Offerwall 광고 - Offerwall 통합 가이드