NestAds.Offerwall

NestAds.Offerwall API를 통해 Offerwall 기능을 사용하는 방법을 설명합니다.

public static let Offerwall: NestAdsOfferwallBridge

NestAdsSDK를 통해 Offerwall 기능을 사용하기 위한 브릿지 객체입니다.

NestAds.Offerwall는 런타임에 NestAdsOfferwallSDK를 동적으로 로드합니다. AppDelegate에서 import NestAdsOfferwallSDK를 추가해야 정상적으로 작동합니다.

---

Public Methods

initialize(application:appKey:appSecret:environment:timeoutMillis:)

@objc public func initialize(
    application: UIApplication,
    appKey: String,
    appSecret: String,
    environment: String = "production",
    timeoutMillis: NSNumber? = nil
)

Offerwall SDK를 초기화합니다.

일반적으로 OfferwallConfig를 사용하여 NestAds.sharedInstance().start(offerwallConfig:) 로 초기화하는 것을 권장합니다. 이 메서드는 직접 호출할 필요가 없습니다.

Parameters

파라미터	타입	설명
application	UIApplication	UIApplication 객체
appKey	String	Offerwall 전용 앱 키
appSecret	String	Offerwall 전용 앱 시크릿
environment	String	환경 설정 (기본값: "production")
timeoutMillis	NSNumber?	타임아웃 (밀리초). nil이면 30초로 설정됩니다.

---

login(userId:gender:birthYear:)

@objc public func login(
    userId: String,
    gender: Int = 0,
    birthYear: NSNumber? = nil
)

사용자를 Offerwall에 로그인합니다. Offerwall을 표시하기 전에 반드시 호출해야 합니다.

Parameters

파라미터	타입	설명
userId	String	[필수] 사용자 고유 ID
gender	Int	[선택] 성별. Gender 상수 사용 권장. 기본값: NestAdsGenderUnknown
birthYear	Int?	[선택] 출생 연도. Swift에서는 Int, Objective-C에서는 NSNumber 사용

Gender Constants

상수	값	설명
NestAdsGenderUnknown	0	알 수 없음 (기본값)
NestAdsGenderMale	1	남성
NestAdsGenderFemale	2	여성

Example

Swift

// 방법 1: 최소 정보만 (userId만 필수)
NestAds.Offerwall.login(userId: "user_12345")

// 방법 2: userId + gender (상수 사용 권장)
NestAds.Offerwall.login(
    userId: "user_12345",
    gender: NestAdsGenderMale
)

// 방법 3: 모든 정보 포함 (타겟 광고에 활용)
NestAds.Offerwall.login(
    userId: "user_12345",
    gender: NestAdsGenderFemale,
    birthYear: 1990
)

// 로그인 확인
DispatchQueue.main.asyncAfter(deadline: .now() + 1.0) {
    if NestAds.Offerwall.isLoggedIn {
        print("✅ 로그인 성공: \(NestAds.Offerwall.currentUserId)")
    }
}

---

logout()

@objc public func logout()

사용자를 Offerwall에서 로그아웃합니다.

Example

Swift

NestAds.Offerwall.logout()

DispatchQueue.main.asyncAfter(deadline: .now() + 0.5) {
    if !NestAds.Offerwall.isLoggedIn {
        print("✅ 로그아웃 성공")
    }
}

---

openOfferwall(from:placementCode:showNavigationBar:useNativeNavigationBar:delegate:)

@objc public func openOfferwall(
    from viewController: UIViewController,
    placementCode: String,
    showNavigationBar: Bool = false,
    useNativeNavigationBar: Bool = false,
    delegate: AnyObject? = nil
)

Offerwall을 화면에 표시합니다.

Parameters

파라미터	타입	설명
viewController	UIViewController	[필수] Offerwall을 표시할 뷰 컨트롤러
placementCode	String	[필수] 광고 게재위치 코드
showNavigationBar	Bool	[선택] 네비게이션 바 표시 여부 (기본값: false)
useNativeNavigationBar	Bool	[선택] 네이티브 네비게이션 바 사용 여부 (기본값: false)
delegate	AnyObject?	[선택] NestAdsOfferwallDelegate 프로토콜을 구현한 객체

Offerwall을 열기 전에 반드시 login()을 먼저 호출해야 합니다.

Example

Swift

import NestAdsSDK
import NestAdsOfferwallSDK

class MyViewController: UIViewController {

    @IBAction func showOfferwallTapped(_ sender: UIButton) {
        // 로그인 확인
        guard NestAds.Offerwall.isLoggedIn else {
            showLoginAlert()
            return
        }

        // Offerwall 표시
        NestAds.Offerwall.openOfferwall(
            from: self,
            placementCode: "YOUR_PLACEMENT_CODE",
            showNavigationBar: false,
            useNativeNavigationBar: false,
            delegate: self
        )
    }
}

