برنماهای تطبیقی به شما امکان می‌دهند عرض آگهی را مشخص کنید تا اندازه بهینه آگهی برای هر دستگاه تعیین شود. برخلاف برنماهای تطبیقی لنگرانداخته، برنماهای تطبیقی درون‌خطی بزرگ‌تر و بلندتر هستند و از ارتفاع ثابت استفاده نمی‌کنند. بلندی برنمای تطبیقی به‌خط متغیر است. این برنماها ممکن است کل صفحه یا حداکثر ارتفاعی را که مشخص می‌کنید پر کنند.
این راهنما ایجاد برنماهای تطبیقی درون‌خطی و تنظیم اندازه برنما را پوشش می‌دهد.
تصویر زیر برنماهای تطبیقی درون‌خطی را در محتوای پیمایشی نشان می‌دهد:
قبل‌از شروع
قبل‌از ادامه، مطمئن شوید که آگهی‌های برنمایی را راه‌اندازی کرده‌اید.
برای مشاهده نمونه کامل برنمای تطبیقی درون‌خطی، برنامه نمونه زیر را بارگیری کنید:
پیاده‌سازی کردن برنمای تطبیقی به‌خط
برای پیاده‌سازی برنماهای تطبیقی درون‌خطی، اندازه آگهی را تنظیم می‌کنید، درخواست آگهی ایجاد می‌کنید، و آگهی را بار می‌کنید.
برای تعیین اندازه برنمای تطبیقی درون‌خطی، عرض آگهی را مشخص کنید. رویکردهای رایج شامل موارد زیر است:
- بااستفاده از عرض تمام‌صفحه.
- استفاده از عرض چیدمان ولی حاوی آگهی.
- درحال تنظیم عرض برای درنظر گرفتن مناطق امن دستگاه.
هنگام ایجاد شیء اندازه آگهی، از این عرض محاسبه‌شده استفاده کنید.
مثال زیر یک اندازه آگهی تطبیقی درون‌خطی را بااستفاده از عرض منطقه امن دستگاه ایجاد می‌کند:
Swift
// Make sure the ad fits inside the readable area.
let adWidth = view.bounds.inset(by: view.safeAreaInsets).width
bannerView.adSize = currentOrientationInlineAdaptiveBanner(width: adWidth)
آبجکتیو-سی
// Make sure the ad fits inside the readable area.
CGFloat adWidth = CGRectGetWidth(UIEdgeInsetsInsetRect(view.bounds, view.safeAreaInsets));
bannerView.adSize = GADCurrentOrientationInlineAdaptiveBannerAdSizeWithWidth(adWidth);
اندازه آگهی را کوچک‌تر یا مساوی اندازه صفحه‌نمایش دستگاه تنظیم کنید.
برای تعیین حداکثر اندازه صفحه‌نمایش در iOS 26 و نسخه‌های جدیدتر، از
UIWindowScene.effectiveGeometry.coordinateSpace
دارایی استفاده کنید. در iOS 18 و نسخه‌های قدیمی‌تر، از
UIWindowScene.coordinateSpace
خصوصیت استفاده کنید.
برای جزئیات مربوط به محدودیت‌های اندازه، به
عیب‌یابی کردن ظهورهای پرنشده در «مدیر آگهی» مراجعه کنید.
اگر برای استفاده از برنمای تطبیقی نیاز به به‌روزرسانی یا ایجاد ردیف‌های آگهی دارید، به راه‌اندازی ردیف‌های آگهی برای برنمای تطبیقی مراجعه کنید.
تنظیم چیدمان برنمای تطبیقی درون‌خطی
برای پیش‌بار کردن آگهی برنمای تطبیقی به‌خط برای چیدمانی خاص، از روش‌های زیر استفاده کنید:
GADPortraitInlineAdaptiveBannerAdSizeWithWidth(CGFloat width)GADLandscapeInlineAdaptiveBannerAdSizeWithWidth(CGFloat width)
اگر برنامه‌تان از نماهای عمودی و افقی پشتیبانی می‌کند و می‌خواهید آگهی برنمای تطبیقی را در چیدمان فعلی پیش‌بارگیری کنید، از روش
GADCurrentOrientationInlineAdaptiveBannerAdSizeWithWidth(CGFloat width)
استفاده کنید.
این روش آگهی را در چیدمان کنونی بار می‌کند.
محدود کردن ارتفاع برنمای تطبیقی درون‌خطی
به‌طور پیش‌فرض، بلندی بیشینه برابربا بلندی دستگاه است برای برنمای تطبیقی درون‌خطی که بدون مقدار maxHeight ساخته شده است. برای محدود کردن ارتفاع برنمای
انطباقی درون‌خط، از روش
GADInlineAdaptiveBannerAdSizeWithWidthAndMaxHeight(CGFloat width, CGFloat maxHeight)
استفاده کنید.