광고 응답 기반 설정

아래 가이드에서는 한 게재위치에 여러 광고 형식을 설정하고, 광고 응답에 따라 자동으로 적절한 광고 형식을 표시하는 방법을 설명합니다.

v2.9.0 버전에서는 이미지 배너, 프리미엄 배너 광고 상품만 표시할 수 있습니다.

개요

한 게재위치에 여러 광고 형식(예: 이미지 배너 광고, 프리미엄 배너 광고)을 동시에 설정하면, SDK가 광고 응답을 받은 후 응답에 포함된 광고 형식에 맞춰 자동으로 적절한 광고를 표시합니다.

이 방식을 사용하면:

• 하나의 게재위치에서 배너 형태의 여러 광고 형식을 지원할 수 있습니다

• 광고 서버에서 반환하는 광고 형식에 따라 자동으로 적절한 UI가 렌더링됩니다

• 코드를 단순화하고 유지보수를 쉽게 할 수 있습니다

---

기본 요건

시작 가이드에 따라 필요한 과정을 완료합니다.

---

광고 표시하기

1. 배너 광고를 표시할 영역에서 NestAdsDynamicBannerAdView를 생성합니다.

2. (필수) 게재위치를 설정합니다.

3. (옵션) 이미지 배너 옵션을 설정합니다.

4. (옵션) 프리미엄 배너 옵션을 설정합니다.

5. (옵션) 광고 델리게이트를 설정합니다.

6. 광고를 로드합니다.

Swift

import UIKit
import NestAdsSDK

class ViewController: UIViewController {
    private var dynamicBannerView: NestAdsDynamicBannerAdView!

    override func viewDidLoad() {
        super.viewDidLoad()

        // 1. NestAdsDynamicBannerAdView를 생성합니다.
        // ImageBanner, PremiumBanner의 기본/확장 사이즈를 지정합니다.
        // 모든 사이즈에 NestAdsAdSizeFluid를 사용하면 컨테이너 너비에 맞게 자동 조절됩니다.
        dynamicBannerView = NestAdsDynamicBannerAdView(
            bannerSize: NestAdsAdSizeFluid,           // ImageBanner 사이즈
            premiumDefaultSize: NestAdsAdSizeFluid,   // Premium 기본 사이즈
            premiumExpandedSize: NestAdsAdSizeFluid   // Premium 확장 사이즈
        )

        // 2. (필수) 게재위치를 설정합니다.
        dynamicBannerView.placementCode = "YOUR_PLACEMENT_CODE"

        // 3. (옵션) 이미지 배너 옵션을 설정합니다.
        // 이미지 배너가 로드될 경우 적용됩니다.
        dynamicBannerView.imageBannerLayoutOptions = NestAdsBannerLayoutOptions(cornerRadius: 8)
        dynamicBannerView.imageBannerBackgroundOptions = NestAdsBannerBackgroundOptions(
            backgroundColor: .white,
            opacity: 1.0
        )

        // enableOverflow 옵션 (기본값: false)
        dynamicBannerView.imageBannerEnableOverflow = false

        // 4. (옵션) 프리미엄 배너 옵션을 설정합니다.
        // 프리미엄 배너가 로드될 경우 적용됩니다.
        dynamicBannerView.premiumLayoutOptions = NestAdsPremiumBannerLayoutOptions(cornerRadius: 8)
        dynamicBannerView.premiumDefaultBannerOptions = NestAdsPremiumAdDefaultBannerOptions(
            backgroundColor: .white,
            opacity: 1.0
        )

        // 5. (옵션) 광고 델리게이트를 설정합니다.
        // 공통 델리게이트 (광고 로드 이벤트)
        dynamicBannerView.delegate = self

        // 이미지 배너 전용 델리게이트
        dynamicBannerView.imageBannerDelegate = self

        // 프리미엄 배너 전용 델리게이트
        dynamicBannerView.premiumBannerDelegate = self

        // 뷰에 추가
        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
            )
        ])

        // 6. 광고를 로드합니다.
        dynamicBannerView.load(NestAdsAdRequest())
    }
}

