NestAdsOfferwallError

Offerwall에서 발생하는 에러 정보를 담는 모델입니다.

public class NestAdsOfferwallError

Offerwall SDK에서 발생하는 에러 정보를 담는 클래스입니다.

---

Public Properties

public let code: Int

에러 코드

에러의 종류를 구분하는 정수 값입니다.

---

public let message: String

에러 메시지

에러에 대한 설명 메시지입니다.

---

에러 코드

NestAdsOfferwallSDK 에러

Code	설명	대응 방법
1000	SDK가 초기화되지 않음	AppDelegate에서 OfferwallConfig로 초기화했는지 확인
4001	잘못된 User ID	빈 문자열이 아닌 유효한 userId를 전달했는지 확인
9999	AdChain SDK 에러	error.message로 상세 메시지 확인

에러 코드 9999는 AdChain SDK에서 발생한 모든 에러를 포함합니다. 자세한 내용은 error.message를 확인하세요.

---

사용 예제

기본 에러 처리

Swift

extension MyViewController: NestAdsOfferwallDelegate {

    func offerwallDidFail(_ error: NestAdsOfferwallError) {
        print("❌ Offerwall 오류")
        print("   코드: \(error.code)")
        print("   메시지: \(error.message)")
    }
}

---

에러 코드별 처리

Swift

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

    // 에러 코드별 처리
    switch error.code {
    case 1000:
        // SDK 초기화 오류
        showAlert(
            title: "초기화 오류",
            message: "SDK가 초기화되지 않았습니다. 앱을 다시 시작해주세요."
        )

    case 4001:
        // 잘못된 User ID
        showAlert(
            title: "입력 오류",
            message: "유효한 사용자 ID를 입력해주세요."
        )

    case 9999:
        // AdChain SDK 에러 (상세 메시지 확인 필요)
        print("⚠️ AdChain SDK 오류: \(error.message)")
        showAlert(
            title: "오류",
            message: error.message
        )

    default:
        // 기타 오류
        showAlert(
            title: "오류",
            message: error.message
        )
    }
}

private func showAlert(title: String, message: String) {
    let alert = UIAlertController(
        title: title,
        message: message,
        preferredStyle: .alert
    )
    alert.addAction(UIAlertAction(title: "확인", style: .default))
    present(alert, animated: true)
}

---

에러 로깅

Swift

func offerwallDidFail(_ error: NestAdsOfferwallError) {
    // 에러 로깅
    let errorInfo: [String: Any] = [
        "error_code": error.code,
        "error_message": error.message,
        "timestamp": Date(),
        "user_id": NestAds.Offerwall.currentUserId
    ]

    // 분석 도구로 전송
    Analytics.logEvent("offerwall_error", parameters: errorInfo)

    // 로그 출력
    print("📊 Offerwall Error: \(errorInfo)")

    // 사용자에게 메시지 표시
    showErrorMessage(error)
}

---

재시도 로직

Swift

class OfferwallManager {

    private var retryCount = 0
    private let maxRetries = 3

    func showOfferwall(
        from viewController: UIViewController,
        placementCode: String
    ) {
        retryCount = 0
        openOfferwall(from: viewController, placementCode: placementCode)
    }

    private func openOfferwall(
        from viewController: UIViewController,
        placementCode: String
    ) {
        NestAds.Offerwall.openOfferwall(
            from: viewController,
            placementCode: placementCode,
            delegate: self
        )
    }

    private func handleRetry(
        from viewController: UIViewController,
        placementCode: String,
        error: NestAdsOfferwallError
    ) {
        // AdChain SDK 에러(9999)이면서 네트워크 관련 메시지일 경우 재시도
        let isNetworkError = error.code == 9999 &&
            (error.message.contains("network") ||
             error.message.contains("connection") ||
             error.message.contains("timeout"))

        guard isNetworkError else {
            showErrorAlert(error)
            return
        }

        // 재시도 횟수 확인
        guard retryCount < maxRetries else {
            showAlert(
                title: "오류",
                message: "네트워크 연결에 실패했습니다. 나중에 다시 시도해주세요."
            )
            return
        }

        retryCount += 1
        print("⏳ Offerwall 재시도 중... (\(retryCount)/\(maxRetries))")

        // 잠시 후 재시도
        DispatchQueue.main.asyncAfter(deadline: .now() + 2.0) {
            self.openOfferwall(from: viewController, placementCode: placementCode)
        }
    }
}

extension OfferwallManager: NestAdsOfferwallDelegate {

    func offerwallDidFail(_ error: NestAdsOfferwallError) {
        print("❌ Offerwall 오류: [\(error.code)] \(error.message)")
        // 재시도 로직 실행
        // handleRetry(...)
    }
}

---

관련 문서

• NestAdsOfferwallDelegate - Offerwall 이벤트 Delegate

• NestAds.Offerwall - Offerwall API

• Offerwall 광고 - Offerwall 통합 가이드