NestAdsRichPopupAdViewDelegate

public protocol NestAdsRichPopupAdViewDelegate : AnyObject

리치 팝업 광고의 이벤트를 수신하는 프로토콜입니다.

모든 델리게이트 메서드는 기본 구현이 제공되므로, 필요한 메서드만 구현하면 됩니다.

Load Events

func richPopupAdViewDidReceiveAd(_ adView: NestAdsRichPopupAdView)

광고가 성공적으로 로드되었을 때 호출됩니다.

매개변수	설명
adView	RichPopupAdView 인스턴스

---

func richPopupAdView(_ adView: NestAdsRichPopupAdView, didFailToReceiveAdWithError error: NestAdsAdError)

광고 로드에 실패했을 때 호출됩니다.

매개변수	설명
adView	RichPopupAdView 인스턴스
error	에러 정보

---

Show Events

func richPopupAdViewDidShowAd(_ adView: NestAdsRichPopupAdView)

광고가 화면에 표시되었을 때 호출됩니다.

매개변수	설명
adView	RichPopupAdView 인스턴스

---

func richPopupAdViewDidDismissAd(_ adView: NestAdsRichPopupAdView)

광고가 닫혔을 때 호출됩니다.

매개변수	설명
adView	RichPopupAdView 인스턴스

---

func richPopupAdViewDidFailToShow(_ adView: NestAdsRichPopupAdView)

광고 표시에 실패했을 때 호출됩니다.

매개변수	설명
adView	RichPopupAdView 인스턴스

---

Impression and Click Events

func richPopupAdViewDidRecordImpression(_ adView: NestAdsRichPopupAdView, adInfo: NestAdsAdInfo)

광고 노출이 기록되었을 때 호출됩니다.

매개변수	설명
adView	RichPopupAdView 인스턴스
adInfo	광고 정보 (광고상품ID, 캠페인ID, 광고그룹ID, 광고ID)

---

func richPopupAdViewDidRecordClick(_ adView: NestAdsRichPopupAdView, adInfo: NestAdsAdInfo)

광고 클릭이 기록되었을 때 호출됩니다.

매개변수	설명
adView	RichPopupAdView 인스턴스
adInfo	광고 정보

---

Rich Popup Specific Events

func richPopupAdViewDidClickCtaButton(_ adView: NestAdsRichPopupAdView)

CTA(Call-to-Action) 버튼이 클릭되었을 때 호출됩니다.

매개변수	설명
adView	RichPopupAdView 인스턴스

---

func richPopupAdViewDidClickMedia(_ adView: NestAdsRichPopupAdView)

미디어 영역(이미지 또는 비디오)이 클릭되었을 때 호출됩니다.

매개변수	설명
adView	RichPopupAdView 인스턴스

---

func richPopupAdViewCountdownDidFinish(_ adView: NestAdsRichPopupAdView)

카운트다운이 완료되었을 때 호출됩니다.

매개변수	설명
adView	RichPopupAdView 인스턴스

카운트다운 기능이 활성화된 광고에서만 호출됩니다.

---

Screen Transition Events

func richPopupAdViewWillPresentScreen(_ adView: NestAdsRichPopupAdView)

랜딩 URL을 열기 직전에 호출됩니다.

매개변수	설명
adView	RichPopupAdView 인스턴스

---

func richPopupAdViewDidPresentScreen(_ adView: NestAdsRichPopupAdView)

랜딩 URL이 성공적으로 열린 후 호출됩니다.

매개변수	설명
adView	RichPopupAdView 인스턴스

---

Video Events

func richPopupAdViewVideoDidBecomeReady(_ adView: NestAdsRichPopupAdView)

비디오가 재생 준비되었을 때 호출됩니다.

매개변수	설명
adView	RichPopupAdView 인스턴스

---

func richPopupAdViewVideoDidStart(_ adView: NestAdsRichPopupAdView)

비디오가 처음 재생을 시작했을 때 호출됩니다.

매개변수	설명
adView	RichPopupAdView 인스턴스

이 메서드는 비디오의 첫 재생 시에만 호출됩니다. 일시정지 후 재개 시에는 richPopupAdViewVideoDidPlay(_:)가 호출됩니다.

---

func richPopupAdViewVideoDidPlay(_ adView: NestAdsRichPopupAdView)

비디오가 재생 중일 때 호출됩니다 (재개 포함).

매개변수	설명
adView	RichPopupAdView 인스턴스

---

func richPopupAdViewVideoDidPause(_ adView: NestAdsRichPopupAdView)

비디오가 일시정지되었을 때 호출됩니다.

매개변수	설명
adView	RichPopupAdView 인스턴스

---

func richPopupAdViewVideoDidComplete(_ adView: NestAdsRichPopupAdView)

비디오 재생이 완료되었을 때 호출됩니다.

매개변수	설명
adView	RichPopupAdView 인스턴스

---

func richPopupAdViewVideoDidChangeMute(_ adView: NestAdsRichPopupAdView, muted: Bool)

비디오의 음소거 상태가 변경되었을 때 호출됩니다.

매개변수	설명
adView	RichPopupAdView 인스턴스
muted	음소거 여부 (true: 음소거, false: 음소거 해제)

---

func richPopupAdViewVideoDidUpdateProgress(_ adView: NestAdsRichPopupAdView, currentTime: TimeInterval)

비디오 재생 진행 상태가 업데이트될 때 호출됩니다.

매개변수	설명
adView	RichPopupAdView 인스턴스
currentTime	현재 재생 시간 (초)

---

func richPopupAdViewVideoDidFailToLoad(_ adView: NestAdsRichPopupAdView)

비디오 로드에 실패했을 때 호출됩니다.

매개변수	설명
adView	RichPopupAdView 인스턴스

---

사용 예시

extension ViewController: NestAdsRichPopupAdViewDelegate {
    func richPopupAdViewDidReceiveAd(_ adView: NestAdsRichPopupAdView) {
        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("비디오 완료")
    }
}