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

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

پیش‌نیازها

پیاده‌سازی

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

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

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

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

Kotlin

private fun loadCollapsibleBannerAd(adView: AdView, activity: Activity) {
  val adSize = AdSize.getLargeAnchoredAdaptiveBannerAdSize(activity, 360)

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

  val adRequest =
    BannerAdRequest.Builder(AD_UNIT_ID, adSize).setGoogleExtrasBundle(extras).build()

  adView.loadAd(
    adRequest,
    object : AdLoadCallback<BannerAd> {
      override fun onAdLoaded(ad: BannerAd) {
        Log.i(
          TAG,
          "The last loaded banner is ${if (ad.isCollapsible()) "" else "not "}collapsible.",
        )
      }


      override fun onAdFailedToLoad(adError: LoadAdError) {
        Log.d(TAG, "Banner ad failed to load: $adError")
      }
    },
  )
}

جاوا

private void loadCollapsibleBannerAd(@NonNull AdView adView, @NonNull Activity activity) {
  AdSize adSize = AdSize.getLargeAnchoredAdaptiveBannerAdSize(activity, 360);

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

  BannerAdRequest adRequest =
      new BannerAdRequest.Builder(AD_UNIT_ID, adSize).setGoogleExtrasBundle(extras).build();

  adView.loadAd(
      adRequest,
      new AdLoadCallback<BannerAd>() {
        @Override
        public void onAdLoaded(@NonNull BannerAd ad) {
          Log.i(
              TAG,
              String.format(
                  "The last loaded banner is %scollapsible.", ad.isCollapsible() ? "" : "not "));
        }


        @Override
        public void onAdFailedToLoad(@NonNull LoadAdError adError) {
          Log.d(TAG, "Banner ad failed to load: " + adError);
        }
      });
}

AD_UNIT_ID را با شناسه واحد آگهی‌تان جایگزین کنید.

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

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

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

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

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

Kotlin

override fun onAdLoaded(ad: BannerAd) {
  Log.i(
    TAG,
    "The last loaded banner is ${if (ad.isCollapsible()) "" else "not "}collapsible.",
  )
}

جاوا

@Override
public void onAdLoaded(@NonNull BannerAd ad) {
  Log.i(
      TAG,
      String.format(
          "The last loaded banner is %scollapsible.", ad.isCollapsible() ? "" : "not "));
}

میانجیگری

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