NestAdsRichPopupAdView

이미지 및 비디오 크리에이티브를 지원하는 리치 팝업 광고 뷰입니다.

open class NestAdsRichPopupAdView : UIView

이미지, 비디오, 또는 이미지+비디오(인터랙티브) 크리에이티브를 지원하며 카운트다운 기능을 포함한 리치 팝업 광고 뷰입니다.

Delegate

weak open var delegate: (any NestAdsRichPopupAdViewDelegate)?

리치 팝업 광고 이벤트를 수신하는 델리게이트입니다.

---

Public Variables

open var placementCode: String?

게재위치 코드

---

open var options: NestAdsRichPopupOptions

리치 팝업의 외관 및 동작을 커스터마이징하는 옵션입니다.

default: NestAdsRichPopupOptions()

---

open private(set) var adInfo: NestAdsAdInfo? { get }

광고의 광고 정보. 광고상품ID, 캠페인ID, 광고그룹ID, 광고ID를 반환합니다.

광고 로드 성공 후 사용 가능합니다.

---

open private(set) var videoController: NestAdsVideoController? { get }

비디오 크리에이티브용 비디오 컨트롤러입니다.

비디오 크리에이티브가 포함된 광고 로드 후 사용 가능합니다.

---

Public Methods

public override init(frame: CGRect)

NestAdsRichPopupAdView를 생성합니다.

매개변수	설명
frame	뷰의 프레임 (일반적으로 .zero 사용)

---

open func load(_ request: NestAdsAdRequest?)

리치 팝업 광고를 로드합니다.

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

---

open func setVideoCallback(_ callback: NestAdsVideoLifecycleCallbacks?)

비디오 생명주기 이벤트를 수신하기 위한 콜백을 설정합니다.

매개변수	설명
callback	비디오 생명주기 이벤트를 수신할 콜백 객체

비디오 크리에이티브가 포함된 광고에서만 콜백이 호출됩니다.

---

open func hasVideoContent() -> Bool

로드된 광고에 비디오 콘텐츠가 포함되어 있는지 확인합니다.

반환값	설명
Bool	비디오 콘텐츠 포함 여부 (VIDEO 또는 INTERACTIVE 타입)

---

open func show(from viewController: UIViewController)

리치 팝업 광고를 표시합니다.

매개변수	설명
viewController	팝업을 표시할 뷰 컨트롤러

광고 로드가 완료된 후에만 호출해야 합니다. 로드되지 않은 상태에서 호출 시 richPopupAdViewDidFailToShow(_:) 델리게이트 메서드가 호출됩니다.

---

open func dismiss()

리치 팝업 광고를 닫습니다.

---

광고 타입

리치 팝업은 다음 세 가지 타입의 크리에이티브를 지원합니다:

• RICH_POPUP_IMAGE: 이미지만 포함

• RICH_POPUP_VIDEO: 비디오만 포함

• RICH_POPUP_INTERACTIVE: 이미지 + 비디오 모두 포함

광고 타입은 서버에서 결정되며, SDK는 자동으로 적절한 크리에이티브를 표시합니다.

---

사용 예시

import UIKit
import NestAdsSDK

class ViewController: UIViewController {
    private var richPopupAdView: NestAdsRichPopupAdView!

    override func viewDidLoad() {
        super.viewDidLoad()

        // RichPopupAdView 생성
        richPopupAdView = NestAdsRichPopupAdView(frame: .zero)

        // 게재위치 설정
        richPopupAdView.placementCode = "SAMPLE_RICH_VIDEO/720/1280"

        // 델리게이트 설정
        richPopupAdView.delegate = self

        // CTA 버튼 옵션 설정
        let buttonOptions = NestAdsButtonOptions(
            backgroundColor: UIColor(red: 0, green: 0, blue: 0, alpha: 0.8),
            fontColor: .white,
            fontSize: 14,
            opacity: 0.9
        )

        // 비디오 옵션 설정
        let videoOptions = NestAdsStandardVideoOptions(
            startMuted: true,
            playCondition: .autoStart,
            progressBarColor: .white,
            muteButtonColor: .white
        )

        // 리치 팝업 옵션 설정
        richPopupAdView.options = NestAdsRichPopupOptions(
            backgroundColor: .black,
            closeButtonColor: .white,
            mediaSizeType: .fluid,
            buttonOptions: buttonOptions,
            videoOptions: videoOptions
        )

        // 비디오 콜백 설정
        richPopupAdView.setVideoCallback(VideoCallbacks())

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

extension ViewController: NestAdsRichPopupAdViewDelegate {
    func richPopupAdViewDidReceiveAd(_ adView: NestAdsRichPopupAdView) {
        print("광고 로드 성공")

        // 비디오 콘텐츠 포함 여부 확인
        if adView.hasVideoContent() {
            print("비디오 크리에이티브 포함")
        }

        // 광고 표시
        adView.show(from: self)
    }

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

    func richPopupAdViewDidShowAd(_ adView: NestAdsRichPopupAdView) {
        print("광고 표시됨")
    }

    func richPopupAdViewDidDismissAd(_ adView: NestAdsRichPopupAdView) {
        print("광고 닫힘")
    }

    func richPopupAdViewDidRecordImpression(
        _ adView: NestAdsRichPopupAdView,
        adInfo: NestAdsAdInfo
    ) {
        print("광고 노출: 광고ID=\(adInfo.adID)")
    }

    func richPopupAdViewDidClickCtaButton(_ adView: NestAdsRichPopupAdView) {
        print("CTA 버튼 클릭")
    }

    func richPopupAdViewCountdownDidFinish(_ adView: NestAdsRichPopupAdView) {
        print("카운트다운 완료")
    }

    func richPopupAdViewVideoDidStart(_ adView: NestAdsRichPopupAdView) {
        print("비디오 시작")
    }

    func richPopupAdViewVideoDidComplete(_ adView: NestAdsRichPopupAdView) {
        print("비디오 완료")
    }
}

// 비디오 생명주기 콜백
class VideoCallbacks: NestAdsVideoLifecycleCallbacks {
    override func onVideoStart() {
        print("VideoCallback: 비디오 시작")
    }

    override func onVideoPlay() {
        print("VideoCallback: 비디오 재생")
    }

    override func onVideoPause() {
        print("VideoCallback: 비디오 일시정지")
    }

    override func onVideoEnd() {
        print("VideoCallback: 비디오 종료")
    }

    override func onVideoMute(muted: Bool) {
        print("VideoCallback: 음소거 변경 - \(muted)")
    }

    override func onVideoSeekProcessed(current: Int64) {
        print("VideoCallback: 재생 위치 - \(current)ms")
    }
}

---

참고

• NestAdsRichPopupAdViewDelegate

• NestAdsRichPopupOptions

• NestAdsVideoLifecycleCallbacks