프리미엄 배너 광고

아래 가이드에서는 프리미엄 배너 광고를 로드하고, 표시하는 방법을 설명합니다.

기본 요건

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

테스트 광고 게재위치

Placement Code(게재위치 코드)는 어드민의 인벤토리 > 게재위치 메뉴에서 게재위치를 등록 시 시스템을 통해 자동으로 생성됩니다.

테스트 게재위치 목록

placementCode

설명

SAMPLE_EXPANDABLE_BANNER_IMAGE_APP

Mobile 화면을 위한 확장형 이미지 광고

확장형 형태: 가로형
확장형 표시 방법: 배너 덮음
확장형 위치: 배너 하단
레이아웃: 3

SAMPLE_EXPANDABLE_BANNER_VIDEO_APP

Mobile 화면을 위한 확장형 동영상 광고

확장형 형태: 가로형
확장형 표시 방법: 배너 덮음
확장형 위치: 배너 하단
레이아웃: 3

광고 상품 설정하기

어드민의 인벤토리 > 광고상품 메뉴에서 프리미엄 배너 광고 설정을 할 수 있습니다.

광고 구성 정보 섹션에서 광고 종류 > 프리미엄 배너 광고 > 확장형 배너 동영상형 / 확장형 배너 이미지형을 선택합니다.
각 미디어 스펙의 미디어 표시명 및 옵션들을 선택합니다.

게재위치 및 사이즈 섹션에서 레이아웃을 선택할 수 있습니다.

광고 표시하기

프리미엄 배너가 표시되기 원하는 ViewController 에서 NestAdsPremiumBannerAdView 를 생성합니다.
(필수) 게재위치를 설정합니다.
(옵션) delegate 및 스타일, 동영상 등 미디어 스펙 별 옵션을 설정합니다.
광고 요청 객체를 만들고 광고를 요청합니다.

class TestViewController: UIViewController {
  ...
  lazy var premiumBannerAdView: NestAdsPremiumBannerAdView!

  override func viewDidLoad() {

    // 확장 전 배너, 확장 후 배너의 사이즈를 넣어 초기화
    premiumBannerAdView = NestAdsPremiumBannerAdView(
        defaultBannerAdSize: NestAdsAdSizeFluid,
        expandedBannerAdSize: NestAdsAdSizeFluid)

    // 게재위치 및 delegate 설정
    premiumBannerAdView.placementCode = "SAMPLE_EXPANDABLE_BANNER_VIDEO_APP"
    premiumBannerAdView.delegate = self

    // (선택) 확장 전 배너의 옵션 설정
    premiumBannerAdView.defaultBannerOptions = NestAdsPremiumAdDefaultBannerOptions(...)

    // (선택) 확장 후 배너의 옵션 설정
    premiumBannerAdView.expandedBannerOptions = NestAdsPremiumAdExpandedBannerOptions(...)

    // 동영상, 힌트 에셋, 광고 문구, CTA 버튼 등 미디어 스펙별로 다양하게 옵션을 넣어줄 수 있습니다.
    // premiumBannerAdView.expandedBannerVideoOptions= NestAdsPremiumAdExpandedBannerVideoOptions(..)


    // 광고를 요청합니다.
    premiumBannerAdView.load(NestAdsAdRequest(...))

  }
  ...
}


// delegate 선언부
extension TestViewController: NestAdsPremiumBannerAdViewDelegate {
  func premiumAdViewDidExpand(_ adView: NestAdsPremiumBannerAdView) {
    // 배너가 확장되면 할 행동 정의
  }
  ...
}

Mobile 환경에서는 변동 사이즈(NestAdsAdSizeFluid)를 넣는 걸 권장하며, 고정 사이즈를 넣을 땐 확장 전,후의 가로 사이즈를 똑같이 설정하는 것을 권장합니다.

위 예제 코드를 실행하면 아래와 같이 프리미엄 배너를 게재할 수 있습니다.

레이아웃별 구현 가이드

프리미엄 배너는 확장/축소 기능이 있어 각 레이아웃에서 적절한 처리가 필요합니다.