// Delegate 구현
extension MyViewController: NestAdsOfferwallDelegate {
    func offerwallDidEarnReward(amount: Int) {
        print("리워드 획득: \(amount)")
    }

    func offerwallDidFail(_ error: NestAdsOfferwallError) {
        print("오류: \(error.message)")
    }
}

---

Public Properties

isInitialized

@objc public var isInitialized: Bool { get }

Offerwall SDK 초기화 여부를 반환합니다.

Example

Swift

if NestAds.Offerwall.isInitialized {
    print("✅ Offerwall SDK 초기화됨")
} else {
    print("❌ Offerwall SDK 초기화 안 됨")
}

---

isLoggedIn

@objc public var isLoggedIn: Bool { get }

사용자 로그인 여부를 반환합니다.

Example

Swift

if NestAds.Offerwall.isLoggedIn {
    print("✅ 로그인됨")
    openOfferwall()
} else {
    print("❌ 로그인 필요")
    showLoginScreen()
}

---

currentUserId

@objc public var currentUserId: String { get }

현재 로그인된 사용자 ID를 반환합니다. 로그인하지 않은 경우 빈 문자열을 반환합니다.

Example

Swift

let userId = NestAds.Offerwall.currentUserId
if !userId.isEmpty {
    print("현재 사용자: \(userId)")
}

---

sdkVersion

@objc public var sdkVersion: String { get }

NestAdsOfferwallSDK의 버전 정보를 반환합니다.

Example

Swift

let version = NestAds.Offerwall.sdkVersion
print("Offerwall SDK 버전: \(version)")

---

adchainSDKVersion

@objc public var adchainSDKVersion: String { get }

AdChain SDK의 버전 정보를 반환합니다.

Example

Swift

let version = NestAds.Offerwall.adchainSDKVersion
print("AdChain SDK 버전: \(version)")

---

Quiz 메서드

quiz()

@objc public func quiz() -> NestAdsOfferwallQuiz

새로운 Quiz 인스턴스를 생성합니다.

Returns

타입	설명
NestAdsOfferwallQuiz	새로운 Quiz 인스턴스

Example

Swift

let quiz = NestAds.Offerwall.quiz()
quiz.setDelegate(self)
quiz.load()

Quiz를 사용하기 전에 반드시 login()을 먼저 호출해야 합니다.

---

Mission 메서드

mission()

@objc public func mission() -> NestAdsOfferwallMission

새로운 Mission 인스턴스를 생성합니다.

Returns

타입	설명
NestAdsOfferwallMission	새로운 Mission 인스턴스

Example

Swift

let mission = NestAds.Offerwall.mission()
mission.setDelegate(self)
mission.load()

Mission을 사용하기 전에 반드시 login()을 먼저 호출해야 합니다.

---

전체 사용 예제

Swift

import UIKit
import NestAdsSDK
import NestAdsOfferwallSDK

// 1. AppDelegate에서 초기화
@main
class AppDelegate: UIResponder, UIApplicationDelegate {

    func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {

        let offerwallConfig = OfferwallConfig(
            application: application,
            appKey: "YOUR_APP_KEY",
            appSecret: "YOUR_APP_SECRET"
        )

        NestAds.sharedInstance().start(offerwallConfig: offerwallConfig)

        return true
    }
}

// 2. ViewController에서 사용
class RewardViewController: UIViewController {

    override func viewDidLoad() {
        super.viewDidLoad()

        // 로그인
        NestAds.Offerwall.login(
            userId: "user_12345",
            gender: NestAdsGenderMale,
            birthYear: 1990
        )
    }

    @IBAction func showOfferwallTapped(_ sender: UIButton) {
        // 상태 확인
        guard NestAds.Offerwall.isInitialized else {
            print("❌ SDK 초기화 안 됨")
            return
        }

        guard NestAds.Offerwall.isLoggedIn else {
            print("❌ 로그인 필요")
            return
        }

        // Offerwall 표시
        NestAds.Offerwall.openOfferwall(
            from: self,
            placementCode: "YOUR_PLACEMENT_CODE",
            delegate: self
        )
    }
}

// 3. Delegate 구현
extension RewardViewController: NestAdsOfferwallDelegate {

    func offerwallDidEarnReward(amount: Int) {
        print("🎁 리워드 획득: \(amount)")
        UserManager.shared.addPoints(amount)
    }

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

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

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

---

관련 문서

• OfferwallConfig - Offerwall 초기화 설정

• NestAdsOfferwallDelegate - Offerwall 이벤트 Delegate

• NestAdsOfferwallError - Offerwall 에러 모델

• NestAdsOfferwallQuizDelegate - Quiz 이벤트 Delegate

• NestAdsOfferwallMissionDelegate - Mission 이벤트 Delegate

• Offerwall 광고 - Offerwall 통합 가이드

• NestAds - NestAds 클래스