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

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

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

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

قبل البدء

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

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

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

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