네이티브 광고를 사용하면 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()
- 네이티브 광고의 이미지 애셋은
Drawable
및Uri
가 포함된NativeAd.Image
의 인스턴스를 통해 반환됩니다. 이 옵션을 기본값인 false로 설정하면 Google 모바일 광고 SDK가 자동으로 이미지 애셋을 가져와서Drawable
및Uri
에 적용합니다. 그러나 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
가 설정되지 않으면 가로 세로 비율에 관계없이 광고가
반환됩니다.