이미지 배너 광고

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

기본 요건

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

---

테스트 광고 게재위치

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

테스트 게재위치 목록

placementCode	설명
SAMPLE_IMAGE_BANNER/200/200	200x200 이미지 + 애드뱃지
SAMPLE_IMAGE_BANNER_NO_ADBADGE/200/200	200x200 이미지 + 애드뱃지없음
SAMPLE_IMAGE_BANNER/300/250	300x250 이미지 + 애드뱃지
SAMPLE_IMAGE_BANNER/320/50	320x50 이미지 + 애드뱃지
SAMPLE_IMAGE_BANNER/320/100	320x100 이미지 + 애드뱃지
SAMPLE_IMAGE_BANNER/640/960	640x960 이미지 + 애드뱃지

---

광고 표시하기

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

2. 배너 광고의 옵션 설정을 원하는 경우 적용해줍니다.

3. 게재위치 사이즈를 설정합니다.

4. 게재위치 및 adListener를 설정합니다.

5. 광고를 로드합니다.

Kotlin

// 1. NestAdsImageBannerAdView를 를 생성합니다.
val imageBannerAdView = NestAdsImageBannerAdView(this)

// 2. (선택) 옵션을 적용합니다.
// 백그라운드 옵션을 별도 적용하지 않으면, 여백이 생길 시 소재 이미지 0,0 좌표 내 1px 색상으로 배경색이 채워집니다.
imageBannerAdView.setOptions(
    NestAdsImageOptions.Builder()
        .setBackgroundColor("#80FFFF00") //노란색, 50%
        .build()
)

// 3. (선택) 게재위치 사이즈를 설정합니다.
imageBannerAdView.setAdSize(NestAdsAdSize(200,200))

// NestAdsAdSize.FLUID 를 활용할 수 있습니다.
// imageBannerAdView.setAdSize(NestAdsAdSize.FLUID)

// 4. (필수) 게재위치 및 (선택) adListener를 설정합니다.
imageBannerAdView.placementCode = "SAMPLE_IMAGE_BANNER/200/200"
imageBannerAdView.adListener =  object : NestAdsAdListener() {...}

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

NestAdsAdSize를 숫자를 넣어 생성하고 설정하면 소재 사이즈가 그와 딱 맞지 않으면 여백이 생길 수 있습니다. 사이즈를 정확히 모르는 경우 필요에 따라 가로 길이는 부모의 container 길이에 맞추고, 세로 길이는 소재의 비율에 맞게 나타낼 수 있는 NestAdsAdSize.FLUID 를 활용할 수 있습니다.

---

광고 리스너

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

• NestAdsAdListener