iOS SDK 마이그레이션 가이드

핵심 변경사항: 기존의 delegate 패턴에서 listener 클로저 기반 패턴으로 변경되었습니다.

공통 리스너 구조

// 모든 광고 타입에서 공통으로 사용되는 리스너들
ad.listener.onAdLoadSuccess = { ad, adInfo in
    // 광고 로드 성공 시 호출
}

ad.listener.onAdLoadFail = { error in
    // 광고 로드 실패 시 호출
}

ad.listener.onAdImpression = { adInfo in
    // 광고 노출 시 호출
}

ad.listener.onAdClicked = { adInfo in
    // 광고 클릭 시 호출
}

광고 표시 관련 리스너들

// 광고 표시 리스너 설정
(interstitialListener | rewardedAdListener | appOpenAdListener )
.onShown = { adInfo in
    print("[DARO] Listener Sample Interstitial Ad shown: \(adInfo)")
}
(interstitialListener | rewardedAdListener | appOpenAdListener )
.onDismiss = { adInfo in
    print("[DARO] Listener Sample Interstitial Ad dismissed: \(adInfo)")
}
(interstitialListener | rewardedAdListener | appOpenAdListener )
.onFailedToShow = { adInfo, error in
    print("[DARO] Listener Sample Interstitial Ad failed to show: \(adInfo) \(error)")
}

리워드 광고 전용 리스너

rewardedAd.rewardedAdListener.onEarnedReward = { rewardItem, adInfo in
    // 리워드 획득 시 호출
}

광고 타입별 코드 변경

Show 배너 광고

Show 기존 코드 - DaroAds non-reward SDK

let adUnit = DaroAdBannerViewUnit(id: "your_ad_unit_id")
let bannerView = DaroAdBannerView(adUnit: adUnit)
bannerView.adUnit = adUnit
bannerView.delegate = self
bannerView.loadAd()
    
// DaroAdBannerViewDelegate
func bannerViewDidReceiveAd(_ bannerView: DaroAdBannerView)
func bannerView(_ bannerView: DaroAdBannerView, didFailToReceiveAdWithError error: Error)
// ... 이외 delegate 메서드 구현

Show 기존 코드 - DaroMAds reward SDK

let adUnit = DaroMAdUnit(adUnitID: "your_ad_unit_id", format: .banner)
let bannerAdView = DaroMAdView(adUnit: adUnit)
bannerAdView.delegate = self
bannerAdView.impressionDelegate = self
bannerAdView.clickDelegate = self
        
bannerAdView.loadAd()

// DaroMAdViewDelegate, DaroMAdImpressionDelegate, DaroMAdClickDelegate
func didLoad(_ ad: DaroMAd)
func didFailToLoadAd(for adUnitIdentifier: String, with error: DaroMError)
// ... 이외 delegate 메서드 구현

새로운 코드

let adUnit = DaroAdUnit(unitId: "your_ad_unit_id")
let bannerView = DaroAdBannerView(unit: adUnit, bannerSize: .banner)
bannerView.listener.onAdClicked = { adInfo in
    print("[DARO] Listener Sample Banner Ad clicked: \(adInfo)")
}
bannerView.listener.onAdImpression = { adInfo in
    print("[DARO] Listener Sample Banner Ad impression: \(adInfo)")
}
bannerView.listener.onAdLoadSuccess = { ad, adInfo in
    print("[DARO] Listener Sample Banner Ad loaded: \(ad) \(adInfo)")
}
bannerView.listener.onAdLoadFail = { error in
    print("[DARO] Listener Sample Banner Ad failed: \(error)")
}
bannerView.loadAd()

Show 인터스티셜 광고

Show 기존 코드 - DaroAds non-reward SDK

let adUnit = DaroAdInterstitialUnit(id: "your_ad_unit_id")
DaroInterstitialAd.load(adUnit: adUnit) { result in
    switch result {
    case .success(let interstitialAd):
        interstitialAd.fullScreenDelegate = self
        // 광고 표시
        interstitialAd.present(from: viewController)
    case .failure(let error):
        print("인터스티셜 광고 로드 실패: \(error)")
    }
}

// DaroFullScreenAdDelegate
func didFailToPresent(with error: Error)
func willPresentFullScreenContent()
func didDismissFullScreenContent()
// ... 이외 delegate 메서드 구현

Show 기존 코드 - DaroMAds reward SDK

let adUnit = DaroMAdUnit(adUnitID: "your_ad_unit_id", format: .interstitial)
let interstitialAd = DaroMInterstitialAd(adUnit: adUnit)
interstitialAd.loadingDelegate = self
interstitialAd.displayDelegate = self
interstitialAd.impressionDelegate = self
interstitialAd.clickDelegate = self
interstitialAd.load()

