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

تتيح لك إعلانات البانر التكيُّفية تحديد عرض الإعلان لتحديد حجم الإعلان الأمثل. تساهم إعلانات البانر التكيُّفية أيضًا في تحسين الأداء إلى أقصى حد من خلال تحسين حجم الإعلان لكل جهاز. يؤدّي هذا النهج إلى فرص لتحسين الأداء.

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

يمكنك وضع إعلانات البانر التكيّفية المضمّنة في المحتوى الذي يمكن تصفّحه بالانتقال للأعلى والأسفل، على سبيل المثال:

قبل البدء

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

تنفيذ إعلانات البانر التكيّفية

على عكس إعلانات البانر التكيُّفية الثابتة، يتم تحميل إعلانات البانر التكيُّفية المضمّنة باستخدام حجم إعلان بانر تكيُّفي مضمّن. لإنشاء حجم إعلان متغيّر مضمّن، أكمِل الخطوات التالية:

1. يمكنك الحصول على عرض الجهاز المستخدَم، أو ضبط العرض الذي تريده إذا لم تكن تريد استخدام العرض الكامل للشاشة.
2. استخدِم الطرق الثابتة المناسبة في فئة حجم الإعلان، مثل AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(Context context, int width) للحصول على عنصر حجم إعلان متوافق مضمّن للاتجاه المحدّد.
3. إذا أردت وضع حدّ أقصى لارتفاع البانر، استخدِم الطريقة الثابتة AdSize.getInlineAdaptiveBannerAdSize(int width, int maxHeight) .

يوضّح المثال التالي هذه الخطوات:

// Step 1: Create an inline adaptive banner ad size using the activity context.
AdSize adSize = AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(this, 320);

// Step 2: Create banner using activity context and set the inline ad size and
// ad unit ID.
AdManagerAdView bannerView = new AdManagerAdView(this);
bannerView.setAdUnitId("ad unit ID");

// Note that this sets both the adaptive ad size for backfill inventory as well
// as the supported reservation sizes.
bannerView.setAdSizes(adSize, AdSize.BANNER);

// Step 3: Load an ad.
AdManagerAdRequest adRequest = new AdManagerAdRequest.Builder().build();
bannerView.loadAd(adRequest);
// TODO: Insert banner view in list view or scroll view, etc.

// Step 1: Create an inline adaptive banner ad size using the activity context.
val adSize = AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(this, 320)

// Step 2: Create banner using activity context and set the inline ad size and
// ad unit ID.
val bannerView = AdManagerAdView(this)
bannerView.adUnitId = "ad unit ID"

// Note that this sets both the adaptive ad size for backfill inventory as well
// as the supported reservation sizes.
bannerView.setAdSizes(adSize, AdSize.BANNER)

// Step 3: Load an ad.
val adRequest = AdManagerAdRequest.Builder().build()
bannerView.loadAd(adRequest)
// TODO: Insert banner view in list view or scroll view, etc.

عند تنفيذ إعلانات البانر التكيُّفية في تطبيقك، يُرجى مراعاة النقاط التالية:

• تعمل أحجام إعلانات البانر التكيُّفية المضمّنة على أفضل نحو عند استخدام العرض المتاح بالكامل. في معظم الحالات، يكون هذا الحجم هو العرض الكامل لشاشة الجهازقيد الاستخدام، أو العرض الكامل للمحتوى الرئيسي للإعلان البانر. يجب معرفة عرض المشهد الذي تريد وضعه في الإعلان وعرض الجهاز وعرض المحتوى الرئيسي والمناطق الآمنة السارية.

• قد تحتاج إلى تعديل عناصر إعلان جديدة أو إنشاؤها للعمل مع أحجام الإعلانات المتغيّرة. مزيد من المعلومات

توجيه حجم إعلان البانر التكيُّفي المضمّن

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

• AdSize.getPortraitInlineAdaptiveBannerAdSize(Context context, int width)

• AdSize.getLandscapeInlineAdaptiveBannerAdSize(Context context, int width)

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

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

بشكلٍ تلقائي، تكون قيمة maxHeight لإعلانات البانر التكيُّفية المضمّنة التي تمّ إنشاؤها بدون قيمة maxHeight تساوي ارتفاع الجهاز. لتقييد ارتفاع إعلان البانر التكيُّفي المضمّن، استخدِم الأسلوب AdSize.getInlineAdaptiveBannerAdSize(int width, int maxHeight).

مراجع إضافية

أمثلة على GitHub

نزِّل نموذج التطبيق للاطّلاع على إعلانات البانر التكيّفية المضمّنة أثناء عرضها.

Java Kotlin