프리미엄 배너 광고

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

기본 요건

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

테스트 광고 게재위치

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

테스트 게재위치 목록

placementCode

설명

SAMPLE_EXPANDABLE_BANNER_IMAGE_APP

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

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

SAMPLE_EXPANDABLE_BANNER_VIDEO_APP

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

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

광고 상품 설정하기

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

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

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

광고 표시하기

프리미엄 배너 광고가 표시되기 원하는 화면에서 NestAdsPremiumBannerAdView 를 생성합니다.
(필수) 게재위치 및 확장 전/후 배너 사이즈를 설정합니다.
(옵션) 광고 리스너, 스타일 및 동영상 관련 옵션을 설정합니다.
광고 요청 객체를 만들고 광고를 요청합니다.

val premiumBannerAdView = NestAdsPremiumBannerAdView(this)

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

// 확장 전 배너의 사이즈 설정
premiumBannerAdView.setAdSize(NestAdsAdSize.FLUID)
// 확장 후 배너의 사이즈 설정
premiumBannerAdView.setExpandableBannerAdSize(NestAdsAdSize.FLUID)

// 광고 리스너, 동영상 재생 관련 콜백함수 설정
premiumBannerAdView.adListener = object : NestAdsAdListener() {
   override fun onAdLoaded() {
      //광고 로드가 완료되면 할 행동
   }

  ...
}
premiumBannerAdView.premiumBannerAdListener = object : NestAdsPremiumBannerAdListener() {
   override fun onExpandedAdOpened() {
       // 확장 후 배너가 열리면 할 행동
    }
    override fun onExpandedAdPositionChanged(x: Int, y: Int, width: Int, height: Int) {
       // 확장 후 배너의 위치, 크기가 변경되면 할 행동 (ex. 스크롤 이동, 부모 컨테이너의 크기 조절...)
    }
   ...
}
premiumBannerAdView.setVideoLifecycleCallbacks(...)

// 프리미엄 배너의 스타일 및 동영상 관련 옵션 설정
premiumBannerAdView.setOptions(NestAdsPremiumBannerAdOptions.Builder().build())

// 광고를 요청합니다.
premiumBannerAdView.loadAd(NestAdsAdRequest.Builder().build())