네이티브 심플 광고 옵션

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

GfpTheme 설정

NDA 모듈을 통해 제공되는 일부 광고들은 설정된 GfpTheme 값에 따라 밝은 테마와 어두운 테마로 구분지어 렌더링 됩니다.

NdaProviderOptions.Builder().setTheme(GfpTheme) 를 통해 전역적인 GfpTheme 설정이 가능하지만, 단일 광고에만 적용하는 GfpTheme 를 적용하고자 할 경우 GfpNativeSimpleAdOptions.Builder().setTheme() 를 호출합니다.

• 설정하지 않으면 기기에 설정된 DayNight 값에 따라서 렌더링 됩니다.
• 이 옵션을 설정하면 요청된 대로 GfpTheme 값에 따라서 렌더링 됩니다.

아래 예시는 어두운 테마로 설정하는 방법을 보여줍니다.

Kotlin

val nativeSimpleAdOptions = GfpNativeSimpleAdOptions.Builder()
    .setTheme(ResolvedTheme.DARK)
    .build()
val adLoader = GfpAdLoader.Builder(this, adParam)
    ...
    .withNativeSimpleAd(nativeSimpleAdOptions) { nativeSimpleAd ->
        ...
    }
    .build()

Java

GfpNativeSimpleAdOptions nativeSimpleAdOptions = new GfpNativeSimpleAdOptions.Builder()
    .setTheme(ResolvedTheme.DARK)
    .build();
GfpAdLoader adLoader = new GfpAdLoader.Builder(this, adParam)
    ...
    .withNativeSimpleAd(nativeSimpleAdOptions, nativeSimpleAd -> {
        ...
    })
    .build();

AdChoices 게재위치

GfpAdChoicesView 를 사용하여 AdChoices 아이콘을 맞춤 위치에 배치할 수 있었던 네이티브 광고와 달리, 네이티브 심플 광고는 SDK 에 의해 AdChoices 아이콘이 지정한 모서리에 자동으로 추가됩니다.

네이티브 심플 광고의 AdChoices 게재위치를 변경하려면, GfpNativeSimpleAdOptions.Builder.setAdChoicesPlacement() 메서드를 사용하여 AdChoices 아이콘을 렌더링할 모서리를 선택할 수 있습니다.

• 설정하지 않으면 AdChoices 아이콘 위치가 오른쪽 상단으로 설정됩니다.
• 이 옵션을 설정하면 요청된 대로 AdChoices 가 맞춤 위치에 배치됩니다. 설정될 수 있는 값은 아래와 같습니다.
  • GfpNativeSimpleAdOptions.ADCHOICES_TOP_LEFT
  • GfpNativeSimpleAdOptions.ADCHOICES_TOP_RIGHT (미설정시 기본값)
  • GfpNativeSimpleAdOptions.ADCHOICES_BOTTOM_LEFT
  • GfpNativeSimpleAdOptions.ADCHOICES_BOTTOM_RIGHT

아래 예시는 네이티브 심플 광고의 AdChoices 아이콘 게재위치를 우하단에 위치하도록 설정하는 방법을 보여줍니다.

Kotlin

val nativeSimpleAdOptions = GfpNativeSimpleAdOptions.Builder()
    .setAdChoicesPlacement(GfpNativeSimpleAdOptions.ADCHOICES_BOTTOM_RIGHT)
    .build()
val adLoader = GfpAdLoader.Builder(this, adParam)
    ...
    .withNativeSimpleAd(nativeSimpleAdOptions) { nativeSimpleAd ->
        ...
    }
    .build()

Java

GfpNativeSimpleAdOptions nativeSimpleAdOptions = new GfpNativeSimpleAdOptions.Builder()
    .setAdChoicesPlacement(GfpNativeSimpleAdOptions.ADCHOICES_BOTTOM_RIGHT)
    .build();
GfpAdLoader adLoader = new GfpAdLoader.Builder(this, adParam)
    ...
    .withNativeSimpleAd(nativeSimpleAdOptions, nativeSimpleAd -> {
        ...
    })
    .build();

배경 설정

NDA 모듈을 통해 제공되는 일부 광고들은 배경을 사용자 설정할 수 있습니다. 어두운 테마 사용시의 배경을 다르게 지정하려면 setBackgroundStyleForDarkMode 을 사용합니다.

Kotlin

GfpNativeSimpleAdOptions.Builder()
    .setBackgroundStyle(
        GfpNativeSimpleBackgroundStyle(
          Color.rgb(237, 240, 244),  // background color
          0.74f,  // background alpha
          8,  // corner radius (dp)
          8,  // left margin (dp)
          0,  // top margin (dp)
          8,  // right margin (dp)
          0,  // bottom margin (dp)
          414,  // max width (dp)
          null,  // shadow color
          0f,  // shadow alpha
          0,  // shadow horizontal offset(dp)
          0,  // shadow vertical offset(dp)
          0 // shadow blur radius (dp)
        )
    )
.build()

Java

new GfpNativeSimpleAdOptions.Builder()
    .setBackgroundStyle(
        new GfpNativeSimpleBackgroundStyle(
            Color.rgb(237, 240, 244), // background color
            0.74f, // background alpha
            8, // corner radius (dp)
            8, // left margin (dp)
            0, // top margin (dp)
            8, // right margin (dp)
            0, // bottom margin (dp)
            414, // max width (dp)
            null, // shadow color
            0f, // shadow alpha
            0, // shadow horizontal offset(dp)
            0, // shadow vertical offset(dp)
            0 // shadow blur radius (dp)
        )
    )
.build();

타임아웃 설정

네이티브 광고의 요청 타임아웃 값은 SdkPropertiesBuilder.unifiedAdRequestTimeout 을 통해 전역적으로 설정할 수 있지만, 단일 광고 요청에 대한 타임아웃을 설정하고자 할 경우 아래 예시와 같이 GfpAdLoader 를 빌드하는 과정에서 withTimeoutMillis 메서드를 사용하여 설정할 수 있습니다.

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

정보

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

Kotlin

val adLoader = GfpAdLoader.Builder(this, adParam)
    .withTimeoutMillis(10_000L)
    .withNativeSimpleAd { nativeSimpleAd ->
        // Show the native simple ad.
    }
    .build()

Java

GfpAdLoader adLoader = new GfpAdLoader.Builder(this, adParam)
    .withTimeoutMillis(10_000L)
    .withNativeSimpleAd(new GfpNativeSimpleAd.OnNativeSimpleAdLoadedListener() {
        @Override
        public void onNativeSimpleAdLoaded(GfpNativeSimpleAd nativeSimpleAd) {
            // Show the native simple ad.
        }
    })
    .build();