// MARK: - NestAdsDynamicBannerAdViewDelegate
extension ViewController: NestAdsDynamicBannerAdViewDelegate {
    func dynamicBannerAdView(
        _ adView: NestAdsDynamicBannerAdView,
        didReceiveAdWithType responseType: String
    ) {
        // 광고 로드 완료 시 호출
        // responseType으로 어떤 타입의 배너가 로드되었는지 확인 가능
        print("광고 로드 성공: \(responseType)")
    }

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

// MARK: - NestAdsImageBannerAdViewDelegate
extension ViewController: NestAdsImageBannerAdViewDelegate {
    func imageBannerAdViewDidReceiveAd(_ imageBannerAdView: NestAdsImageBannerAdView) {
        // 이미지 배너 표시 완료
        print("이미지 배너 표시")
    }

    func imageBannerAdView(_ imageBannerAdView: NestAdsImageBannerAdView, didFailToReceiveAdWithError error: NestAdsAdError) {
        print("이미지 배너 로드 실패: \(error.message)")
    }

    func imageBannerAdViewDidRecordImpression(_ imageBannerAdView: NestAdsImageBannerAdView) {
        print("이미지 배너 노출")
    }

    func imageBannerAdViewDidRecordClick(_ imageBannerAdView: NestAdsImageBannerAdView) {
        print("이미지 배너 클릭")
    }

    func imageBannerAdViewWillPresentScreen(_ imageBannerAdView: NestAdsImageBannerAdView) {}
    func imageBannerAdViewWillDismissScreen(_ imageBannerAdView: NestAdsImageBannerAdView) {}
    func imageBannerAdViewDidDismissScreen(_ imageBannerAdView: NestAdsImageBannerAdView) {}
}

// MARK: - NestAdsPremiumBannerAdViewDelegate
extension ViewController: NestAdsPremiumBannerAdViewDelegate {
    func premiumAdViewDidReceiveAd(_ adView: NestAdsPremiumBannerAdView) {
        print("프리미엄 배너 표시")
    }

    func premiumAdView(_ adView: NestAdsPremiumBannerAdView, didFailToReceiveAdWithError error: NestAdsAdError) {
        print("프리미엄 배너 로드 실패: \(error.message)")
    }

    func premiumAdViewDidExpand(_ adView: NestAdsPremiumBannerAdView) {
        print("프리미엄 배너 확장")
    }

    func premiumAdViewDidShrink(_ adView: NestAdsPremiumBannerAdView) {
        print("프리미엄 배너 축소")
    }

    func premiumAdViewExpandedRectInfoOnScrollView(_ adView: NestAdsPremiumBannerAdView, rect: CGRect) {
        print("프리미엄 배너 위치 변경: \(rect)")
    }

