إعلانات البانر

اختيار النظام الأساسي: Android iOS Unity Flutter

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

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

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

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

المتطلبات الأساسية

إجراء الاختبار دائمًا باستخدام إعلانات اختبارية

عند إنشاء تطبيقاتك واختبارها، احرص على استخدام إعلانات اختبارية بدلاً من الإعلانات المنشورة. وقد يؤدي عدم إجراء ذلك إلى تعليق حسابك.

إنّ الطريقة الأسهل لتحميل الإعلانات التجريبية هي استخدام رقم تعريف الوحدة الإعلانية الاختبارية المخصّص لإعلانات بانر iOS:

ca-app-pub-3940256099942544/2435281174

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

لمزيد من المعلومات عن آلية عمل الإعلانات الاختبارية لحزمة "SDK لإعلانات Google على الأجهزة الجوّالة"، اطّلِع على الإعلانات الاختبارية.

أنشئ GADBannerView.

يتم عرض إعلانات البانر في عناصر GADBannerView ، لذا فإنّ الخطوة الأولى نحو دمج إعلانات البانر هي تضمين GADBannerView في التدرّج الهرمي للعرض. ويتم ذلك عادةً إما آليًا أو من خلال Interface Builder.

آليًا

يمكن أيضًا إنشاء مثيل GADBannerView مباشرةً. ينشئ المثال التالي GADBannerView:

Swift

// Initialize the BannerView.
bannerView = BannerView()

bannerView.translatesAutoresizingMaskIntoConstraints = false
view.addSubview(bannerView)

// This example doesn't give width or height constraints, as the ad size gives the banner an
// intrinsic content size to size the view.
NSLayoutConstraint.activate([
  // Align the banner's bottom edge with the safe area's bottom edge
  bannerView.bottomAnchor.constraint(equalTo: view.safeAreaLayoutGuide.bottomAnchor),
  // Center the banner horizontally in the view
  bannerView.centerXAnchor.constraint(equalTo: view.centerXAnchor),
])
BannerSnippets.swift

SwiftUI

لاستخدام BannerView، أنشئ UIViewRepresentable:

private struct BannerViewContainer: UIViewRepresentable {
  typealias UIViewType = BannerView
  let adSize: AdSize

  init(_ adSize: AdSize) {
    self.adSize = adSize
  }

  func makeUIView(context: Context) -> BannerView {
    let banner = BannerView(adSize: adSize)
    banner.adUnitID = "ca-app-pub-3940256099942544/2435281174"
    banner.load(Request())
    banner.delegate = context.coordinator
    return banner
  }

  func updateUIView(_ uiView: BannerView, context: Context) {}

