광고 응답 기반 설정

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

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

개요

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

이 방식을 사용하면:

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

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

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

---

기본 요건

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

---

광고 표시하기

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

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

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

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

5. (옵션) 광고 리스너를 설정합니다.

6. 광고를 로드합니다.

// 1. NestAdsDynamicBannerAdView를 생성합니다.
// 기본 adSize는 NestAdsAdSize.FLUID 입니다.
val dynamicBannerAdView = NestAdsDynamicBannerAdView(this)

// adSize를 지정하려면 생성자에 전달합니다.
// val dynamicBannerAdView = NestAdsDynamicBannerAdView(this, NestAdsAdSize(320, 100))

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

// 3. (옵션) 이미지 배너 옵션을 설정합니다.
// 이미지 배너가 로드될 경우 적용됩니다.
dynamicBannerAdView.imageBannerOptions = NestAdsImageOptions.Builder()
    .setBackgroundColor("#80FFFF00") // 노란색, 50% 투명도
    .setRadius(8f)
    .build()

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

// 4. (옵션) 프리미엄 배너 옵션을 설정합니다.
// 프리미엄 배너가 로드될 경우 적용됩니다.
dynamicBannerAdView.expandableAdSize = NestAdsAdSize.FLUID
dynamicBannerAdView.premiumBannerAdOptions = NestAdsPremiumBannerAdOptions.Builder()
    .setRadius(4)
    .setImageOptions(
        NestAdsImageOptions.Builder()
        .setBackgroundColor("#FFFFFF")
        .build()
    )
    .build()

// 5. (옵션) 광고 리스너를 설정합니다.
// 공통 리스너
dynamicBannerAdView.adListener = object : NestAdsAdListener() {
    override fun onAdLoaded() {
        // 광고 로드 완료 시 호출
    }

    override fun onAdFailedToLoad(error: NestAdsAdError) {
        // 광고 로드 실패 시 호출
    }
    
    override fun onAdClicked() {
        // 광고 클릭 시 호출
    }

    override fun onAdImpression() {
        // 광고 노출 시 호출
    }
}

// 프리미엄 배너 전용 리스너 (프리미엄 배너가 로드될 경우에만 동작)
dynamicBannerAdView.premiumBannerAdListener = object : NestAdsPremiumBannerAdListener() {
    override fun onExpandedAdOpened() {
        // 확장 배너가 열릴 때 호출
    }
    
    override fun onExpandedAdClosed() {
        // 확장 배너가 닫힐 때 호출
    }
    
    override fun onExpandedAdPositionChanged(x: Int, y: Int, width: Int, height: Int) {
        // 확장 배너의 위치/크기가 변경될 때 호출
    }
}

// 동영상 광고 콜백 (프리미엄 동영상 배너가 로드될 경우에만 동작)
dynamicBannerAdView.videoLifecycleCallbacks = object : NestAdsVideoController.VideoLifecycleCallbacks() {
    override fun onVideoStart() {
        // 동영상 재생 시작 시 호출
    }
    
    override fun onVideoEnd() {
        // 동영상 재생 완료 시 호출
    }
}

// 6. 광고를 로드합니다.
dynamicBannerAdView.loadAd(NestAdsAdRequest.Builder().build())

자동 배너 타입 판별

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

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

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

---

설정 옵션 요약

공통 설정

속성	타입	기본값	설명
placementCode	String	""	게재위치 코드 (필수)
adListener	NestAdsAdListener?	null	광고 이벤트 리스너

이미지 배너 설정

속성	타입	기본값	설명
imageBannerOptions	NestAdsImageOptions	NestAdsImageOptions()	이미지 배너 스타일 옵션
enableOverflow	Boolean	false	overflow 허용 여부

프리미엄 배너 설정

속성	타입	기본값	설명
expandableAdSize	NestAdsAdSize	FLUID	확장 후 배너 사이즈
premiumBannerAdOptions	NestAdsPremiumBannerAdOptions	NestAdsPremiumBannerAdOptions()	프리미엄 배너 스타일 옵션
premiumBannerAdListener	NestAdsPremiumBannerAdListener?	null	프리미엄 배너 이벤트 리스너
videoLifecycleCallbacks	VideoLifecycleCallbacks?	null	동영상 재생 콜백

---

광고 리스너

NestAdsDynamicBannerAdView에서 지원하는 광고 리스너는 다음을 참고하세요.

• NestAdsAdListener - 공통 광고 이벤트

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

• VideoLifecycleCallbacks - 동영상 재생 이벤트

---

광고 옵션

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

• NestAdsImageOptions - 이미지 배너 옵션

• NestAdsPremiumBannerAdOptions - 프리미엄 배너 옵션

• NestAdsAdSize - 광고 사이즈

---