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

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

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

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

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

قبل البدء

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

  • حزمة تطوير البرامج (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