استخدام إعلانات البانر التكيّفية المضمّنة لإعلانات البانر القابلة للتمرير

اختيار النظام الأساسي: Android iOS Flutter Android (الإصدار القديم)

تتيح لك "إعلانات البانر التكيُّفية" تحديد عرض الإعلان من أجل تحديد حجم الإعلان الأفضل لكل جهاز. على عكس "إعلانات البانر التكيُّفية الثابتة"، تكون "إعلانات البانر التكيُّفية المضمّنة" أكبر وأطول ولا تستخدم ارتفاعات ثابتة. تتضمّن "إعلانات البانر التكيّفية المضمّنة" ارتفاعًا متغيرًا. قد تملأ إعلانات البانر هذه الشاشة بأكملها أو الحد الأقصى للارتفاع الذي تحدّده.

يتناول هذا الدليل كيفية إنشاء "إعلانات بانر تكيُّفية مضمّنة" وضبط حجمها.

تعرض الصورة التالية "إعلانات بانر تكيُّفية مضمّنة" في محتوى قابل للتمرير:

قبل البدء

قبل المتابعة، تأكَّد من إعداد إعلانات البانر.

للاطّلاع على مثال كامل على "إعلان بانر تكيُّفي مضمّن"، نزِّل نموذج التطبيق التالي:

• Swift
• Objective-C

تنفيذ "إعلانات البانر التكيُّفية المضمّنة"

لتنفيذ "إعلانات البانر التكيُّفية" المضمّنة، عليك ضبط حجم الإعلان وإنشاء طلب عرض إعلان وتحميل الإعلان.

لتحديد حجم "إعلان بانر تكيُّفي" مضمّن، حدِّد عرض الإعلان. تشمل الأساليب الشائعة ما يلي:

• استخدام عرض ملء الشاشة
• استخدام عرض تصميم العنصر الرئيسي الذي يحتوي على الإعلان.
• يتم تعديل العرض لمراعاة المناطق الآمنة على الجهاز.

عند إنشاء عنصر حجم الإعلان، استخدِم هذا العرض المحسوب.

ينشئ المثال التالي حجم إعلان تكيُّفي مضمّن باستخدام عرض المنطقة الآمنة للجهاز:

Swift

// Make sure the ad fits inside the readable area.
let adWidth = view.bounds.inset(by: view.safeAreaInsets).width
bannerView.adSize = currentOrientationInlineAdaptiveBanner(width: adWidth)
BannerSnippets.swift

Objective-C

// Make sure the ad fits inside the readable area.
CGFloat adWidth = CGRectGetWidth(UIEdgeInsetsInsetRect(view.bounds, view.safeAreaInsets));
bannerView.adSize = GADCurrentOrientationInlineAdaptiveBannerAdSizeWithWidth(adWidth);
BannerSnippets.m

اضبط حجم الإعلان على قيمة أصغر من حجم شاشة الجهاز أو مساوية له. لتحديد الحدّ الأقصى لحجم الشاشة على الإصدار iOS 26 والإصدارات الأحدث، استخدِم السمة UIWindowScene.effectiveGeometry.coordinateSpace. على نظام التشغيل iOS 18 والإصدارات الأقدم، استخدِم السمة UIWindowScene.coordinateSpace. لمعرفة التفاصيل حول قيود الحجم، يُرجى الاطّلاع على متطلبات حجم طلب عرض الإعلان.

ضبط تنسيق "إعلان البانر التكيُّفي المضمّن"

لتحميل "إعلان بانر تكيُّفي مضمّن" مسبقًا لتصميم معيّن، استخدِم الطرق التالية:

• GADPortraitInlineAdaptiveBannerAdSizeWithWidth(CGFloat width)

• GADLandscapeInlineAdaptiveBannerAdSizeWithWidth(CGFloat width)

إذا كان تطبيقك يتيح العرض في الوضعَين العمودي والأفقي، وأردت تحميل إعلان بانر تكيُّفي مسبقًا في التنسيق الحالي، استخدِم الطريقة GADCurrentOrientationInlineAdaptiveBannerAdSizeWithWidth(CGFloat width). تُحمّل هذه الطريقة إعلانًا في التنسيق الحالي.

الحدّ من ارتفاع "إعلان البانر التكيُّفي المضمّن"

بشكلٍ تلقائي، يكون الحدّ الأقصى لارتفاع "إعلانات البانر التكيُّفية" المضمّنة التي تم إنشاؤها بدون قيمة maxHeight مساويًا لارتفاع الجهاز. للحدّ من ارتفاع إعلان البانر التكيُّفي المضمّن، استخدِم الطريقة GADInlineAdaptiveBannerAdSizeWithWidthAndMaxHeight(CGFloat width, CGFloat maxHeight).