    // 나머지 필수 delegate 메서드...
    func premiumAdViewDidRecordImpressionOnDefaultView(_ adView: NestAdsPremiumBannerAdView) {}
    func premiumAdViewDidRecordImpressionOnExpandedView(_ adView: NestAdsPremiumBannerAdView) {}
    func premiumAdViewDidPerformClickOnDefaultView(_ adView: NestAdsPremiumBannerAdView) {}
    func premiumAdViewDidPerformClickOnExpandedView(_ adView: NestAdsPremiumBannerAdView) {}
    func premiumAdViewDidPerformClickOnCtaButton(_ adView: NestAdsPremiumBannerAdView) {}
    func premiumAdViewDidPerformClickOnHintAsset(_ adView: NestAdsPremiumBannerAdView) {}
    func premiumAdViewWillPresentScreen(_ adView: NestAdsPremiumBannerAdView) {}
    func premiumAdViewWillDismissScreen(_ adView: NestAdsPremiumBannerAdView) {}
    func premiumAdViewDidDismissScreen(_ adView: NestAdsPremiumBannerAdView) {}
    func didTapCtaButton(_ adView: NestAdsPremiumBannerAdView) {}
    func didTapAdvertiser(_ adView: NestAdsPremiumBannerAdView) {}
    func didTapAdProfile(_ adView: NestAdsPremiumBannerAdView) {}
    func expandedVideoDidCompletePreparation() {}
    func expandedVideoDidFailToLoadVideo(errorDescription: String) {}
    func expandedVideoDidPlayVideo() {}
    func expandedVideoDidPauseVideo() {}
    func expandedVideoDidEndVideoPlayback() {}
    func expandedVideoDidMuteVideo() {}
    func expandedVideoDidUnmuteVideo() {}
    func expandedVideoDidUpdateVideoProgress(current: TimeInterval) {}
}

NestAdsAdSizeFluid 사용 권장

Mobile 환경에서는 모든 사이즈 파라미터에 NestAdsAdSizeFluid를 사용하는 것을 권장합니다. Fluid 사이즈를 사용하면 SDK가 컨테이너 너비에 맞춰 자동으로 크기를 조절합니다.

자동 배너 타입 판별

NestAdsDynamicBannerAdView는 서버 응답의 type 필드를 기반으로 적절한 배너 뷰를 자동으로 생성합니다.

• 이미지 배너 응답 시: NestAdsImageBannerAdView 생성 및 imageBannerOptions 적용

• 프리미엄 배너 응답 시: NestAdsPremiumBannerAdView 생성 및 premiumBannerOptions 적용

---

설정 옵션 요약

공통 설정

속성	타입	기본값	설명
placementCode	String?	nil	게재위치 코드 (필수)
delegate	NestAdsDynamicBannerAdViewDelegate?	nil	광고 로드 이벤트 델리게이트
currentResponseType	String?	nil	현재 로드된 광고 타입 (읽기 전용)
currentAdViewType	CurrentAdViewType	.none	현재 표시 중인 AdView 종류 (읽기 전용)

이미지 배너 설정

속성	타입	기본값	설명
imageBannerBackgroundOptions	NestAdsBannerBackgroundOptions	NestAdsBannerBackgroundOptions()	이미지 배너 배경 옵션
imageBannerLayoutOptions	NestAdsBannerLayoutOptions	NestAdsBannerLayoutOptions()	이미지 배너 레이아웃 옵션
imageBannerEnableOverflow	Bool	false	overflow 허용 여부
imageBannerDelegate	NestAdsImageBannerAdViewDelegate?	nil	이미지 배너 이벤트 델리게이트

프리미엄 배너 설정

속성	타입	기본값	설명
premiumLayoutOptions	NestAdsPremiumBannerLayoutOptions	NestAdsPremiumBannerLayoutOptions()	프리미엄 배너 레이아웃 옵션
premiumDefaultBannerOptions	NestAdsPremiumAdDefaultBannerOptions	NestAdsPremiumAdDefaultBannerOptions()	기본(축소) 상태 배너 옵션
premiumExpandedBannerOptions	NestAdsPremiumAdExpandedBannerOptions	NestAdsPremiumAdExpandedBannerOptions()	확장 상태 배너 옵션
premiumExpandedBannerVideoOptions	NestAdsPremiumAdExpandedBannerVideoOptions	NestAdsPremiumAdExpandedBannerVideoOptions()	확장 상태 비디오 옵션
premiumHintAssetOptions	NestAdsPremiumBannerHintAssetOptions	NestAdsPremiumBannerHintAssetOptions()	힌트 애셋 옵션
premiumCtaButtonOptions	NestAdsPremiumBannerCtaButtonOptions	NestAdsPremiumBannerCtaButtonOptions()	CTA 버튼 옵션
premiumAdvertiserOptions	NestAdsPremiumBannerAdvertiserOptions	NestAdsPremiumBannerAdvertiserOptions()	광고주 문구 옵션
premiumAdTextOptions	NestAdsPremiumBannerAdTextOptions	NestAdsPremiumBannerAdTextOptions()	광고 문구 옵션
premiumBannerDelegate	NestAdsPremiumBannerAdViewDelegate?	nil	프리미엄 배너 이벤트 델리게이트

---

레이아웃별 구현 가이드

Dynamic Banner가 PremiumBanner로 응답할 경우, 확장/축소 시 레이아웃 갱신이 필요합니다.

1. StackView + ScrollView

가장 기본적인 레이아웃 패턴입니다. SDK가 intrinsicContentSize를 제공하므로 StackView에서 자동으로 크기가 결정됩니다.

Swift

class DynamicBannerScrollViewController: UIViewController {
    private var scrollView: UIScrollView!
    private var stackView: UIStackView!
    private var dynamicBannerView: NestAdsDynamicBannerAdView!

    override func viewDidLoad() {
        super.viewDidLoad()
        setupScrollView()
        setupDynamicBanner()
    }