1. StackView + ScrollView

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

class PremiumBannerViewController: UIViewController {
    private var scrollView: UIScrollView!
    private var stackView: UIStackView!
    private var premiumBannerAdView: NestAdsPremiumBannerAdView!

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

    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 setupPremiumBanner() {
        premiumBannerAdView = NestAdsPremiumBannerAdView(
            defaultBannerAdSize: NestAdsAdSizeFluid,
            expandedBannerAdSize: NestAdsAdSizeFluid
        )
        premiumBannerAdView.placementCode = "YOUR_PLACEMENT_CODE"
        premiumBannerAdView.delegate = self

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

extension PremiumBannerViewController: NestAdsPremiumBannerAdViewDelegate {
    func premiumAdViewDidReceiveAd(_ adView: NestAdsPremiumBannerAdView) {
        print("광고 로드 성공")
    }

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

    func premiumAdViewDidExpand(_ adView: NestAdsPremiumBannerAdView) {
        print("배너 확장됨")
        // StackView는 자동 갱신되므로 별도 처리 불필요
    }

    func premiumAdViewExpandedRectInfoOnScrollView(_ adView: NestAdsPremiumBannerAdView, rect: CGRect) {
        // 확장된 배너가 화면에 보이도록 스크롤
        var adjustedRect = rect
        adjustedRect.size.height += 20  // 여유 공간
        scrollView.scrollRectToVisible(adjustedRect, animated: true)
    }

    func premiumAdViewDidShrink(_ adView: NestAdsPremiumBannerAdView) {
        print("배너 축소됨")
    }

    // 나머지 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) {}
}

2. UICollectionView - FlowLayout

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

class PremiumBannerFlowLayoutViewController: UIViewController {
    private var collectionView: UICollectionView!
    private var premiumBannerAdView: NestAdsPremiumBannerAdView?

    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(PremiumBannerCell.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 = NestAdsPremiumBannerAdView(
            defaultBannerAdSize: NestAdsAdSizeFluid,
            expandedBannerAdSize: NestAdsAdSizeFluid
        )
        adView.placementCode = "YOUR_PLACEMENT_CODE"
        adView.delegate = self
        premiumBannerAdView = adView
        adView.load(NestAdsAdRequest())
    }
}

// MARK: - UICollectionViewDataSource
extension PremiumBannerFlowLayoutViewController: 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! PremiumBannerCell
        if let adView = premiumBannerAdView {
            cell.setAdView(adView)
        }
        return cell
    }
}

// MARK: - UICollectionViewDelegateFlowLayout
extension PremiumBannerFlowLayoutViewController: UICollectionViewDelegateFlowLayout {
    func collectionView(_ collectionView: UICollectionView, layout collectionViewLayout: UICollectionViewLayout, sizeForItemAt indexPath: IndexPath) -> CGSize {
        let width = collectionView.bounds.width - 32  // 좌우 여백
        if let adView = premiumBannerAdView {
            // SDK의 intrinsicContentSize를 사용하여 높이 계산
            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: - NestAdsPremiumBannerAdViewDelegate
extension PremiumBannerFlowLayoutViewController: NestAdsPremiumBannerAdViewDelegate {
    func premiumAdViewDidReceiveAd(_ adView: NestAdsPremiumBannerAdView) {
        collectionView.collectionViewLayout.invalidateLayout()
    }

    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 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 PremiumBannerCell: 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을 활성화합니다.

class PremiumBannerCompositionalViewController: UIViewController {
    private var collectionView: UICollectionView!
    private var premiumBannerAdView: NestAdsPremiumBannerAdView?

    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(PremiumBannerCell.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 = NestAdsPremiumBannerAdView(
            defaultBannerAdSize: NestAdsAdSizeFluid,
            expandedBannerAdSize: NestAdsAdSizeFluid
        )
        adView.placementCode = "YOUR_PLACEMENT_CODE"
        adView.delegate = self
        premiumBannerAdView = adView
        adView.load(NestAdsAdRequest())
    }
}

// MARK: - UICollectionViewDataSource
extension PremiumBannerCompositionalViewController: 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! PremiumBannerCell
        if let adView = premiumBannerAdView {
            cell.setAdView(adView)
        }
        return cell
    }
}

// MARK: - NestAdsPremiumBannerAdViewDelegate
extension PremiumBannerCompositionalViewController: NestAdsPremiumBannerAdViewDelegate {
    func premiumAdViewDidReceiveAd(_ adView: NestAdsPremiumBannerAdView) {
        collectionView.collectionViewLayout.invalidateLayout()
    }

    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 메서드 구현...
    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) {}
}

// PremiumBannerCell은 위 FlowLayout 예제와 동일

4. UITableView

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

class PremiumBannerTableViewController: UIViewController {
    private var tableView: UITableView!
    private var premiumBannerAdView: NestAdsPremiumBannerAdView?

    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(PremiumBannerTableCell.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 = NestAdsPremiumBannerAdView(
            defaultBannerAdSize: NestAdsAdSizeFluid,
            expandedBannerAdSize: NestAdsAdSizeFluid
        )
        adView.placementCode = "YOUR_PLACEMENT_CODE"
        adView.delegate = self
        premiumBannerAdView = adView
        adView.load(NestAdsAdRequest())
    }
}

// MARK: - UITableViewDataSource
extension PremiumBannerTableViewController: 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! PremiumBannerTableCell
        if let adView = premiumBannerAdView {
            cell.setAdView(adView)
        }
        return cell
    }
}

