NestAdsOfferwallMissionDelegate

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

@objc public protocol NestAdsOfferwallMissionDelegate: NSObjectProtocol

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

---

Optional Methods

missionDidLoad(_:progress:)

@objc optional func missionDidLoad(
    _ response: NestAdsOfferwallMissionResponse,
    progress: NestAdsOfferwallMissionProgress
)

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

Parameters

파라미터	타입	설명
response	NestAdsOfferwallMissionResponse	Mission 응답 데이터
progress	NestAdsOfferwallMissionProgress	Mission 진행 상황

Example

Swift

extension MyViewController: NestAdsOfferwallMissionDelegate {

    func missionDidLoad(
        _ response: NestAdsOfferwallMissionResponse,
        progress: NestAdsOfferwallMissionProgress
    ) {
        print("✅ Mission 로드 성공")
        print("Mission 개수: \(response.missions.count)")
        print("진행도: \(progress.current) / \(progress.total)")
        print("완료율: \(String(format: "%.1f", progress.percentage))%")

        // Mission 목록 표시
        for mission in response.missions {
            print("ID: \(mission.id), Title: \(mission.title), Point: \(mission.point)")
        }
    }
}

---

missionDidLoadFail(_:)

@objc optional func missionDidLoadFail(_ error: NestAdsOfferwallError)

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

Parameters

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

Example

Swift

extension MyViewController: NestAdsOfferwallMissionDelegate {

    func missionDidLoadFail(_ error: NestAdsOfferwallError) {
        print("❌ Mission 로드 실패")
        print("Error [\(error.code)]: \(error.message)")
    }
}

---

missionDidComplete(_:)

@objc optional func missionDidComplete(_ mission: NestAdsOfferwallMissionModel)

Mission을 완료했을 때 호출됩니다.

Parameters

파라미터	타입	설명
mission	NestAdsOfferwallMissionModel	완료된 Mission 정보

Example

Swift

extension MyViewController: NestAdsOfferwallMissionDelegate {

    func missionDidComplete(_ mission: NestAdsOfferwallMissionModel) {
        print("✅ Mission 완료!")
        print("Mission: \(mission.title)")
        print("리워드: \(mission.point) 포인트")

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

        // 축하 메시지 표시
        showCompletionAlert(mission: mission)
    }

    private func showCompletionAlert(mission: NestAdsOfferwallMissionModel) {
        let alert = UIAlertController(
            title: "🎉 완료되었습니다!",
            message: "'\(mission.title)' 미션을 완료하여 \(mission.point) 포인트를 획득했습니다!",
            preferredStyle: .alert
        )
        alert.addAction(UIAlertAction(title: "확인", style: .default))
        present(alert, animated: true)
    }
}

---

missionDidProgress(_:)

@objc optional func missionDidProgress(_ mission: NestAdsOfferwallMissionModel)

Mission이 진행되었을 때 호출됩니다. (예: 진행도 업데이트)

Parameters

파라미터	타입	설명
mission	NestAdsOfferwallMissionModel	진행 중인 Mission 정보

Example

Swift

extension MyViewController: NestAdsOfferwallMissionDelegate {

    func missionDidProgress(_ mission: NestAdsOfferwallMissionModel) {
        print("⏳ Mission 진행 중")
        print("Mission: \(mission.title)")
        if let progress = mission.progress, let total = mission.total {
            print("진행도: \(progress) / \(total)")
        }
    }
}

---

missionListDidRefresh(unitId:)

@objc optional func missionListDidRefresh(unitId: String?)

Mission 리스트가 새로고침되었을 때 호출됩니다.

Parameters

파라미터	타입	설명
unitId	String?	새로고침된 유닛 ID

Example

Swift

extension MyViewController: NestAdsOfferwallMissionDelegate {

    func missionListDidRefresh(unitId: String?) {
        print("🔄 Mission 리스트 새로고침됨")
        if let unitId = unitId {
            print("Unit ID: \(unitId)")
        }

        // UI 업데이트 (예: Mission 목록 다시 로드)
        reloadMissionList()
    }

    private func reloadMissionList() {
        mission?.load()
    }
}

---

NestAdsOfferwallMissionResponse

Mission 로드 응답 모델입니다.

Properties