    private func setupScrollView() {
        scrollView = UIScrollView()
        scrollView.translatesAutoresizingMaskIntoConstraints = false
        view.addSubview(scrollView)

        stackView = UIStackView()
        stackView.axis = .vertical
        stackView.spacing = 16
        stackView.translatesAutoresizingMaskIntoConstraints = false
        scrollView.addSubview(stackView)

        NSLayoutConstraint.activate([
            scrollView.topAnchor.constraint(equalTo: view.safeAreaLayoutGuide.topAnchor),
            scrollView.leadingAnchor.constraint(equalTo: view.leadingAnchor),
            scrollView.trailingAnchor.constraint(equalTo: view.trailingAnchor),
            scrollView.bottomAnchor.constraint(equalTo: view.bottomAnchor),

            stackView.topAnchor.constraint(equalTo: scrollView.topAnchor),
            stackView.leadingAnchor.constraint(equalTo: scrollView.leadingAnchor),
            stackView.trailingAnchor.constraint(equalTo: scrollView.trailingAnchor),
            stackView.bottomAnchor.constraint(equalTo: scrollView.bottomAnchor),
            stackView.widthAnchor.constraint(equalTo: scrollView.widthAnchor)
        ])
    }

    private func setupDynamicBanner() {
        dynamicBannerView = NestAdsDynamicBannerAdView(
            bannerSize: NestAdsAdSizeFluid,
            premiumDefaultSize: NestAdsAdSizeFluid,
            premiumExpandedSize: NestAdsAdSizeFluid
        )
        dynamicBannerView.placementCode = "YOUR_PLACEMENT_CODE"
        dynamicBannerView.delegate = self
        dynamicBannerView.imageBannerDelegate = self
        dynamicBannerView.premiumBannerDelegate = self

        // StackView에 추가 - SDK가 intrinsicContentSize를 제공하므로 자동 크기 조정
        stackView.addArrangedSubview(dynamicBannerView)
        dynamicBannerView.load(NestAdsAdRequest())
    }
}

// MARK: - NestAdsPremiumBannerAdViewDelegate
extension DynamicBannerScrollViewController: NestAdsPremiumBannerAdViewDelegate {
    func premiumAdViewDidExpand(_ adView: NestAdsPremiumBannerAdView) {
        // StackView는 자동 갱신되므로 별도 처리 불필요
    }

    func premiumAdViewExpandedRectInfoOnScrollView(_ adView: NestAdsPremiumBannerAdView, rect: CGRect) {
        var adjustedRect = rect
        adjustedRect.size.height += 20
        scrollView.scrollRectToVisible(adjustedRect, animated: true)
    }

    func premiumAdViewDidShrink(_ adView: NestAdsPremiumBannerAdView) {
        // StackView는 자동 갱신
    }

    // 나머지 필수 delegate 메서드 구현...
}

---

2. UICollectionView - FlowLayout

FlowLayout 사용 시 sizeForItemAt 델리게이트를 구현하여 셀 크기를 제공합니다.

Swift

class DynamicBannerFlowLayoutViewController: UIViewController {
    private var collectionView: UICollectionView!
    private var dynamicBannerView: NestAdsDynamicBannerAdView?

    override func viewDidLoad() {
        super.viewDidLoad()
        setupCollectionView()
        loadAd()
    }

    private func setupCollectionView() {
        let layout = UICollectionViewFlowLayout()
        layout.scrollDirection = .vertical
        layout.minimumLineSpacing = 16

        collectionView = UICollectionView(frame: .zero, collectionViewLayout: layout)
        collectionView.delegate = self
        collectionView.dataSource = self
        collectionView.register(DynamicBannerCell.self, forCellWithReuseIdentifier: "AdCell")

        view.addSubview(collectionView)
        collectionView.translatesAutoresizingMaskIntoConstraints = false
        NSLayoutConstraint.activate([
            collectionView.topAnchor.constraint(equalTo: view.safeAreaLayoutGuide.topAnchor),
            collectionView.leadingAnchor.constraint(equalTo: view.leadingAnchor),
            collectionView.trailingAnchor.constraint(equalTo: view.trailingAnchor),
            collectionView.bottomAnchor.constraint(equalTo: view.bottomAnchor)
        ])
    }

    private func loadAd() {
        let adView = NestAdsDynamicBannerAdView(
            bannerSize: NestAdsAdSizeFluid,
            premiumDefaultSize: NestAdsAdSizeFluid,
            premiumExpandedSize: NestAdsAdSizeFluid
        )
        adView.placementCode = "YOUR_PLACEMENT_CODE"
        adView.delegate = self
        adView.imageBannerDelegate = self
        adView.premiumBannerDelegate = self
        dynamicBannerView = adView
        adView.load(NestAdsAdRequest())
    }
}

// MARK: - UICollectionViewDataSource
extension DynamicBannerFlowLayoutViewController: UICollectionViewDataSource {
    func collectionView(_ collectionView: UICollectionView, numberOfItemsInSection section: Int) -> Int {
        return 1
    }

