آگهی‌های برنمای تطبیق‌پذیر به‌خط

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

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

این راهنما ایجاد برنماهای تطبیقی درون‌خطی و تنظیم اندازه برنما را پوشش می‌دهد.

تصویر زیر برنماهای تطبیقی درون‌خطی را در محتوای پیمایشی نشان می‌دهد:

نموداری که تفاوت‌های بین برنمای تطبیقی و برنمای تطبیقی درون‌خط را نشان می‌دهد

قبل‌از شروع

قبل‌از ادامه، مطمئن شوید که آگهی‌های برنمایی را راه‌اندازی کرده‌اید.

برای مشاهده نمونه کامل برنمای تطبیقی درون‌خطی، برنامه نمونه زیر را بارگیری کنید:

پیاده‌سازی برنماهای تطبیقی به‌خط

برای پیاده‌سازی برنماهای تطبیقی درون‌خطی، اندازه آگهی را تنظیم می‌کنید، درخواست آگهی ایجاد می‌کنید، و آگهی را بار می‌کنید.

برای تعیین اندازه برنمای تطبیقی درون‌خط، عرض آگهی را مشخص کنید. رویکردهای رایج شامل موارد زیر است:

  • استفاده از عرض تمام‌صفحه.
  • استفاده از عرض چیدمان ولی حاوی آگهی.
  • درحال تنظیم عرض برای درنظر گرفتن مناطق امن دستگاه.

هنگام ایجاد کردن شیء اندازه آگهی، از این پهنای محاسبه‌شده استفاده کنید.

مثال زیر اندازه آگهی را تنظیم می‌کند، درخواست آگهی ایجاد می‌کند، و آگهی را بار می‌کند:

Kotlin

private fun loadAd() {
  // Create an inline adaptive ad size. 320 is a placeholder value.
  // Replace 320 with your banner container width.
  val adSize = AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(this, 320)

  // Step 1 - Create a BannerAdRequest object with ad unit ID and size.
  val adRequest = BannerAdRequest.Builder("AD_UNIT_ID", adSize).build()

  // Step 2 - Load the ad.
  BannerAd.load(
    adRequest,
    object : AdLoadCallback<BannerAd> {
      override fun onAdLoaded(ad: BannerAd) {
        // Assign the loaded ad to the BannerAd object.
        bannerAd = ad
        // Step 3 - Call BannerAd.getView() to get the View and add it
        // to view hierarchy on the UI thread.
        activity?.runOnUiThread {
          binding.bannerViewContainer.addView(ad.getView(requireActivity()))
        }
      }

      override fun onAdFailedToLoad(loadAdError: LoadAdError) {
        bannerAd = null
      }
    }
  )
}

جاوا

private void loadAd() {
  // Create an inline adaptive ad size. 320 is a placeholder value.
  // Replace 320 with your banner container width.
  AdSize adSize = AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(this, 320);

  // Step 1 - Create a BannerAdRequest object with ad unit ID and size.
  BannerAdRequest adRequest = new BannerAdRequest.Builder("AD_UNIT_ID",
      adSize).build();

  // Step 2 - Load the ad.
  BannerAd.load(
      adRequest,
      new AdLoadCallback<BannerAd>() {
        @Override
        public void onAdLoaded(@NonNull BannerAd ad) {
          // Assign the loaded ad to the BannerAd object.
          bannerAd = ad;
          // Step 3 - Call BannerAd.getView() to get the View and add it
          // to view hierarchy on the UI thread.
          if (getActivity() != null) {
            getActivity()
                .runOnUiThread(() ->
                    binding.bannerViewContainer.addView(ad.getView(getActivity())));
          }
        }

        @Override
        public void onAdFailedToLoad(@NonNull LoadAdError adError) {
          bannerAd = null;
        }
      });
}

اندازه آگهی را کوچک‌تر یا مساوی اندازه صفحه‌نمایش دستگاه تنظیم کنید. برای تعیین حداکثر اندازه صفحه‌نمایش، از Resources.getDisplayMetrics روش استفاده کنید. ابعاد شیء AdSize از پیکسل‌های مستقل از تراکم (dp) استفاده می‌کند. هنگام مقایسه، اندازه صفحه را از پیکسل به dp تبدیل کنید. برای جزئیات درباره محدودیت‌های اندازه، الزامات اندازه درخواست آگهی را ببینید.

تنظیم چیدمان برنمای تطبیقی درون‌خطی

برای پیش‌بار کردن آگهی برنمای تطبیقی به‌خط برای چیدمان خاص، از روش‌های زیر استفاده کنید:

اگر برنامه‌تان از نماهای عمودی و افقی پشتیبانی می‌کند و می‌خواهید آگهی برنمای تطبیقی را در چیدمان فعلی پیش‌بارگیری کنید، از روش AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(Context context, int width) استفاده کنید. این روش آگهی را در چیدمان فعلی بار می‌کند.

محدود کردن ارتفاع برنمای تطبیقی درون‌خط

به‌طور پیش‌فرض، برنماهای تطبیقی درون‌خطی که بدون مقدار maxHeight ایجاد شده‌اند حداکثر ارتفاعی برابر با ارتفاع دستگاه دارند. برای محدود کردن ارتفاع برنمای تطبیقی درون‌خطی، از روش AdSize.getInlineAdaptiveBannerAdSize(int width, int maxHeight) استفاده کنید.