// DaroMAdLoadingDelegate, DaroMAdImpressionDelegate, DaroMAdDisplayDelegate, DaroMAdClickDelegate
func didLoad(_ ad: DaroMAd)
func didFailToLoadAd(for adUnitIdentifier: String, with error: DaroMError)
// ... 이외 delegate 메서드 구현

새로운 코드

let adUnit = DaroAdUnit(unitId: "your_ad_unit_id")
let interstitialAdLoader = DaroInterstitialAdLoader(unit: adUnit)
interstitialAdLoader.listener.onAdLoadSuccess = { ad, adInfo in
    print("[DARO] Listener Sample Interstitial Ad loaded: \(ad) \(adInfo)")
}
interstitialAdLoader.listener.onAdLoadFail = { error in
    print("[DARO] Listener Sample Interstitial Ad failed: \(error)")
}
interstitialAdLoader.listener.onAdClicked = { adInfo in
    print("[DARO] Listener Sample Interstitial Ad clicked: \(adInfo)")
}
interstitialAdLoader.listener.onAdImpression = { adInfo in
    print("[DARO] Listener Sample Interstitial Ad impression: \(adInfo)")
}

// 광고 로드
self.daroInterstitialAd = try? await interstitialAdLoader.loadAd()

// 광고 표시 리스너 설정
self.daroInterstitialAd?.interstitialListener.onShown = { adInfo in
    print("[DARO] Listener Sample Interstitial Ad shown: \(adInfo)")
}
self.daroInterstitialAd?.interstitialListener.onDismiss = { adInfo in
    print("[DARO] Listener Sample Interstitial Ad dismissed: \(adInfo)")
}
self.daroInterstitialAd?.interstitialListener.onFailedToShow = { adInfo, error in
    print("[DARO] Listener Sample Interstitial Ad failed to show: \(adInfo) \(error)")
}

Show 리워드 광고

Show 기존 코드 - DaroAds non-reward SDK

let adUnit = DaroAdRewardedUnit(id: "your_ad_unit_id")
DaroRewardedAd.load(adUnit: adUnit) { result in
    switch result {
    case .success(let rewardedAd):
        rewardedAd.fullScreenDelegate = self
        // 광고 표시
        rewardedAd.present(from: viewController) { rewardItem in
            print("리워드 획득: \(rewardItem.amount) \(rewardItem.type)")
        }
    case .failure(let error):
        print("리워드 광고 로드 실패: \(error)")
    }
}

// DaroFullScreenAdDelegate
func didFailToPresent(with error: Error)
func willPresentFullScreenContent()
func didDismissFullScreenContent()
// ... 이외 delegate 메서드 구현

Show 기존 코드 - DaroMAds reward SDK

let adUnit = DaroMAdUnit(adUnitID: "your_ad_unit_id", format: .rewarded)
let rewardedAd = DaroMRewardedAd(adUnit: adUnit)
rewardedAd.loadingDelegate = self
rewardedAd.displayDelegate = self
rewardedAd.rewardDelegate = self
rewardedAd.impressionDelegate = self
rewardedAd.clickDelegate = self
rewardedAd.load()

// DaroMRewardedAdDelegate, DaroMAdLoadingDelegate, DaroMAdImpressionDelegate, DaroMAdDisplayDelegate, DaroMAdClickDelegate
func didLoad(_ ad: DaroMAd)
func didFailToLoadAd(for adUnitIdentifier: String, with error: DaroMError)
func didEarnReward(_ reward: DaroMReward)
// ... 이외 delegate 메서드 구현

새로운 코드

let adUnit = DaroAdUnit(unitId: "your_ad_unit_id")
let rewardedAdLoader = DaroRewardedAdLoader(unit: adUnit)
rewardedAdLoader.listener.onAdClicked = { adInfo in
    print("[DARO] Listener Sample Rewarded Ad clicked: \(adInfo)")
}
rewardedAdLoader.listener.onAdImpression = { adInfo in
    print("[DARO] Listener Sample Rewarded Ad impression: \(adInfo)")
}
rewardedAdLoader.listener.onAdLoadSuccess = { ad, adInfo in
    print("[DARO] Listener Sample Rewarded Ad loaded: \(ad) \(adInfo)")
}
rewardedAdLoader.listener.onAdLoadFail = { error in
    print("[DARO] Listener Sample Rewarded Ad failed: \(error)")
}
self.daroRewardedAd = try? await rewardedAdLoader.loadAd()

