گزینه های تبلیغات بومی

تبلیغات بومی به شما امکان می دهد با استفاده از شی NativeAdOptions سفارشی سازی های بیشتری انجام دهید. این راهنما نحوه استفاده از NativeAdOptions را به شما نشان می دهد.

تنظیمات گزینه ها

withNativeAdOptions()
آخرین تابع موجود در ایجاد AdLoader یک روش اختیاری دیگر است، withNativeAdOptions() :

جاوا

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();

کاتلین

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 به برنامه‌ها اجازه می‌دهد تا گزینه‌های خاصی را که برای درخواست استفاده می‌شوند، تنظیم کنند. کلاس Builder آن متدهای زیر را برای استفاده در هنگام ایجاد یک نمونه ارائه می دهد.

setReturnUrlsForImageAssets()
دارایی های تصویر برای تبلیغات بومی از طریق نمونه هایی از NativeAd.Image که دارای یک Drawable و یک Uri است، بازگردانده می شود. اگر این گزینه روی false تنظیم شود (که پیش‌فرض است)، Google Mobile Ads SDK دارایی‌های تصویر را به‌طور خودکار واکشی می‌کند و هم Drawable و هم Uri را برای شما پر می‌کند. با این حال، اگر روی true تنظیم شده باشد، SDK در عوض فقط فیلد Uri را پر می کند و به شما امکان می دهد تصاویر واقعی را بنا به صلاحدید خود دانلود کنید.
setRequestMultipleImages()

برخی از دارایی های تصویر شامل یک سری تصاویر به جای یک عکس هستند. با تنظیم این مقدار روی true، برنامه شما نشان می دهد که آماده نمایش تمام تصاویر برای هر دارایی دارای بیش از یک مورد است. با تنظیم آن بر روی false (پیش‌فرض) برنامه شما به SDK دستور می‌دهد که فقط اولین تصویر را برای هر دارایی حاوی یک سری ارائه دهد.

اگر هنگام ایجاد یک withNativeAdOptions AdLoader ، از مقدار پیش‌فرض برای هر گزینه استفاده می‌شود.

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 تنظیم نشده باشد، تبلیغات با هر نسبت ابعادی برگردانده می شوند.