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

آخرین پارامتر موجود در ایجاد GADAdLoader یک آرایه اختیاری از اشیاء است. این بخش آن گزینه ها را توضیح می دهد.

سریع

adLoader = GADAdLoader(adUnitID: "ca-app-pub-3940256099942544/3986624511",
    rootViewController: self,
    adTypes: [ ... ad type constants ... ],
    options: [ ... ad loader options objects ... ])

هدف-C

self.adLoader = [[GADAdLoader alloc]
      initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
    rootViewController:rootViewController
               adTypes:@[ ... ad type constants ... ]
               options:@[ ... ad loader options objects ... ]];

GADNativeAdImageAdLoaderOptions

GADNativeAdImageAdLoaderOptions حاوی ویژگی های مربوط به تصاویر در تبلیغات بومی است. برنامه‌ها می‌توانند با ایجاد یک شیء GADNativeAdImageAdLoaderOptions ، تنظیم ویژگی‌های آن ( disableImageLoading ، preferredImageOrientation ، و shouldRequestMultipleImages ) و ارسال آن در طول مقداردهی اولیه، نحوه مدیریت دارایی‌های تصویر توسط GADAdLoader را کنترل کنند.

GADNativeAdImageAdLoaderOptions دارای ویژگی های زیر است:

disableImageLoading
دارایی‌های تصویر برای تبلیغات بومی از طریق نمونه‌هایی از GADNativeAdImage که حاوی ویژگی‌های image و imageURL است، بازگردانده می‌شود. اگر disableImageLoading روی false تنظیم شده باشد، که پیش‌فرض است ( NO در Objective-C)، SDK به طور خودکار دارایی‌های تصویر را واکشی می‌کند و هم image و هم ویژگی imageURL را برای شما پر می‌کند. اگر روی true (یا YES در Objective-C) تنظیم شده باشد، SDK فقط imageURL را پر می‌کند و به شما امکان می‌دهد تصاویر واقعی را بنا به صلاحدید خود دانلود کنید. از mainImage GADMediaContent برای تنظیم تصویر برای نمای رسانه هنگام بارگیری دستی تصاویر استفاده کنید.
preferredImageOrientation

برخی از خلاقیت ها چندین تصویر برای مطابقت با جهت گیری های مختلف دستگاه در دسترس دارند. برنامه‌ها می‌توانند با تنظیم این ویژگی روی یکی از ثابت‌های جهت‌گیری، تصاویر را برای یک جهت خاص درخواست کنند:

  • GADNativeAdImageAdLoaderOptionsOrientationAny
  • GADNativeAdImageAdLoaderOptionsOrientationLandscape
  • GADNativeAdImageAdLoaderOptionsOrientationPortrait

    اگر از preferredImageOrientation برای تعیین یک اولویت برای جهت گیری تصویر افقی یا عمودی استفاده می کنید، SDK تصاویر منطبق با این جهت را ابتدا در آرایه های دارایی تصویر قرار می دهد و تصاویر غیر منطبق را بعد از آنها قرار می دهد. از آنجایی که برخی از تبلیغات فقط یک جهت در دسترس دارند، ناشران باید مطمئن شوند که برنامه‌هایشان می‌تواند هم تصاویر افقی و هم عمودی را مدیریت کند.

    اگر این متد فراخوانی نشود، از مقدار پیش فرض GADNativeAdImageAdLoaderOptionsOrientationAny استفاده می شود.

shouldRequestMultipleImages

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

اگر هیچ شی GADAdLoaderOptions هنگام مقداردهی اولیه GADAdLoader ، مقدار پیش فرض برای هر گزینه استفاده خواهد شد.

GADNativeAdViewAdOptions

اشیاء GADNativeAdViewAdOptions برای نشان دادن ترجیحات برای نحوه نمایش تبلیغات بومی توسط نماهای تبلیغاتی استفاده می شود. آنها یک ویژگی دارند: preferredAdChoicesPosition که می توانید از آن برای تعیین مکانی که نماد AdChoices باید در آن قرار گیرد استفاده کنید. این نماد می تواند در هر گوشه ای از آگهی ظاهر شود و به طور پیش فرض روی GADAdChoicesPositionTopRightCorner باشد. مقادیر ممکن برای این ویژگی عبارتند از:

  • GADAdChoicesPositionTopRightCorner
  • GADAdChoicesPositionTopLeftCorner
  • GADAdChoicesPositionBottomRightCorner
  • GADAdChoicesPositionBottomLeftCorner

