NestAdsDynamicBannerAdView

서버 응답에 따라 ImageBanner 또는 PremiumBanner를 동적으로 표시하는 배너 광고 뷰입니다.

open class NestAdsDynamicBannerAdView : UIView

서버에서 받은 광고 응답 타입(ImageBanner 또는 PremiumBanner)에 따라 자동으로 적절한 배너를 표시하는 동적 배너 광고 뷰입니다.

Delegate

weak open var delegate: (any NestAdsDynamicBannerAdViewDelegate)?

DynamicBanner의 광고 로드 이벤트를 수신하는 델리게이트입니다.

---

Public Variables

open var placementCode: String?

게재위치 코드

---

open weak var imageBannerDelegate: (any NestAdsImageBannerAdViewDelegate)?

ImageBanner 응답 시 네이티브 델리게이트 콜백을 받기 위한 프로퍼티입니다. 설정하면 ImageBanner의 모든 델리게이트 이벤트가 이 델리게이트로 전달됩니다.

---

open weak var premiumBannerDelegate: (any NestAdsPremiumBannerAdViewDelegate)?

PremiumBanner 응답 시 네이티브 델리게이트 콜백을 받기 위한 프로퍼티입니다. 설정하면 PremiumBanner의 모든 델리게이트 이벤트가 이 델리게이트로 전달됩니다.

---

open private(set) var currentResponseType: String? { get }

현재 로드된 광고 타입입니다. 광고 로드 성공 후 설정됩니다.

---

open private(set) var currentAdViewType: CurrentAdViewType { get }

현재 표시 중인 AdView 종류입니다.

CurrentAdViewType enum

public enum CurrentAdViewType {
    case none           // 광고가 로드되지 않음
    case imageBanner    // ImageBanner 표시 중
    case premiumBanner  // PremiumBanner 표시 중
}

---

ImageBanner Options

ImageBanner 응답 시 적용되는 옵션들입니다.

open var imageBannerBackgroundOptions: NestAdsBannerBackgroundOptions

ImageBanner의 배경 옵션

---

open var imageBannerLayoutOptions: NestAdsBannerLayoutOptions

ImageBanner의 레이아웃 옵션

---

open var imageBannerEnableOverflow: Bool

ImageBanner의 오버플로우 활성화 여부

default: false

---

PremiumBanner Options

PremiumBanner 응답 시 적용되는 옵션들입니다.

open var premiumLayoutOptions: NestAdsPremiumBannerLayoutOptions

PremiumBanner의 레이아웃 옵션

---

open var premiumDefaultBannerOptions: NestAdsPremiumAdDefaultBannerOptions

PremiumBanner의 기본(축소) 상태 배너 옵션

---

open var premiumExpandedBannerOptions: NestAdsPremiumAdExpandedBannerOptions

PremiumBanner의 확장 상태 배너 옵션

---

open var premiumExpandedBannerVideoOptions: NestAdsPremiumAdExpandedBannerVideoOptions

PremiumBanner의 확장 상태 비디오 옵션

---

open var premiumHintAssetOptions: NestAdsPremiumBannerHintAssetOptions

PremiumBanner의 힌트 애셋 옵션

---

open var premiumCtaButtonOptions: NestAdsPremiumBannerCtaButtonOptions

PremiumBanner의 CTA 버튼 옵션

---

open var premiumAdvertiserOptions: NestAdsPremiumBannerAdvertiserOptions

PremiumBanner의 광고주 문구 옵션

---

open var premiumAdTextOptions: NestAdsPremiumBannerAdTextOptions

PremiumBanner의 광고 문구 옵션

---

Public Methods

public init(bannerSize: NestAdsAdSize, premiumDefaultSize: NestAdsAdSize, premiumExpandedSize: NestAdsAdSize)

NestAdsDynamicBannerAdView를 생성합니다.

매개변수	설명
bannerSize	ImageBanner 표시 시 사용할 배너 사이즈
premiumDefaultSize	PremiumBanner의 기본(축소) 상태 사이즈
premiumExpandedSize	PremiumBanner의 확장 상태 사이즈