속성	타입	설명
success	Bool	응답 성공 여부
missions	[NestAdsOfferwallMissionModel]	Mission 목록
current	Int	현재 진행도
total	Int	총 Mission 개수
rewardUrl	String?	리워드 URL
titleText	String?	제목 텍스트
descriptionText	String?	설명 텍스트
bottomText	String?	하단 텍스트
rewardIconUrl	String?	리워드 아이콘 URL
bottomIconUrl	String?	하단 아이콘 URL

---

NestAdsOfferwallMissionProgress

Mission 진행 상황을 나타내는 모델입니다.

Properties

속성	타입	설명
current	Int	현재 진행도
total	Int	총 진행도
percentage	Float	진행률 (%)
isCompleted	Bool	완료 여부

---

NestAdsOfferwallMissionModel

Mission 상세 정보를 포함하는 모델입니다.

Properties

속성	타입	설명
id	String	Mission 고유 ID
title	String	Mission 제목
missionDescription	String	Mission 설명
point	Int	보상 포인트
status	String?	Mission 상태
progress	Int?	현재 진행도
total	Int?	총 진행도
type	NestAdsOfferwallMissionType	Mission 타입
imageUrl	String	이미지 URL
landingUrl	String	랜딩 URL
impressionOrder	Int?	노출 순서
placementId	String?	게재위치 ID

---

완전한 사용 예제

Swift

import NestAdsSDK
import NestAdsOfferwallSDK

class MissionViewController: UIViewController {

    private var mission: NestAdsOfferwallMission?
    private var missionResponse: NestAdsOfferwallMissionResponse?

    override func viewDidLoad() {
        super.viewDidLoad()

        // 1. Mission 인스턴스 생성
        mission = NestAds.Offerwall.mission()

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

        // 3. Mission 데이터 로드
        mission?.load()
    }

    @IBAction func startMissionTapped(_ sender: UIButton) {
        guard let mission = mission,
              let response = missionResponse,
              !response.missions.isEmpty else {
            print("Mission 데이터가 없습니다")
            return
        }

        // 첫 번째 Mission 실행
        let missionId = response.missions[0].id
        mission.clickMission(missionId, from: self)
    }

    @IBAction func refreshMissionListTapped(_ sender: UIButton) {
        mission?.refreshMissionList(unitId: "test_unit")
    }

    @IBAction func triggerRewardTapped(_ sender: UIButton) {
        mission?.triggerRewardButtonClick(from: self)
    }

    deinit {
        // 리소스 정리
        mission?.destroy()
    }
}

extension MissionViewController: NestAdsOfferwallMissionDelegate {

    func missionDidLoad(
        _ response: NestAdsOfferwallMissionResponse,
        progress: NestAdsOfferwallMissionProgress
    ) {
        print("✅ Mission 로드 성공")
        self.missionResponse = response

        print("Mission 개수: \(response.missions.count)")
        print("진행도: \(progress.current) / \(progress.total)")
        print("완료율: \(String(format: "%.1f", progress.percentage))%")

        // Mission 목록 표시
        for (index, mission) in response.missions.enumerated() {
            print("\(index + 1). \(mission.title) (\(mission.point)P)")
        }
    }

    func missionDidLoadFail(_ error: NestAdsOfferwallError) {
        print("❌ Mission 로드 실패")
        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)
    }

    func missionDidComplete(_ mission: NestAdsOfferwallMissionModel) {
        print("✅ Mission 완료!")
        print("Mission: \(mission.title)")
        print("리워드: \(mission.point) 포인트")

        UserManager.shared.addPoints(mission.point)

        let alert = UIAlertController(
            title: "🎉 완료되었습니다!",
            message: "'\(mission.title)' 미션을 완료하여 \(mission.point) 포인트를 획득했습니다!",
            preferredStyle: .alert
        )
        alert.addAction(UIAlertAction(title: "확인", style: .default))
        present(alert, animated: true)
    }

    func missionDidProgress(_ mission: NestAdsOfferwallMissionModel) {
        print("⏳ Mission 진행 중: \(mission.title)")
        if let progress = mission.progress, let total = mission.total {
            print("진행도: \(progress) / \(total)")
        }
    }

    func missionListDidRefresh(unitId: String?) {
        print("🔄 Mission 리스트 새로고침됨")
        if let unitId = unitId {
            print("Unit ID: \(unitId)")
        }
    }
}

---

관련 문서

• NestAds.Offerwall - Offerwall API

• NestAdsOfferwallQuizDelegate - Quiz 이벤트 Delegate

• Offerwall 광고 - Offerwall 통합 가이드