  func makeCoordinator() -> BannerCoordinator {
    return BannerCoordinator(self)
  }
BannerContentView.swift

أضِف UIViewRepresentable إلى التسلسل الهرمي للعرض، مع تحديد قيم height و width:

var body: some View {
  Spacer()
  // Request an anchored adaptive banner with a width of 375.
  let adSize = currentOrientationAnchoredAdaptiveBanner(width: 375)
  BannerViewContainer(adSize)
    .frame(width: adSize.size.width, height: adSize.size.height)
}
BannerContentView.swift

Objective-C

// Initialize the GADBannerView.
self.bannerView = [[GADBannerView alloc] init];

self.bannerView.translatesAutoresizingMaskIntoConstraints = NO;
[self.view addSubview:self.bannerView];

// This example doesn't give width or height constraints, as the ad size gives the banner an
// intrinsic content size to size the view.
[NSLayoutConstraint activateConstraints:@[
    // Align the banner's bottom edge with the safe area's bottom edge
    [self.bannerView.bottomAnchor constraintEqualToAnchor:self.view.safeAreaLayoutGuide.bottomAnchor],
    // Center the banner horizontally in the view
    [self.bannerView.centerXAnchor constraintEqualToAnchor:self.view.centerXAnchor],
]];
BannerSnippets.m

Interface Builder

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

لا يزال يتمّ ضبط حجم إعلان البانر آليًا:

Swift

// Request an anchored adaptive banner with a width of 375.
bannerView.adSize = currentOrientationAnchoredAdaptiveBanner(width: 375)
ViewController.swift

Objective-C

// Request an anchored adaptive banner with a width of 375.
self.bannerView.adSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(375);
ViewController.m

تحميل إعلان

بعد أن يتمّ وضع GADBannerView وضبط خصائصه، مثل adUnitID، حان وقت تحميل إعلان. ويتم ذلك من خلال استدعاء loadRequest: على عنصر GADRequest:

Swift

bannerView.load(Request())
ViewController.swift

SwiftUI

banner.adUnitID = "ca-app-pub-3940256099942544/2435281174"
banner.load(Request())
BannerContentView.swift

Objective-C

[self.bannerView loadRequest:[GADRequest request]];
ViewController.m

تمثّل عناصر GADRequest طلب إعلان واحدًا، وتتضمّن سمات لأشياء مثل معلومات الاستهداف.

إعادة تحميل إعلان

إذا أعددت وحدتك الإعلانية لإعادة التحميل، لن تحتاج إلى طلب إعلان آخر عند تعذُّر تحميل الإعلان. تلتزم حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" بأيّ معدّل تحديث حدّدته في واجهة مستخدم AdMob. إذا لم تكن قد فعّلت ميزة الصعق الكهربي، قدِّم طلبًا جديدًا. لمزيد من التفاصيل حول إعادة تحميل الوحدات الإعلانية، مثل ضبط معدّل إعادة التحميل، اطّلِع على استخدام ميزة إعادة التحميل التلقائية لإعلانات البانر.

أحداث الإعلانات

من خلال استخدام GADBannerViewDelegate، يمكنك الاستماع إلى أحداث دورة النشاط، مثل إغلاق إعلان أو مغادرة المستخدم للتطبيق.

التسجيل في أحداث إعلانات البانر

للتسجيل في أحداث إعلانات البانر، اضبط سمة delegate في GADBannerView على عنصر ينفِّذ بروتوكول GADBannerViewDelegate. بشكل عام، تعمل الفئة التي تنفِّذ إعلانات البانر كفئات مفوَّضة أيضًا، وفي هذه الحالة، يمكن ضبط السمة delegate على self.

Swift

bannerView.delegate = self
ViewController.swift

SwiftUI

banner.delegate = context.coordinator
BannerContentView.swift

Objective-C

self.bannerView.delegate = self;
ViewController.m

تنفيذ أحداث إعلانات البانر

تم وضع علامة اختيارية على كل طريقة من الطرق الواردة في GADBannerViewDelegate، لذا ما عليك سوى تنفيذ الطرق التي تريدها. ينفِّذ هذا المثال كل طريقة ويُسجِّل رسالة في وحدة التحكّم:

Swift

func bannerViewDidReceiveAd(_ bannerView: BannerView) {
  print(#function)
}

func bannerView(_ bannerView: BannerView, didFailToReceiveAdWithError error: Error) {
  print(#function + ": " + error.localizedDescription)
}

func bannerViewDidRecordClick(_ bannerView: BannerView) {
  print(#function)
}

func bannerViewDidRecordImpression(_ bannerView: BannerView) {
  print(#function)
}

func bannerViewWillPresentScreen(_ bannerView: BannerView) {
  print(#function)
}

func bannerViewWillDismissScreen(_ bannerView: BannerView) {
  print(#function)
}

func bannerViewDidDismissScreen(_ bannerView: BannerView) {
  print(#function)
}
ViewController.swift

Objective-C

- (void)bannerViewDidReceiveAd:(GADBannerView *)bannerView {
  NSLog(@"bannerViewDidReceiveAd");
}

- (void)bannerView:(GADBannerView *)bannerView didFailToReceiveAdWithError:(NSError *)error {
  NSLog(@"bannerView:didFailToReceiveAdWithError: %@", [error localizedDescription]);
}

- (void)bannerViewDidRecordImpression:(GADBannerView *)bannerView {
  NSLog(@"bannerViewDidRecordImpression");
}

- (void)bannerViewWillPresentScreen:(GADBannerView *)bannerView {
  NSLog(@"bannerViewWillPresentScreen");
}

- (void)bannerViewWillDismissScreen:(GADBannerView *)bannerView {
  NSLog(@"bannerViewWillDismissScreen");
}

- (void)bannerViewDidDismissScreen:(GADBannerView *)bannerView {
  NSLog(@"bannerViewDidDismissScreen");
}
ViewController.m

اطّلِع على مثال "مفوّض الإعلانات" لتنفيذ طرق مفوّض إعلانات البانر في تطبيق iOS API Demo.

Swift Objective-C

حالات الاستخدام

في ما يلي بعض أمثلة حالات الاستخدام لهذه الطرق المتعلّقة بأحداث الإعلانات.

إضافة بانر إلى التسلسل الهرمي للعرض بعد تلقّي إعلان

قد تحتاج إلى تأخير إضافة GADBannerView إلى تسلسل عرض الإعلانات إلى أن يتم استلام إعلان. يمكنك إجراء ذلك من خلال الاستماع إلى حدث bannerViewDidReceiveAd::

Swift

func bannerViewDidReceiveAd(_ bannerView: BannerView) {
  // Add banner to view and add constraints.
  addBannerViewToView(bannerView)
}

Objective-C

- (void)bannerViewDidReceiveAd:(GADBannerView *)bannerView {
  // Add bannerView to view and add constraints as above.
  [self addBannerViewToView:self.bannerView];
}

إضافة حركة إلى إعلان بانر

يمكنك أيضًا استخدام الحدث bannerViewDidReceiveAd: لإضافة تأثيرات متحركة إلى إعلان البانر بعد عرضه، كما هو موضّح في المثال التالي:

Swift

func bannerViewDidReceiveAd(_ bannerView: BannerView) {
  bannerView.alpha = 0
  UIView.animate(withDuration: 1, animations: {
    bannerView.alpha = 1
  })
}

Objective-C

- (void)bannerViewDidReceiveAd:(GADBannerView *)bannerView {
  bannerView.alpha = 0;
  [UIView animateWithDuration:1.0 animations:^{
    bannerView.alpha = 1;
  }];
}

إيقاف التطبيق مؤقتًا واستئناف تشغيله

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

لرصد جميع أنواع العروض التراكبية أو عمليات تشغيل المتصفّح الخارجي، وليس فقط تلك التي تأتي من النقرات على الإعلانات، من الأفضل أن يستمع تطبيقك إلى methods المكافئة على UIViewController أو UIApplication. في ما يلي جدول يعرض طرق iOS المماثلة التي يتمّ استدعاؤها في الوقت نفسه مع طرق GADBannerViewDelegate:

طريقة GADBannerViewDelegate طريقة iOS
bannerViewWillPresentScreen: viewWillDisappear: في UIViewController
bannerViewWillDismissScreen: viewWillAppear: في UIViewController
bannerViewDidDismissScreen: viewDidAppear: في UIViewController

مراجع إضافية

أمثلة على GitHub

الخطوات التالية

إعلانات البانر القابلة للتصغير

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

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

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

استكشاف مواضيع أخرى