NestAdsOfferwallDelegate

Offerwall 이벤트를 수신하기 위한 delegate protocol입니다.

public protocol NestAdsOfferwallDelegate : AnyObject

Offerwall의 상태 변화와 이벤트를 수신하기 위한 프로토콜입니다.

필수 구현 메서드:

• offerwallDidOpen() - Offerwall 열림

• offerwallDidClose() - Offerwall 닫힘

• offerwallDidFail(_:) - 오류 발생

• offerwallDidEarnReward(amount:) - 리워드 획득

선택 구현 메서드:

• offerwallDidReceiveCustomEvent(eventType:payload:) - 커스텀 이벤트

• offerwallDidRequestData(requestId:requestType:params:) - 데이터 요청

---

Public Methods

func offerwallDidOpen()

Offerwall이 화면에 표시되었을 때 호출됩니다.

Example

Swift

func offerwallDidOpen() {
    print("✅ Offerwall이 열렸습니다")
    // 분석 이벤트 전송 등
}

---

func offerwallDidClose()

Offerwall이 닫혔을 때 호출됩니다.

Example

Swift

func offerwallDidClose() {
    print("✅ Offerwall이 닫혔습니다")
    // UI 업데이트 등
}

---

func offerwallDidFail(_ error: NestAdsOfferwallError)

Offerwall에서 오류가 발생했을 때 호출됩니다.

매개변수	타입	설명
error	NestAdsOfferwallError	발생한 오류 정보

Example

Swift

func offerwallDidFail(_ error: NestAdsOfferwallError) {
    print("❌ Offerwall 오류: [\(error.code)] \(error.message)")

    // 오류 타입별 처리 예시
    switch error.code {
    case 1000:
        print("   SDK가 초기화되지 않았습니다")
    case 4001:
        print("   잘못된 User ID입니다")
    case 9999:
        print("   AdChain SDK 오류: \(error.message)")
    default:
        print("   기타 오류")
    }
}

---

func offerwallDidEarnReward(amount: Int)

사용자가 Offerwall에서 리워드를 획득했을 때 호출됩니다.

매개변수	타입	설명
amount	Int	획득한 리워드 포인트

이 메서드에서 사용자에게 리워드를 지급하는 로직을 구현해야 합니다.

Example

Swift

func offerwallDidEarnReward(amount: Int) {
    print("🎁 리워드 획득: \(amount) 포인트")

    // 여기에 리워드 지급 로직을 구현하세요
    // 예: 사용자 포인트 증가, UI 업데이트 등
}

---

func offerwallDidReceiveCustomEvent(eventType: String, payload: [String: Any])

Offerwall에서 커스텀 이벤트가 발생했을 때 호출됩니다. (선택사항)

매개변수	타입	설명
eventType	String	이벤트 타입
payload	[String: Any]	이벤트 데이터

이 메서드는 선택사항입니다. 필요한 경우에만 구현하세요.

Example

Swift

func offerwallDidReceiveCustomEvent(eventType: String, payload: [String: Any]) {
    print("📨 커스텀 이벤트: \(eventType)")
    print("   데이터: \(payload)")

    // 필요에 따라 이벤트 타입별 처리를 구현하세요
}

---

func offerwallDidRequestData(requestId: String, requestType: String, params: [String: Any]) -> [String: Any]?

Offerwall에서 데이터를 요청했을 때 호출됩니다. (선택사항)

매개변수	타입	설명
requestId	String	요청 ID
requestType	String	요청 타입
params	[String: Any]	요청 파라미터

Returns

타입	설명
[String: Any]?	요청에 대한 응답 데이터. nil을 반환하면 데이터 없음

이 메서드는 선택사항입니다. Offerwall WebView에서 특정 데이터를 요청할 때 호출됩니다. 구현하지 않으면 nil이 반환됩니다.

Example

Swift

func offerwallDidRequestData(
    requestId: String,
    requestType: String,
    params: [String: Any]
) -> [String: Any]? {
    print("📥 데이터 요청")
    print("   Request ID: \(requestId)")
    print("   Request Type: \(requestType)")
    print("   Params: \(params)")

    // 필요한 경우 데이터 반환
    // 요청 타입에 따라 적절한 데이터를 반환하세요
    return nil
}

---

전체 구현 예제

Swift

import NestAdsSDK
import NestAdsOfferwallSDK

extension MyViewController: NestAdsOfferwallDelegate {

    func offerwallDidOpen() {
        print("✅ Offerwall 열림")
    }

    func offerwallDidClose() {
        print("✅ Offerwall 닫힘")
    }

    func offerwallDidFail(_ error: NestAdsOfferwallError) {
        print("❌ 오류: [\(error.code)] \(error.message)")
        // 필요에 따라 사용자에게 오류 메시지 표시
    }

    func offerwallDidEarnReward(amount: Int) {
        print("🎁 리워드 획득: \(amount) 포인트")
        // 여기에 리워드 지급 로직 구현
    }

    // 선택사항: 커스텀 이벤트
    func offerwallDidReceiveCustomEvent(eventType: String, payload: [String: Any]) {
        print("📨 이벤트: \(eventType)")
    }

    // 선택사항: 데이터 요청
    func offerwallDidRequestData(
        requestId: String,
        requestType: String,
        params: [String: Any]
    ) -> [String: Any]? {
        print("📥 데이터 요청: \(requestType)")
        // 필요시 데이터 반환
        return nil
    }
}

---

관련 문서

• NestAdsOfferwallError - Offerwall 에러 모델

• NestAds.Offerwall - Offerwall API

• Offerwall 광고 - Offerwall 통합 가이드