// MARK: - NestAdsPremiumBannerAdViewDelegate
extension PremiumBannerTableViewController: NestAdsPremiumBannerAdViewDelegate {
    func premiumAdViewDidReceiveAd(_ adView: NestAdsPremiumBannerAdView) {
        tableView.reloadData()
    }

    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 메서드 구현...
    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 PremiumBannerTableCell: 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)
        ])
    }
}

핵심 포인트

확장/축소 시 레이아웃 갱신 필수

프리미엄 배너가 확장되거나 축소될 때 반드시 레이아웃을 갱신해야 합니다:

ScrollView/StackView: 자동 갱신 (SDK가 intrinsicContentSize 제공)
CollectionView: collectionView.collectionViewLayout.invalidateLayout()
TableView: tableView.beginUpdates() / tableView.endUpdates()

스크롤 위치 조정

premiumAdViewExpandedRectInfoOnScrollView(_:rect:) 델리게이트를 구현하여 확장된 배너가 화면에 보이도록 스크롤 위치를 조정합니다.

Cell 구현 시 주의사항

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

같은 뷰인지 체크하여 중복 추가 방지 (if adView === view { return })
AdView를 contentView에 edge constraints로 추가

광고 delegate

NestAdsPremiumBannerAdView 에서 지원하는 delegate는 다음을 참고하세요.

NestAdsPremiumBannerAdViewDelegate

광고 옵션

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

각 미디어 스펙 별로 다양하게 옵션을 설정 할 수 있습니다.

NestAdsPremiumBannerAdViewOptions

광고 요청

NestAdsPremiumBannerAdView 에서 사용하는 광고 요청 객체는 다음을 참고하세요.

NestAdsAdRequest

Previous리치 팝업 광고 Next커스텀형 광고

Last updated 9 days ago

hashtag기본 요건

hashtag테스트 광고 게재위치

hashtag광고 상품 설정하기

hashtag광고 표시하기

hashtag레이아웃별 구현 가이드

hashtag1. StackView + ScrollView

hashtag2. UICollectionView - FlowLayout

hashtag3. UICollectionView - CompositionalLayout

hashtag4. UITableView

hashtag핵심 포인트

hashtag광고 delegate

hashtag광고 옵션

hashtag광고 요청

기본 요건

테스트 광고 게재위치

광고 상품 설정하기

광고 표시하기

레이아웃별 구현 가이드

1. StackView + ScrollView

2. UICollectionView - FlowLayout

3. UICollectionView - CompositionalLayout

4. UITableView

핵심 포인트

광고 delegate

광고 옵션

광고 요청