    func collectionView(_ collectionView: UICollectionView, cellForItemAt indexPath: IndexPath) -> UICollectionViewCell {
        let cell = collectionView.dequeueReusableCell(withReuseIdentifier: "AdCell", for: indexPath) as! DynamicBannerCell
        if let adView = dynamicBannerView {
            cell.setAdView(adView)
        }
        return cell
    }
}

// MARK: - UICollectionViewDelegateFlowLayout
extension DynamicBannerFlowLayoutViewController: UICollectionViewDelegateFlowLayout {
    func collectionView(_ collectionView: UICollectionView, layout collectionViewLayout: UICollectionViewLayout, sizeForItemAt indexPath: IndexPath) -> CGSize {
        let width = collectionView.bounds.width - 32
        if let adView = dynamicBannerView {
            let height = adView.intrinsicContentSize.height > 0 ? adView.intrinsicContentSize.height : 100
            return CGSize(width: width, height: height)
        }
        return CGSize(width: width, height: 100)
    }

    func collectionView(_ collectionView: UICollectionView, layout collectionViewLayout: UICollectionViewLayout, insetForSectionAt section: Int) -> UIEdgeInsets {
        return UIEdgeInsets(top: 16, left: 16, bottom: 16, right: 16)
    }
}

// MARK: - NestAdsDynamicBannerAdViewDelegate
extension DynamicBannerFlowLayoutViewController: NestAdsDynamicBannerAdViewDelegate {
    func dynamicBannerAdView(_ adView: NestAdsDynamicBannerAdView, didReceiveAdWithType responseType: String) {
        collectionView.collectionViewLayout.invalidateLayout()
    }

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

// MARK: - NestAdsPremiumBannerAdViewDelegate (PremiumBanner 응답 시)
extension DynamicBannerFlowLayoutViewController: NestAdsPremiumBannerAdViewDelegate {
    func premiumAdViewDidExpand(_ adView: NestAdsPremiumBannerAdView) {
        collectionView.collectionViewLayout.invalidateLayout()
    }

    func premiumAdViewExpandedRectInfoOnScrollView(_ adView: NestAdsPremiumBannerAdView, rect: CGRect) {
        var adjustedRect = rect
        adjustedRect.size.height += 20
        collectionView.scrollRectToVisible(adjustedRect, animated: true)
    }

    func premiumAdViewDidShrink(_ adView: NestAdsPremiumBannerAdView) {
        collectionView.collectionViewLayout.invalidateLayout()
    }

    // 나머지 필수 delegate 메서드 구현...
    func premiumAdViewDidReceiveAd(_ adView: NestAdsPremiumBannerAdView) {}
    func premiumAdView(_ adView: NestAdsPremiumBannerAdView, didFailToReceiveAdWithError error: NestAdsAdError) {}
    func premiumAdViewDidRecordImpressionOnDefaultView(_ adView: NestAdsPremiumBannerAdView) {}
    func premiumAdViewDidRecordImpressionOnExpandedView(_ adView: NestAdsPremiumBannerAdView) {}
    func premiumAdViewDidPerformClickOnDefaultView(_ adView: NestAdsPremiumBannerAdView) {}
    func premiumAdViewDidPerformClickOnExpandedView(_ adView: NestAdsPremiumBannerAdView) {}
    func premiumAdViewDidPerformClickOnCtaButton(_ adView: NestAdsPremiumBannerAdView) {}
    func premiumAdViewDidPerformClickOnHintAsset(_ adView: NestAdsPremiumBannerAdView) {}
    func premiumAdViewWillPresentScreen(_ adView: NestAdsPremiumBannerAdView) {}
    func premiumAdViewWillDismissScreen(_ adView: NestAdsPremiumBannerAdView) {}
    func premiumAdViewDidDismissScreen(_ adView: NestAdsPremiumBannerAdView) {}
    func didTapCtaButton(_ adView: NestAdsPremiumBannerAdView) {}
    func didTapAdvertiser(_ adView: NestAdsPremiumBannerAdView) {}
    func didTapAdProfile(_ adView: NestAdsPremiumBannerAdView) {}
    func expandedVideoDidCompletePreparation() {}
    func expandedVideoDidFailToLoadVideo(errorDescription: String) {}
    func expandedVideoDidPlayVideo() {}
    func expandedVideoDidPauseVideo() {}
    func expandedVideoDidEndVideoPlayback() {}
    func expandedVideoDidMuteVideo() {}
    func expandedVideoDidUnmuteVideo() {}
    func expandedVideoDidUpdateVideoProgress(current: TimeInterval) {}
}

// MARK: - Cell
class DynamicBannerCell: UICollectionViewCell {
    private weak var adView: UIView?

