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 설명
imageUrl	String	썸네일 이미지 URL
point	String	보상 포인트 (예: "100P")
completed	Bool?	완료 여부
status	String?	이벤트 상태
landingUrl	String	랜딩 페이지 URL
impressionOrder	Int?	노출 순서
placementId	String?	플레이스먼트 ID

주의: point는 "100P" 형태의 문자열입니다. 숫자로 사용하려면 파싱이 필요합니다.

---

완전한 사용 예제

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 통합 가이드