self.daroRewardedAd?.rewardedAdListener.onEarnedReward = { adInfo, rewardedItem in
    print("[DARO] Listener Sample Reward Ad earned: \(adInfo) \(rewardedItem)")
}
self.daroRewardedAd?.rewardedAdListener.onShown = { adInfo in
    print("[DARO] Listener Sample Reward Ad shown: \(adInfo)")
}
self.daroRewardedAd?.rewardedAdListener.onDismiss = { adInfo in
    print("[DARO] Listener Sample Reward Ad dismissed: \(adInfo)")
}
self.daroRewardedAd?.rewardedAdListener.onFailedToShow = { adInfo, error in
    print("[DARO] Listener Sample Reward Ad failed to show: \(adInfo) \(error)")
}

Show 앱 오픈 광고

Show 기존 코드 - DaroAds non-reward SDK

let adUnit = DaroAdAppOpenUnit(id: "your_ad_unit_id")
DaroAppOpenAd.load(adUnit: adUnit) { result in
    switch result {
    case .success(let appOpenAd):
        appOpenAd.fullScreenDelegate = self
        // 광고 표시
        appOpenAd.present(from: viewController)
    case .failure(let error):
        print("앱 오픈 광고 로드 실패: \(error)")
    }
}

// DaroFullScreenAdDelegate
func didFailToPresent(with error: any Error)
func willPresentFullScreenContent()
func didDismissFullScreenContent()
// ... 이외 delegate 메서드 구현

Show 기존 코드 - DaroMAds reward SDK

let adUnit = DaroMAdUnit(adUnitID: "your_ad_unit_id", format: .appOpen)
let appOpenAd = DaroMAppOpenAd(adUnit: adUnit)
appOpenAd.loadingDelegate = self
appOpenAd.displayDelegate = self
appOpenAd.impressionDelegate = self
appOpenAd.clickDelegate = self
appOpenAd.load()

// DaroMAdLoadingDelegate, DaroMAdImpressionDelegate, DaroMAdDisplayDelegate, DaroMAdClickDelegate
func didLoad(_ ad: DaroMAd)
func didFailToLoadAd(for adUnitIdentifier: String, with error: DaroMError)
// ... 이외 delegate 메서드 구현

새로운 코드

let adUnit = DaroAdUnit(unitId: "your_ad_unit_id")
let appOpenAdLoader = DaroAppOpenAdLoader(unit: .appOpenUnit)
appOpenAdLoader.listener.onAdLoadSuccess = { ad, adInfo in
    print("[DARO] Listener AppOpenAd loaded: \(ad) \(adInfo)")
}
appOpenAdLoader.listener.onAdLoadFail = { error in
    print("[DARO] Listener AppOpenAd failed: \(error)")
}
appOpenAdLoader.listener.onAdClicked = { adInfo in
    print("[DARO] Listener AppOpenAd clicked: \(adInfo)")
}
appOpenAdLoader.listener.onAdImpression = { adInfo in
    print("[DARO] Listener AppOpenAd impression: \(adInfo)")
}
let appOpenAd = try await appOpenAdLoader.loadAd()
appOpenAd.appOpenAdListener.onShown = { adInfo in
    print("[DARO] Listener AppOpenAd shown: \(adInfo)")
}
appOpenAd.appOpenAdListener.onDismiss = { adInfo in
    print("[DARO] Listener AppOpenAd dismissed: \(adInfo)")
}
appOpenAd.appOpenAdListener.onFailedToShow = { adInfo, error in
    print("[DARO] Listener AppOpenAd failed to show: \(adInfo) \(error)")
}

Show 네이티브 광고

Show 기존 코드 - DaroAds non-reward SDK

// 커스텀 네이티브 뷰 생성
final class CustomNativeAdView: DaroNativeAdContentView {
    private var titleLabel = UILabel()
    private var bodyLabel = UILabel()
    private var mediaView = DaroMediaView()
    private var callToActionButton = UIButton()
    
    required init() {
        super.init()
        layout()
        bindViews(
            headlineLabel: titleLabel,
            callToActionButton: callToActionButton,
            bodyLabel: bodyLabel,
            mediaView: mediaView
        )
    }
    
    // ... 레이아웃 코드
}

// 사용
let adUnit = DaroNativeAdUnit(id: "your_ad_unit_id")
let nativeAdView = DaroNativeAdView(
    adUnit: adUnit,
    nativeAdContentViewType: CustomNativeAdView.self
)
nativeAdView.delegate = self
nativeAdView.loadAd()

// DaroNativeAdDelegate
func nativeAdDidRecordClick(_ nativeAd: DaroNativeAd) { }
func nativeAdDidRecordImpression(_ nativeAd: DaroNativeAd) { }

Show 기존 코드 - DaroMAds reward SDK

// 커스텀 네이티브 뷰 생성
final class CustomNativeAdView: DaroMNativeAdContentView {
    public override var titleLabel: UILabel? {
        get { internalTitleLabel }
        set { super.titleLabel = newValue }
    }
    let internalTitleLabel = UILabel()
    
