استفاده از برنماهای جمع‌شدنی

آگهی‌های برنمای جمع‌شدنی آگهی‌های برنمایی هستند که در ابتدا به‌عنوان هم‌پوشانی بزرگ‌تری ارائه می‌شوند و دکمه‌ای برای جمع کردن آن‌ها به اندازه برنمای درخواست‌شده اصلی دارند. هدف از آگهی‌های برنمای جمع‌شدنی بهبود عملکرد آگهی‌های لنگرانداخته است که درغیراین‌صورت اندازه کوچک‌تری دارند. این راهنما نحوه روشن کردن آگهی‌های برنمای جمع‌شدنی را برای جایگاه‌های آگهی برنمای موجود نشان می‌دهد.

پیش‌نیازها

پیاده‌سازی

مطمئن شوید نمای برنمای شما با اندازه‌ای تعریف شده باشد که می‌خواهید کاربران در حالت برنمای معمولی (جمع‌شده) ببینند. پارامتر extras را در درخواست آگهی با collapsible به‌عنوان کلید و جای آگهی به‌عنوان مقدار اضافه کنید.

جای آگهی جمع‌شدنی تعیین می‌کند که منطقه گسترده‌شده چگونه به آگهی برنمایشی متصل شود.

به‌ارزش Placement رفتار مورد استفاده موردنظر
top بالای آگهی گسترده با بالای آگهی جمع‌شده تراز می‌شود. آگهی در بالای صفحه قرار می‌گیرد.
bottom پایین آگهی گسترده با پایین آگهی جمع‌شده تراز می‌شود. آگهی در پایین صفحه قرار می‌گیرد.

اگر آگهی بارشده بنر جمع‌شدنی باشد، بنر بلافاصله پس‌از قرار گرفتن در سلسله‌مراتب نما، هم‌پوشانی جمع‌شدنی را نشان می‌دهد: 

void _loadAd() async {
  // Replace these test ad units with your own ad units.
  final String adUnitId = Platform.isAndroid
    ? 'ca-app-pub-3940256099942544/2014213617'
    : 'ca-app-pub-3940256099942544/8388050270';

  // Get the size before loading the ad.
  final size = await AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(
      MediaQuery.sizeOf(context).width.truncate());

  if (size == null) {
    // Unable to get the size.
    return;
  }

  // Create an extra parameter that aligns the bottom of the expanded ad to the
  // bottom of the banner ad.
  const adRequest = AdRequest(extras: {
    "collapsible": "bottom",
  });

  BannerAd(
      adUnitId: adUnitId,
      request: adRequest,
      size: size,
      listener: const BannerAdListener()
  ).load();
}

رفتار بازآوری آگهی‌ها

برای برنامه‌هایی که بازآوری خودکار را برای آگهی‌های برنمایی در میانای وب AdMob پیکربندی می‌کنند، وقتی آگهی برنمایی جمع‌شدنی برای جایگاه آگهی درخواست می‌شود، بازآوری‌های بعدی آگهی، آگهی‌های برنمایی جمع‌شدنی را درخواست نخواهند کرد. دلیل آن این است که نشان دادن برنمای جمع‌شدنی در هر بار بازآوری می‌تواند تأثیر منفی بر تجربه کاربری داشته باشد.

اگر می‌خواهید آگهی بنری جمع‌شدنی دیگری را بعداً در جلسه بار کنید، می‌توانید آگهی را به‌صورت دستی با درخواستی که حاوی پارامتر جمع‌شدنی است بار کنید.

بررسی کنید که آیا آگهی بارشده جمع‌شدنی است یا نه

آگهی‌های برنمای غیرجمع‌شدنی برای درخواست‌های آگهی برنمای جمع‌شدنی واجدشرایط هستند تا عملکرد بیشینه شود. اگر درخواست بار نشود و برنمای قبلی جمع‌شدنی باشد، API مقدار true را برمی‌گرداند. برای بررسی اینکه آیا آخرین برنما بارشده جمع‌شدنی است یا نه، روش isCollapsible را فراخوانی کنید:

BannerAd(
  // ...
  listener: BannerAdListener(
    onAdLoaded: (ad) {
      final bannerAd = ad as BannerAd;
      final isCollapsible = bannerAd.isCollapsible;
      print('The last loaded banner is ${isCollapsible ? "" : "not"} collapsible.');
    },
  ),
).load();

میانجیگری

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