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

پلاتفرم را انتخاب کنید: Android iOS Unity Flutter Android (Legacy)

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

پیش‌نیازها

پیاده‌سازی

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

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

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

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

جاوا

private void loadCollapsibleBanner() {
  // Create an extra parameter that aligns the bottom of the expanded ad to
  // the bottom of the bannerView.
  Bundle extras = new Bundle();
  extras.putString("collapsible", "bottom");

  // Create an ad request.
  AdRequest adRequest =
      new AdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter.class, extras).build();

  // ...

  // Start loading a collapsible banner ad.
  adView.loadAd(adRequest);
}

Kotlin

private fun loadCollapsibleBanner() {
  // Create an extra parameter that aligns the bottom of the expanded ad to
  // the bottom of the bannerView.
  val extras = Bundle()
  extras.putString("collapsible", "bottom")

  // Create an ad request.
  val adRequest =
    AdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter::class.java, extras).build()

  // ...

  // Start loading a collapsible banner ad.
  adView.loadAd(adRequest)
}

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

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

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

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

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

جاوا

public void onAdLoaded() {
  Log.i(
      MainActivity.LOG_TAG,
      String.format("Ad loaded. adView.isCollapsible() is %b.", adView.isCollapsible()));
}

Kotlin

override fun onAdLoaded() {
  Log.i(
    MainActivity.LOG_TAG,
    "Ad loaded. adView.isCollapsible() is ${adView.isCollapsible}.",
  )
}

میانجیگری

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