배너 광고 옵션

배너 광고에는 추가 맞춤 설정을 수행하고 최상의 광고 경험을 제공할 수 있는 다양한 고급 기능이 있습니다. 이 가이드에서는 배너 광고의 고급 기능을 사용하는 방법을 설명합니다.

---

배너 광고 레이아웃 타입 설정

대부분의 배너 광고의 경우, 320x50, 320x100, 300x250, ... 와 같은 고정된 광고 크기가 정해져 있습니다. 하지만, NDA 모듈로 제공되는 일부 광고들은 BannerViewLayoutType 설정을 통해서 각 기기의 광고 크기를 최적화하여 실적을 극대화할 수 있도록 합니다.

정보

BannerViewLayoutType 설정값에 관계없이 복수개의 사이즈를 가지는 광고가 잘리지 않고 게재될 수 있도록 배너 광고가 게재될 컨테이너 ViewGroup 의 너비 및 높이값을 WRAP_CONTENT 로 설정하는 것을 추천합니다.

크기 고정형 배너 (FIXED)

고정 광고 크기를 지원하는 타입으로서 광고가 게재될 컨테이너 ViewGroup 의 크기는 배너보다 크거나 같아야 합니다.

Kotlin

val bannerAdOptions = GfpBannerAdOptions.Builder()
    .setBannerViewLayoutType(BannerViewLayoutType.FIXED)
    .build()
bannerAdView.setBannerAdOptions(bannerAdOptions)

Java

GfpBannerAdOptions bannerAdOptions = new GfpBannerAdOptions.Builder()
    .setBannerViewLayoutType(BannerViewLayoutType.FIXED)
    .build();
bannerAdView.setBannerAdOptions(bannerAdOptions);

가로 확장형 배너 (FLUID_WIDTH)

배너 광고가 게재될 컨테이너 ViewGroup 의 너비에 맞춰서 배너 광고의 너비가 확장될 수 있습니다.

Kotlin

val bannerAdOptions = GfpBannerAdOptions.Builder()
    .setBannerViewLayoutType(BannerViewLayoutType.FLUID_WIDTH)
    .build()
bannerAdView.setBannerAdOptions(bannerAdOptions)

Java

GfpBannerAdOptions bannerAdOptions = new GfpBannerAdOptions.Builder()
    .setBannerViewLayoutType(BannerViewLayoutType.FLUID_WIDTH)
    .build();
bannerAdView.setBannerAdOptions(bannerAdOptions);

세로 확장형 배너 (FLUID_HEIGHT)

배너 광고가 게재될 컨테이너 ViewGroup 의 높이에 맞춰서 배너 광고의 높이가 확장될 수 있습니다.

Kotlin

val bannerAdOptions = GfpBannerAdOptions.Builder()
    .setBannerViewLayoutType(BannerViewLayoutType.FLUID_HEIGHT)
    .build()
bannerAdView.setBannerAdOptions(bannerAdOptions)

Java

GfpBannerAdOptions bannerAdOptions = new GfpBannerAdOptions.Builder()
    .setBannerViewLayoutType(BannerViewLayoutType.FLUID_HEIGHT)
    .build();
bannerAdView.setBannerAdOptions(bannerAdOptions);

확장형 배너 (FLUID)

배너 광고가 게재될 컨테이너 ViewGroup 의 너비 및 높이에 맞춰서 배너 광고의 너비 및 높이가 확장될 수 있습니다.

Kotlin

val bannerAdOptions = GfpBannerAdOptions.Builder()
    .setBannerViewLayoutType(BannerViewLayoutType.FLUID)
    .build()
bannerAdView.setBannerAdOptions(bannerAdOptions)

Java

GfpBannerAdOptions bannerAdOptions = new GfpBannerAdOptions.Builder()
    .setBannerViewLayoutType(BannerViewLayoutType.FLUID)
    .build();
bannerAdView.setBannerAdOptions(bannerAdOptions);

메타 정보 전달

SDK 를 연동하는 앱에서 배너 광고 소재으로 약속된 key/value 의 값을 전달하는 목적의 설정으로서 일반적으로는 theme 설정을 위해서 사용됩니다. theme 키값으로 설정될 수 있는 값 및 설명은 아래 표를 참고 부탁드립니다.

theme	description
light	배너 광고소재가 항상 LIGHT 모드로 렌더링
dark	배너 광고소재가 항상 DARK 모드로 렌더링
system	배너 광고소재가 기기 DARK 모드 설정값에 맞춰서 렌더링

정보

Theme 설정은 NDA 모듈을 통해서 제공되는 일부 S2S 배너 광고에만 적용될 수 있는 설정으로서, 적용을 원할 경우 NAM 관리자에게 문의 부탁드립니다.

아래 예시는 배너 광고 소재를 항상 DARK 모드로 렌더링 하는 예시를 나타냅니다.

Kotlin

val bannerAdOptions = GfpBannerAdOptions.Builder()
    ...
    .setHostParam(
        HostParam.Builder()
            .addMetaParam("theme", "dark") // In NDA ad, some ad creative support dark mode. This value will be apply in that creative.
            .build()
    )
    .build()
bannerAdView.setBannerAdOptions(bannerAdOptions)

Java

GfpBannerAdOptions bannerAdOptions = new GfpBannerAdOptions.Builder()
    ...
    .setHostParam(
        new HostParam.Builder()
            .addMetaParam("theme", "dark") // In NDA ad, some ad creative support dark mode. This value will be apply in that creative.
            .build()
    )
    .build();
bannerAdView.setBannerAdOptions(bannerAdOptions);

타임아웃 설정

GfpBannerAdView 를 통해서 요청되는 광고들의 요청 타임아웃값은 SdkProperties 을 통해서도 전역적으로 설정할 수 있지만, 단일 광고 요청에 대한 타임아웃을 설정하고자 할 경우 아래 예시와 같이 GfpBannerAdView 의 setTimeoutMillis() 메서드를 통해 설정할 수 있습니다.

아래 예시는 특정 GfpBannerAdView 의 단일 광고 요청에 대한 타임아웃값을 10초로 설정하는 예시를 보여줍니다. 단일 광고 요청에 대한 타임아웃 값을 아래와 같이 설정할 경우, 전역으로 설정한 타임아웃 값이 무시됩니다.

정보

SdkProperties 와 GfpBannerAdView 에 설정된 GfpBannerAdView 용 타임아웃값이 없을 경우 기본값인 60초가 타임아웃값으로 설정됩니다.

Kotlin

bannerAdView.setTimeoutMillis(10_000L)

Java

bannerAdView.setTimeoutMillis(10_000L);