    func setAdView(_ view: UIView) {
        // 같은 뷰면 스킵
        if adView === view { return }

        adView?.removeFromSuperview()
        adView = view
        view.translatesAutoresizingMaskIntoConstraints = false
        contentView.addSubview(view)

        NSLayoutConstraint.activate([
            view.topAnchor.constraint(equalTo: contentView.topAnchor),
            view.leadingAnchor.constraint(equalTo: contentView.leadingAnchor),
            view.trailingAnchor.constraint(equalTo: contentView.trailingAnchor),
            view.bottomAnchor.constraint(equalTo: contentView.bottomAnchor)
        ])
    }
}

---

3. UICollectionView - CompositionalLayout

CompositionalLayout 사용 시 estimated 높이를 사용하여 Self-Sizing을 활성화합니다.

Swift

class DynamicBannerCompositionalViewController: UIViewController {
    private var collectionView: UICollectionView!
    private var dynamicBannerView: NestAdsDynamicBannerAdView?

    override func viewDidLoad() {
        super.viewDidLoad()
        setupCollectionView()
        loadAd()
    }

    private func setupCollectionView() {
        let layout = createLayout()
        collectionView = UICollectionView(frame: .zero, collectionViewLayout: layout)
        collectionView.delegate = self
        collectionView.dataSource = self
        collectionView.register(DynamicBannerCell.self, forCellWithReuseIdentifier: "AdCell")

        view.addSubview(collectionView)
        collectionView.translatesAutoresizingMaskIntoConstraints = false
        NSLayoutConstraint.activate([
            collectionView.topAnchor.constraint(equalTo: view.safeAreaLayoutGuide.topAnchor),
            collectionView.leadingAnchor.constraint(equalTo: view.leadingAnchor),
            collectionView.trailingAnchor.constraint(equalTo: view.trailingAnchor),
            collectionView.bottomAnchor.constraint(equalTo: view.bottomAnchor)
        ])
    }

    private func createLayout() -> UICollectionViewLayout {
        let layout = UICollectionViewCompositionalLayout { sectionIndex, _ in
            // Self-sizing을 위해 estimated 높이 사용
            let itemSize = NSCollectionLayoutSize(
                widthDimension: .fractionalWidth(1.0),
                heightDimension: .estimated(100)
            )
            let item = NSCollectionLayoutItem(layoutSize: itemSize)

            let groupSize = NSCollectionLayoutSize(
                widthDimension: .fractionalWidth(1.0),
                heightDimension: .estimated(100)
            )
            let group = NSCollectionLayoutGroup.vertical(layoutSize: groupSize, subitems: [item])

            let section = NSCollectionLayoutSection(group: group)
            section.interGroupSpacing = 16
            section.contentInsets = NSDirectionalEdgeInsets(top: 16, leading: 0, bottom: 16, trailing: 0)

            return section
        }
        return layout
    }

    private func loadAd() {
        let adView = NestAdsDynamicBannerAdView(
            bannerSize: NestAdsAdSizeFluid,
            premiumDefaultSize: NestAdsAdSizeFluid,
            premiumExpandedSize: NestAdsAdSizeFluid
        )
        adView.placementCode = "YOUR_PLACEMENT_CODE"
        adView.delegate = self
        adView.imageBannerDelegate = self
        adView.premiumBannerDelegate = self
        dynamicBannerView = adView
        adView.load(NestAdsAdRequest())
    }
}

// MARK: - UICollectionViewDataSource
extension DynamicBannerCompositionalViewController: UICollectionViewDataSource {
    func collectionView(_ collectionView: UICollectionView, numberOfItemsInSection section: Int) -> Int {
        return 1
    }

