Yerel reklam seçenekleri

Yerel reklamlar, NativeAdOptions nesnesini kullanarak ek özelleştirmeler yapmanıza olanak tanır. Bu kılavuz, NativeAdOptions uygulamasını nasıl kullanacağınızı gösterir.

Ayar seçenekleri

withNativeAdOptions()
AdLoader oluşturma sürecinde yer alan son işlev, isteğe bağlı başka bir yöntem olan withNativeAdOptions():

Java

AdLoader adLoader = new AdLoader.Builder(context, "ca-app-pub-3940256099942544/2247696110")
    .forNativeAd(new NativeAd.OnNativeAdLoadedListener() {
        @Override
        public void onNativeAdLoaded(NativeAd nativeAd) {
            // Show the ad.
        }
    })
    .withAdListener(new AdListener() {
        @Override
        public void onAdFailedToLoad(LoadAdError adError) {
            // 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")
    .forNativeAd { ad : NativeAd ->
        // Show the ad.
    }
    .withAdListener(object : AdListener() {
        override fun onAdFailedToLoad(adError: LoadAdError) {
            // 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 nesnesi, uygulamaların istekte bulunurken kullanılan belirli seçenekleri ayarlamasına olanak tanır. Örnekteki Builder sınıfı, örnek oluştururken kullanabileceğiniz aşağıdaki yöntemleri sunar.

setReturnUrlsForImageAssets()
Yerel reklamlara ait resim öğeleri, Drawable ve Uri özelliklerini barındıran NativeAd.Image örnekleri aracılığıyla döndürülür. Bu seçenek false (varsayılan) değerine ayarlanırsa Google Mobile Ads SDK'sı resim öğelerini otomatik olarak getirir ve hem Drawable hem de Uri alanını sizin için doldurur. Ancak doğru değerine ayarlanırsa SDK yalnızca Uri alanını doldurur. Böylece gerçek resimleri dilediğiniz zaman indirebilirsiniz.
setRequestMultipleImages()

Bazı resim öğeleri, tek bir resim yerine bir dizi resim içerir. Bu değeri doğru olarak ayarladığınızda uygulamanız, birden fazla öğesi olan tüm öğelerin tüm resimlerini göstermeye hazır olduğunu gösterir. Uygulamanız, yanlış (varsayılan) değerine ayarlanırsa SDK'ya bir dizi içeren öğelerin yalnızca ilk resmini sağlaması için talimat verir.

AdLoader oluşturulurken withNativeAdOptions hiç çağrılmazsa her seçeneğin varsayılan değeri kullanılır.

setAdChoicesPlacement()

Reklam Seçenekleri yer paylaşımı varsayılan olarak sağ üst köşeye ayarlıdır. Uygulamalar, bu özelliği aşağıdakilerden birine ayarlayarak bu döşemenin oluşturulacağı köşeyi değiştirebilir:

  • ADCHOICES_TOP_LEFT
  • ADCHOICES_TOP_SAĞ
  • ADCHOICES_BOTTOM_SAĞ
  • ADCHOICES_BOTTOM_LEFT
setVideoOptions()

Uygulamalar, yerel bir reklamın parçası olarak döndürülen video öğeleri için seçenekleri belirlemek üzere bu yöntemi kullanabilir. Daha fazla bilgi için Yerel video reklamlar bölümüne bakın.

setMediaAspectRatio()

Bu, yerel reklam için döndürülecek resim veya videonun en boy oranını ayarlar. NativeMediaAspectRatio'yu aşağıdaki sabit değerlerden birine ayarlamak yalnızca belirtilen en boy oranına sahip reklamların döndürülmesine neden olur:

  • NATIVE_MEDIA_ASPECT_RATIO_LANDSCAPE
  • NATIVE_MEDIA_ASPECT_RATIO_PORTRAIT
  • NATIVE_MEDIA_ASPECT_RATIO_SQUARE
  • NATIVE_MEDIA_ASPECT_RATIO_ANY

NativeMediaAspectRatio ayarlanmazsa en boy oranına sahip reklamlar döndürülür.