네이티브 광고 옵션

네이티브 광고를 사용하면 NativeAdOptions 객체를 사용해 추가로 맞춤설정할 수 있습니다. 이 가이드에는 NativeAdOptions를 사용하는 방법이 나와 있습니다.

옵션 설정

withNativeAdOptions()
AdLoader의 생성에 포함되는 마지막 함수는 또 다른 선택 메서드인 withNativeAdOptions()입니다.

자바

    AdLoader adLoader = new AdLoader.Builder(context, "ca-app-pub-3940256099942544/2247696110")
        .forUnifiedNativeAd(new UnifiedNativeAd.OnUnifiedNativeAdLoadedListener() {
            @Override
            public void onUnifiedNativeAdLoaded(UnifiedNativeAd unifiedNativeAd) {
                // Show the ad.
            }
        })
        .withAdListener(new AdListener() {
            @Override
            public void onAdFailedToLoad(int errorCode) {
                // Handle the failure by logging, altering the UI, and so on.
            }
        })
        .withNativeAdOptions(new NativeAdOptions.Builder()
                // Methods in the NativeAdOptions.Builder class can be
                // used here to specify individual options settings.
                .build())
        .build();
    

Kotlin

    val adLoader = AdLoader.Builder(this, "ca-app-pub-3940256099942544/2247696110")
        .forUnifiedNativeAd { ad : UnifiedNativeAd ->
            // Show the ad.
        }
        .withAdListener(object : AdListener() {
            override fun onAdFailedToLoad(errorCode: Int) {
                // Handle the failure by logging, altering the UI, and so on.
            }
        })
        .withNativeAdOptions(NativeAdOptions.Builder()
                // Methods in the NativeAdOptions.Builder class can be
                // used here to specify individual options settings.
                .build())
        .build()
    

NativeAdOptions 객체를 사용하면 요청할 때 이용되는 특정 옵션을 앱에서 설정할 수 있습니다. Builder 클래스에서는 인스턴스를 생성할 때 사용되는 다음 메서드를 제공합니다.

setReturnUrlsForImageAssets()
네이티브 광고의 이미지 애셋은 DrawableUri가 포함된 NativeAd.Image의 인스턴스를 통해 반환됩니다. 이 옵션을 기본값인 false로 설정하면 Google 모바일 광고 SDK가 자동으로 이미지 애셋을 가져와서 DrawableUri에 적용합니다. 그러나 true로 설정하면 SDK가 Uri 필드에만 값을 입력하며, 실제 이미지를 개발자가 직접 다운로드할 수 있습니다.
setRequestMultipleImages()

일부 이미지 애셋의 경우 한 개가 아닌 여러 개의 이미지가 포함되어 있습니다. 이 값을 true로 설정하면 앱에서 둘 이상의 이미지가 포함된 애셋에 대해 모든 이미지를 표시할 준비가 되었다는 뜻입니다. 기본값인 false로 설정하면 여러 이미지가 포함된 애셋에 첫 번째 이미지만 제공하도록 앱이 SDK에 지시합니다.

AdLoader를 만들 때 withNativeAdOptions를 전혀 호출하지 않으면 각 옵션의 기본값이 사용됩니다.

setAdChoicesPlacement()

AdChoices 오버레이의 기본 위치는 오른쪽 상단입니다. 이 속성을 다음 중 하나로 설정한 결과에 따라 앱에서 오버레이가 렌더링되는 위치가 정해집니다.

  • ADCHOICES_TOP_LEFT
  • ADCHOICES_TOP_RIGHT
  • ADCHOICES_BOTTOM_RIGHT
  • ADCHOICES_BOTTOM_LEFT
setVideoOptions()

앱에서 이 메서드를 이용해 네이티브 광고의 일부로 반환되는 동영상 애셋에 대한 옵션을 설정할 수 있습니다. 자세한 내용은 네이티브 광고 고급형 가이드의 네이티브 동영상 섹션을 참고하세요.

setMediaAspectRatio()

네이티브 광고에 반환할 이미지 또는 동영상의 가로 세로 비율을 설정하는 메서드입니다. NativeMediaAspectRatio를 다음 상수 중 하나로 설정하면 미디어의 가로 세로 비율이 이 값으로 설정된 광고만 반환됩니다.

  • NATIVE_MEDIA_ASPECT_RATIO_LANDSCAPE
  • NATIVE_MEDIA_ASPECT_RATIO_PORTRAIT
  • NATIVE_MEDIA_ASPECT_RATIO_SQUARE
  • NATIVE_MEDIA_ASPECT_RATIO_ANY

NativeMediaAspectRatio가 설정되지 않으면 가로 세로 비율에 관계없이 광고가 반환됩니다.