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

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

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

يمكنك وضع إعلانات البانر التكيُّفية المضمَّنة في محتوى التمرير، على سبيل المثال:

قبل البدء

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

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

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

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

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

Java

// 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.
AdView bannerView = new AdView(this);
bannerView.setAdUnitId("ad unit ID");
bannerView.setAdSize(adSize);

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

Kotlin

// 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 = AdView(this)
bannerView.adUnitId = "ad unit ID"
bannerView.setAdSize(adSize)

// Step 3: Load an ad.
val adRequest = AdRequest.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