---

open func load(_ request: NestAdsAdRequest?)

광고를 요청하고 로드합니다. 서버 응답에 따라 ImageBanner 또는 PremiumBanner가 자동으로 표시됩니다.

매개변수	설명
request	광고 요청 객체 (nil 가능)

---

사용 예시

import NestAdsSDK

class ViewController: UIViewController {
    private var dynamicBannerView: NestAdsDynamicBannerAdView!

    override func viewDidLoad() {
        super.viewDidLoad()

        // DynamicBannerAdView 생성
        dynamicBannerView = NestAdsDynamicBannerAdView(
            bannerSize: NestAdsAdSizeFluid,
            premiumDefaultSize: NestAdsAdSize(size: CGSize(width: 320, height: 100)),
            premiumExpandedSize: NestAdsAdSize(size: CGSize(width: 320, height: 480))
        )

        // 게재위치 설정
        dynamicBannerView.placementCode = "YOUR_PLACEMENT_CODE"

        // 델리게이트 설정
        dynamicBannerView.delegate = self
        dynamicBannerView.imageBannerDelegate = self
        dynamicBannerView.premiumBannerDelegate = self

        // ImageBanner 옵션 설정
        dynamicBannerView.imageBannerLayoutOptions.paddingTop = 10
        dynamicBannerView.imageBannerLayoutOptions.paddingBottom = 10

        // PremiumBanner 옵션 설정
        dynamicBannerView.premiumDefaultBannerOptions.backgroundColor = .white

        // 뷰에 추가
        view.addSubview(dynamicBannerView)

        // Auto Layout 설정
        dynamicBannerView.translatesAutoresizingMaskIntoConstraints = false
        NSLayoutConstraint.activate([
            dynamicBannerView.leadingAnchor.constraint(equalTo: view.leadingAnchor),
            dynamicBannerView.trailingAnchor.constraint(equalTo: view.trailingAnchor),
            dynamicBannerView.bottomAnchor.constraint(equalTo: view.safeAreaLayoutGuide.bottomAnchor)
        ])

        // 광고 로드
        dynamicBannerView.load(NestAdsAdRequest())
    }
}

extension ViewController: NestAdsDynamicBannerAdViewDelegate {
    func dynamicBannerAdView(
        _ adView: NestAdsDynamicBannerAdView,
        didReceiveAdWithType responseType: String
    ) {
        print("광고 로드 성공: \(responseType)")
        // responseType: "IMAGE_BANNER" 또는 "PREMIUM_BANNER"
    }

    func dynamicBannerAdView(
        _ adView: NestAdsDynamicBannerAdView,
        didFailToReceiveAdWithError error: NestAdsAdError
    ) {
        print("광고 로드 실패: \(error.message)")
    }
}

extension ViewController: NestAdsImageBannerAdViewDelegate {
    func imageBannerAdViewDidReceiveAd(_ imageBannerAdView: NestAdsImageBannerAdView) {
        print("ImageBanner 표시 완료")
    }

    func imageBannerAdViewDidRecordImpression(_ imageBannerAdView: NestAdsImageBannerAdView) {
        print("ImageBanner 노출")
    }

    func imageBannerAdViewDidRecordClick(_ imageBannerAdView: NestAdsImageBannerAdView) {
        print("ImageBanner 클릭")
    }
}

extension ViewController: NestAdsPremiumBannerAdViewDelegate {
    func premiumAdViewDidReceiveAd(_ adView: NestAdsPremiumBannerAdView) {
        print("PremiumBanner 표시 완료")
    }

    func premiumAdViewDidExpand(_ adView: NestAdsPremiumBannerAdView) {
        print("PremiumBanner 확장")
    }

    func premiumAdViewDidShrink(_ adView: NestAdsPremiumBannerAdView) {
        print("PremiumBanner 축소")
    }
}

---

참고

• NestAdsImageBannerAdView

• NestAdsPremiumBannerAdView

• NestAdsPremiumBannerAdViewDelegate

• NestAdsAdRequest