    func collectionView(_ collectionView: UICollectionView, cellForItemAt indexPath: IndexPath) -> UICollectionViewCell {
        let cell = collectionView.dequeueReusableCell(withReuseIdentifier: "AdCell", for: indexPath) as! DynamicBannerCell
        if let adView = dynamicBannerView {
            cell.setAdView(adView)
        }
        return cell
    }
}

// MARK: - NestAdsDynamicBannerAdViewDelegate
extension DynamicBannerCompositionalViewController: NestAdsDynamicBannerAdViewDelegate {
    func dynamicBannerAdView(_ adView: NestAdsDynamicBannerAdView, didReceiveAdWithType responseType: String) {
        collectionView.collectionViewLayout.invalidateLayout()
    }

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

// MARK: - NestAdsPremiumBannerAdViewDelegate
extension DynamicBannerCompositionalViewController: NestAdsPremiumBannerAdViewDelegate {
    func premiumAdViewDidExpand(_ adView: NestAdsPremiumBannerAdView) {
        // CompositionalLayout 갱신
        collectionView.collectionViewLayout.invalidateLayout()
    }

    func premiumAdViewExpandedRectInfoOnScrollView(_ adView: NestAdsPremiumBannerAdView, rect: CGRect) {
        var adjustedRect = rect
        adjustedRect.size.height += 20
        collectionView.scrollRectToVisible(adjustedRect, animated: true)
    }

    func premiumAdViewDidShrink(_ adView: NestAdsPremiumBannerAdView) {
        collectionView.collectionViewLayout.invalidateLayout()
    }

    // 나머지 필수 delegate 메서드 구현...
}

// DynamicBannerCell은 위 FlowLayout 예제와 동일

---

4. UITableView

TableView 사용 시 automaticDimension을 활용합니다.

Swift

class DynamicBannerTableViewController: UIViewController {
    private var tableView: UITableView!
    private var dynamicBannerView: NestAdsDynamicBannerAdView?

    override func viewDidLoad() {
        super.viewDidLoad()
        setupTableView()
        loadAd()
    }

    private func setupTableView() {
        tableView = UITableView(frame: .zero, style: .plain)
        tableView.delegate = self
        tableView.dataSource = self
        tableView.separatorStyle = .none
        // Self-sizing을 위한 설정
        tableView.estimatedRowHeight = 100
        tableView.rowHeight = UITableView.automaticDimension
        tableView.register(DynamicBannerTableCell.self, forCellReuseIdentifier: "AdCell")

        view.addSubview(tableView)
        tableView.translatesAutoresizingMaskIntoConstraints = false
        NSLayoutConstraint.activate([
            tableView.topAnchor.constraint(equalTo: view.safeAreaLayoutGuide.topAnchor),
            tableView.leadingAnchor.constraint(equalTo: view.leadingAnchor),
            tableView.trailingAnchor.constraint(equalTo: view.trailingAnchor),
            tableView.bottomAnchor.constraint(equalTo: view.bottomAnchor)
        ])
    }

    private func loadAd() {
        let adView = NestAdsDynamicBannerAdView(
            bannerSize: NestAdsAdSizeFluid,
            premiumDefaultSize: NestAdsAdSizeFluid,
            premiumExpandedSize: NestAdsAdSizeFluid
        )
        adView.placementCode = "YOUR_PLACEMENT_CODE"
        adView.delegate = self
        adView.imageBannerDelegate = self
        adView.premiumBannerDelegate = self
        dynamicBannerView = adView
        adView.load(NestAdsAdRequest())
    }
}

// MARK: - UITableViewDataSource
extension DynamicBannerTableViewController: UITableViewDataSource {
    func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
        return 1
    }

    func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
        let cell = tableView.dequeueReusableCell(withIdentifier: "AdCell", for: indexPath) as! DynamicBannerTableCell
        if let adView = dynamicBannerView {
            cell.setAdView(adView)
        }
        return cell
    }
}

// MARK: - NestAdsDynamicBannerAdViewDelegate
extension DynamicBannerTableViewController: NestAdsDynamicBannerAdViewDelegate {
    func dynamicBannerAdView(_ adView: NestAdsDynamicBannerAdView, didReceiveAdWithType responseType: String) {
        tableView.reloadData()
    }

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

// MARK: - NestAdsPremiumBannerAdViewDelegate
extension DynamicBannerTableViewController: NestAdsPremiumBannerAdViewDelegate {
    func premiumAdViewDidExpand(_ adView: NestAdsPremiumBannerAdView) {
        // TableView 레이아웃 갱신
        tableView.beginUpdates()
        tableView.endUpdates()
    }

