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

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

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

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

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

قبل البدء

قبل المتابعة، تأكَّد من توفّر ما يلي:

  • حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة 8.10.0 أو إصدار أحدث
  • أكمل دليل البدء، إعلانات البانر.

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

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

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

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

Swift 

// Step 1: Create an inline adaptive banner ad size. This size is used to
// request your adaptive banner. You can pass in the width of the device, or
// set your own width. This example sets a static width.
let adSize = GADCurrentOrientationInlineAdaptiveBannerAdSizeWithWidth(320)
// Step 2: Create banner with the inline size and set ad unit ID.
let bannerView = GAMBannerView(adSize: adSize)
bannerView.adUnitID = "<var>ad unit ID</var>"
bannerView.rootViewController = self

// For Ad Manager, the `adSize` property is used for the adaptive banner ad
// size. The `validAdSizes` property is used as normal for the supported
// reservation sizes for the ad placement.
bannerView.validAdSizes = [NSValueFromGADAdSize(GADAdSizeBanner)]

// Step 3: Load an ad.
let request = GAMRequest()
bannerView.load(request)
// TODO: Insert banner view in table view or scroll view, etc.

Objective-C 

// Step 1: Create an inline adaptive banner ad size. This size is used to
// request your adaptive banner. You can pass in the width of the device, or set
// your own width. This example sets a static width.
GADAdSize *adSize = GADCurrentOrientationInlineAdaptiveBannerAdSizeWithWidth(320);
// Step 2: Create banner with the inline size and set ad unit ID.
GAMBannerView bannerView = [[GAMBannerView alloc] initWithAdSize:adSize];
bannerView.adUnitID = @"<var>ad unit ID</var>";
bannerView.rootViewController = self;

// For Ad Manager, the adSize property is used for the adaptive banner ad size.
// The validAdSizes property is used as normal for the supported reservation
// sizes for the ad placement. This is optional and only needed if you wish to
// support reservation ad sizes.
bannerView.validAdSizes = @[ NSValueFromGADAdSize(GADAdSizeBanner) ];

// Step 3: Load an ad.
GAMRequest *request = [GAMRequest request];
[bannerView loadRequest:request];
// TODO: Insert banner view in table view or scroll view, etc.

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

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

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

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

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

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

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

مراجع إضافية

أمثلة على GitHub

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

Swift Objective-C