NestAdsDynamicBannerAdView

public final class NestAdsDynamicBannerAdView

서버 응답에 따라 이미지 배너 또는 프리미엄 배너를 자동으로 판별하여 표시하는 통합 배너 뷰입니다.

Kotlin

package com.nestads.sdk.ads.dynamic

---

Constructors

public constructor(context: Context, adSize: NestAdsAdSize = NestAdsAdSize.FLUID)

NestAdsDynamicBannerAdView 인스턴스를 생성합니다.

매개변수	설명
context	현재 Context
adSize	배너 광고 사이즈. 기본값은 NestAdsAdSize.FLUID

Kotlin

// 기본 FLUID 사이즈로 생성
val dynamicBannerAdView = NestAdsDynamicBannerAdView(context)

// 고정 사이즈로 생성
val dynamicBannerAdView = NestAdsDynamicBannerAdView(context, NestAdsAdSize(320, 100))

---

Public Properties

var placementCode: String

광고 게재위치 코드를 설정합니다. 광고 요청 전 반드시 설정해야 합니다.

기본값	설명
""	빈 문자열

---

var adListener: NestAdsAdListener?

광고 이벤트 리스너를 설정합니다. 이미지 배너와 프리미엄 배너 모두에서 동작합니다.

기본값	설명
null	리스너 미설정

---

var premiumBannerAdListener: NestAdsPremiumBannerAdListener?

프리미엄 배너 전용 이벤트 리스너를 설정합니다. 프리미엄 배너가 로드된 경우에만 동작합니다.

기본값	설명
null	리스너 미설정

---

var videoLifecycleCallbacks: NestAdsVideoController.VideoLifecycleCallbacks?

동영상 재생 관련 콜백을 설정합니다. 프리미엄 동영상 배너가 로드된 경우에만 동작합니다.

기본값	설명
null	콜백 미설정

---

var enableOverflow: Boolean

이미지 배너의 overflow 허용 여부를 설정합니다. 이미지 배너가 로드된 경우에만 적용됩니다.

기본값	설명
false	overflow 비허용

---

var imageBannerOptions: NestAdsImageOptions

이미지 배너의 스타일 옵션을 설정합니다. 이미지 배너가 로드된 경우에만 적용됩니다.

기본값	설명
NestAdsImageOptions()	기본 옵션

Kotlin

dynamicBannerAdView.imageBannerOptions = NestAdsImageOptions.Builder()
    .setBackgroundColor("#80FFFF00")
    .setRadius(8f)
    .build()

---

var premiumBannerAdOptions: NestAdsPremiumBannerAdOptions

프리미엄 배너의 스타일 옵션을 설정합니다. 프리미엄 배너가 로드된 경우에만 적용됩니다.

기본값	설명
NestAdsPremiumBannerAdOptions()	기본 옵션

Kotlin

dynamicBannerAdView.premiumBannerAdOptions = NestAdsPremiumBannerAdOptions.Builder()
    .setRadius(4)
    .setImageOptions(
        NestAdsImageOptions.Builder()
            .setBackgroundColor("#FFFFFF")
            .build()
    )
    .build()

---

var expandableAdSize: NestAdsAdSize

프리미엄 배너의 확장 후 사이즈를 설정합니다. 프리미엄 배너가 로드된 경우에만 적용됩니다.

기본값	설명
NestAdsAdSize.FLUID	변동 사이즈

---

val videoView: NestAdsVideoView?

프리미엄 동영상 배너가 로드된 경우 동영상 뷰를 반환합니다.

반환값	설명
NestAdsVideoView?	프리미엄 동영상 배너가 로드된 경우 동영상 뷰, 그 외에는 null

Kotlin

dynamicBannerAdView.videoView?.let { videoView ->
    // 동영상 뷰 제어
}

---

Public Methods

fun loadAd(adRequest: NestAdsAdRequest, creativeSpecCodeKey: String? = null): Unit

광고를 요청합니다. 서버 응답에 따라 이미지 배너 또는 프리미엄 배너가 자동으로 표시됩니다.

매개변수	설명
adRequest	광고 요청 객체
creativeSpecCodeKey	크리에이티브 스펙 코드 키 (선택)

Kotlin

dynamicBannerAdView.loadAd(NestAdsAdRequest.Builder().build())

NestAds.initialize(context)를 호출하지 않고 loadAd()를 호출하면 adListener.onAdFailedToLoad()가 호출되며 NOT_INITIALIZED 에러가 반환됩니다.

---

fun destroy(): Unit

광고 뷰의 리소스를 해제합니다.

Kotlin

  dynamicBannerAdView.destroy()