    func premiumAdViewExpandedRectInfoOnScrollView(_ adView: NestAdsPremiumBannerAdView, rect: CGRect) {
        var adjustedRect = rect
        adjustedRect.size.height += 20
        tableView.scrollRectToVisible(adjustedRect, animated: true)
    }

    func premiumAdViewDidShrink(_ adView: NestAdsPremiumBannerAdView) {
        tableView.beginUpdates()
        tableView.endUpdates()
    }

    // 나머지 필수 delegate 메서드 구현...
}

// MARK: - Cell
class DynamicBannerTableCell: UITableViewCell {
    private weak var adView: UIView?

    override init(style: UITableViewCell.CellStyle, reuseIdentifier: String?) {
        super.init(style: style, reuseIdentifier: reuseIdentifier)
        selectionStyle = .none
    }

    required init?(coder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }

    func setAdView(_ view: UIView) {
        // 같은 뷰면 스킵
        if adView === view { return }

        adView?.removeFromSuperview()
        adView = view
        view.translatesAutoresizingMaskIntoConstraints = false
        contentView.addSubview(view)

        NSLayoutConstraint.activate([
            view.topAnchor.constraint(equalTo: contentView.topAnchor, constant: 8),
            view.leadingAnchor.constraint(equalTo: contentView.leadingAnchor, constant: 16),
            view.trailingAnchor.constraint(equalTo: contentView.trailingAnchor, constant: -16),
            view.bottomAnchor.constraint(equalTo: contentView.bottomAnchor, constant: -8)
        ])
    }
}

---

핵심 포인트

NestAdsAdSizeFluid 사용 필수

Dynamic Banner의 premiumDefaultSize와 premiumExpandedSize에 반드시 NestAdsAdSizeFluid를 사용하세요. 고정 크기를 사용하면 PremiumBanner 응답 시 레이아웃이 올바르게 작동하지 않을 수 있습니다.

// 올바른 사용법
NestAdsDynamicBannerAdView(
    bannerSize: NestAdsAdSizeFluid,
    premiumDefaultSize: NestAdsAdSizeFluid,      // Fluid 사용
    premiumExpandedSize: NestAdsAdSizeFluid      // Fluid 사용
)

PremiumBanner 응답 시 레이아웃 갱신 필수

Dynamic Banner가 PremiumBanner로 응답할 경우, 확장/축소 시 레이아웃 갱신이 필요합니다:

• ScrollView/StackView: 자동 갱신 (SDK가 intrinsicContentSize 제공)

• CollectionView: collectionView.collectionViewLayout.invalidateLayout()

• TableView: tableView.beginUpdates() / tableView.endUpdates()

스크롤 위치 조정

premiumBannerDelegate를 설정하고 premiumAdViewExpandedRectInfoOnScrollView(_:rect:) 메서드를 구현하여 확장된 배너가 화면에 보이도록 스크롤 위치를 조정합니다.

Cell 구현 시 주의사항

CollectionView/TableView Cell에서 AdView를 설정할 때:

• 같은 뷰인지 체크하여 중복 추가 방지 (if adView === view { return })

• AdView를 contentView에 edge constraints로 추가

---

광고 델리게이트

NestAdsDynamicBannerAdView에서 지원하는 광고 델리게이트는 다음을 참고하세요.

• NestAdsDynamicBannerAdViewDelegate - 공통 광고 로드 이벤트

• NestAdsImageBannerAdViewDelegate - 이미지 배너 전용 이벤트

• NestAdsPremiumBannerAdViewDelegate - 프리미엄 배너 전용 이벤트

---

광고 옵션

NestAdsDynamicBannerAdView에서 지원하는 광고 옵션은 다음을 참고하세요.

• NestAdsBannerBackgroundOptions - 이미지 배너 배경 옵션

• NestAdsBannerLayoutOptions - 이미지 배너 레이아웃 옵션

• NestAdsPremiumBannerAdViewOptions - 프리미엄 배너 옵션

• NestAdsAdSize - 광고 사이즈

---

Reference

• NestAdsDynamicBannerAdView

• NestAdsDynamicBannerAdViewDelegate

• NestAdsImageBannerAdView

• NestAdsPremiumBannerAdView