    public override var iconImageView: UIImageView? {
        get { internalIconImageView }
        set { super.iconImageView = newValue }
    }
    let internalIconImageView = UIImageView()

    public override var callToActionButton: UIButton? {
        get { internalCallToActionButton }
        set { super.callToActionButton = newValue }
    }
    let internalCallToActionButton = UIButton()

    required init() {
        super.init()
        layout()
        
        let binder = DaroMNativeAdViewBinder { builder in
            builder.titleLabelTag = 1001
            builder.builder.iconImageViewTag = 1004
            builder.callToActionButtonTag = 1007
        }
        bindViews(with: binder)
    }
    
    // ... 레이아웃 코드
}

// 사용
let adUnit = DaroMAdUnit(adUnitID: "your_ad_unit_id", format: .native)
let nativeAdView = CustomNativeAdView()
nativeAdView.loadAd()

새로운 코드

// 커스텀 네이티브 뷰 생성
final class CustomNativeAdView: DaroAdNativeView {
    private var titleLabel = UILabel()
    private var advertiserLabel = UILabel()
    private var bodyLabel = UILabel()
    private var iconImageView = UIImageView()
    private var mediaContentView = UIView()
    private var callToActionButton = UIButton()
    
    override init(unit: DaroAdUnit) {
        super.init(unit: unit)
        layout()
        
        // 뷰 바인딩
        bindViews(
            titleLabel: titleLabel,
            advertiserLabel: advertiserLabel,
            bodyLabel: bodyLabel,
            iconImageView: iconImageView,
            mediaContentView: mediaContentView,
            callToActionButton: callToActionButton
        )
    }
    
    // ... 레이아웃 코드
}

// 사용
let adUnit = DaroAdUnit(unitId: "your_ad_unit_id")
let nativeAdView = CustomNativeAdView(unit: adUnit)
view.addSubview(nativeAdView)
// 리스너 설정
nativeAdView.listener.onAdLoadSuccess = { ad, adInfo in
    print("[DARO] Native Ad loaded: \(ad) \(adInfo)")
}
nativeAdView.listener.onAdLoadFail = { error in
    print("[DARO] Native Ad failed: \(error)")
}
nativeAdView.listener.onAdClicked = { adInfo in
    print("[DARO] Native Ad clicked: \(adInfo)")
}
nativeAdView.listener.onAdImpression = { adInfo in
    print("[DARO] Native Ad impression: \(adInfo)")
}
nativeAdView.loadAd()

Show 라이트 팝업 광고 (신규)

라이트 팝업 광고는 새로운 SDK에서 추가된 기능입니다.

새로운 기능

let adUnit = DaroAdUnit(unitId: "your_ad_unit_id")

// 라이트 팝업 설정
let configuration = DaroLightPopupConfiguration()
// 원하는 설정 수정

let lightPopupAdLoader = DaroLightPopupAdLoader(unit: adUnit)
lightPopupAdLoader.listener.onAdClicked = { adInfo in
    print("[DARO] Listener Sample LightPopup Ad clicked: \(adInfo)")
}
lightPopupAdLoader.listener.onAdImpression = { adInfo in
    print("[DARO] Listener Sample LightPopup Ad impression: \(adInfo)")
}
lightPopupAdLoader.listener.onAdLoadSuccess = { [weak self] ad, adInfo in
    print("[DARO] Listener Sample Light Popup Ad loaded: \(ad) \(adInfo)")
    self?.daroLightPopupAd = ad
    self?.daroLightPopupAd?.lightPopupAdListener.onShown = { adInfo in
        print("[DARO] Listener Sample Light Popup Ad shown: \(adInfo)")
    }
    self?.daroLightPopupAd?.lightPopupAdListener.onDismiss = { adInfo in
        print("[DARO] Listener Sample Light Popup Ad dismissed: \(adInfo)")
    }
    self?.daroLightPopupAd?.lightPopupAdListener.onFailedToShow = { adInfo, error in    
        print("[DARO] Listener Sample Light Popup Ad failed to show: \(adInfo) \(error)")
    }
}
lightPopupAdLoader.listener.onAdLoadFail = { error in
    print("[DARO] Listener Sample LightPopup Ad failed: \(error)")
}
lightPopupAdLoader.loadAd()

다로 시작하기

SDK 통합하기

DARO 사용하기

FAQ

iOS SDK 마이그레이션 가이드

프로젝트 설정

코드 마이그레이션

마이그레이션 체크리스트

문제 해결

다로 시작하기

SDK 통합하기

DARO 사용하기

FAQ

​프로젝트 설정

​코드 마이그레이션

​마이그레이션 체크리스트

​문제 해결

프로젝트 설정

코드 마이그레이션

마이그레이션 체크리스트

문제 해결