در اینجا یک مثال نشان می دهد که چگونه نماد AdChoices را در گوشه سمت چپ بالای یک تبلیغ قرار دهید:

سریع

let adViewOptions = GADNativeAdViewAdOptions()
adViewOptions.preferredAdChoicesPosition = .topLeftCorner
adLoader = GADAdLoader(adUnitID: "ca-app-pub-3940256099942544/3986624511",
    rootViewController: self,
    adTypes: [ ... ad type constants ... ],
    options: [ ... ad loader options objects ... ])

هدف-C

GADNativeAdViewAdOptions *adViewOptions = [[GADNativeAdViewAdOptions alloc] init];
adViewOptions.preferredAdChoicesPosition = GADAdChoicesPositionTopLeftCorner;
self.adLoader = [[GADAdLoader alloc]
      initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
    rootViewController:self
               adTypes:@[ ... ad type constants ...  ]
               options:@[ ... ad loader options objects ... ]];

GADVideoOptions

اشیاء GADVideoOptions برای نشان دادن نحوه نمایش دارایی های ویدئویی بومی استفاده می شود. آنها یک ویژگی واحد را ارائه می دهند: startMuted .

این بولی نشان می‌دهد که آیا دارایی‌های ویدیویی باید در حالت بی‌صدا شروع به پخش کنند یا خیر. مقدار پیش فرض true است.

GADMultipleAdsAdLoaderOptions

اشیاء GADMultipleAdsAdLoaderOptions به ناشران این امکان را می دهد که به یک بارکننده آگهی دستور دهند تا چندین آگهی را در یک درخواست بارگیری کند. تبلیغاتی که از این طریق بارگذاری می شوند، منحصر به فرد بودن تضمین می شوند. GADMultipleAdsAdLoaderOptions دارای یک ویژگی است، numberOfAds ، که نشان دهنده تعداد تبلیغاتی است که بارکننده آگهی باید برای درخواست بازگرداند. به طور پیش‌فرض این مقدار یک است و حداکثر پنج عدد محدود شده است (حتی اگر یک برنامه تبلیغات بیشتری درخواست کند، حداکثر پنج مورد برگردانده می‌شود). تعداد واقعی تبلیغات بازگردانده شده تضمین نشده است، اما بین صفر و numberOfAds خواهد بود.

GADNativeAdMediaAdLoaderOptions

برای استفاده از این ویژگی، کلاس GADNativeAdMediaAdLoaderOptions را در آرایه گزینه های تبلیغاتی بومی در مقداردهی اولیه GADAdLoader قرار دهید.

اشیاء GADNativeAdMediaAdLoaderOptions به شما این امکان را می دهند که تنظیمات ترجیحی نسبت ابعاد رسانه را انتخاب کنید. این گزینه برای هر دو تصویر و ویدیو اعمال می شود. این کلاس دارای یک ویژگی است: mediaAspectRatio ، که می توانید از آن برای تعیین نسبت ابعاد رسانه پشتیبانی شده استفاده کنید. مقادیر ممکن برای این ویژگی عبارتند از:

هدف-C سریع
GADMediaAspectRatioAny .any
GADMediaAspectRatioLandscape .landscape
GADMediaAspectRatioPortrait .portrait
GADMediaAspectRatioSquare .square

تنظیم mediaAspectRatio روی یکی از این گزینه‌ها باعث می‌شود فقط تبلیغاتی با نسبت تصویر مشخص شده بازگردانده شوند. اگر این ویژگی به طور صریح تنظیم نشده باشد، مقدار به طور پیش فرض روی GADMediaAspectRatioUnknown خواهد بود و هیچ محدودیتی در نسبت ابعاد اعمال نخواهد شد.