إعلانات البانر هي إعلانات مستطيلة تشغل جزءًا من تصميم التطبيق. هم البقاء على الشاشة أثناء تفاعل المستخدمين مع التطبيق، سواء في أعلى أو أسفل الشاشة أو مضمنة مع المحتوى أثناء قيام المستخدم بالتمرير. يمكن إعادة تحميل إعلانات البنر تلقائيًا بعد فترة زمنية محدّدة. الاطّلاع على نظرة عامة على إعلانات البانر لمزيد من المعلومات.
يوضِّح لك هذا الدليل كيفية بدء استخدام إعلان البانر التكيُّفي الثابت. للإعلانات، ما يؤدي إلى تحسين الأداء إلى أقصى حدّ من خلال تحسين حجم الإعلان لكل جهاز باستخدام عرض السعر الذي تحدّده
إعلان بانر تكيُّفي ثابت
إعلانات البانر التكيُّفية الثابتة هي إعلانات بنسبة عرض إلى ارتفاع ثابتة، وليست الإعلانات العادية إعلانات ذات حجم ثابت. وتشبه نسبة العرض إلى الارتفاع المعيار المتّبع في المجال 320×50. مرة واحدة الذي حددت فيه العرض الكامل المتاح، فسيعرض إعلانًا بالارتفاع الأمثل بهذا العرض. لا يتغيّر الارتفاع الأمثل للإعلان في الطلبات الواردة من الجهاز نفسه، ولا يلزم نقل العروض المحيطة عند إعادة تحميل الإعلان.
المتطلبات الأساسية
- أكمِل دليل البدء.
إجراء الاختبار دائمًا باستخدام الإعلانات الاختبارية
عند إنشاء تطبيقاتك واختبارها، احرص على استخدام إعلانات اختبارية بدلاً من الإعلانات المنشورة. وقد يؤدي عدم تنفيذ ذلك إلى تعليق حسابك.
إنّ أسهل طريقة لتحميل الإعلانات التجريبية هي استخدام رقم تعريف الوحدة الإعلانية الاختبارية المخصّص لإعلانات بانر iOS:
ca-app-pub-3940256099942544/2435281174
لقد تم إعدادها خصيصًا لعرض إعلانات اختبارية لكل طلب، يمكن استخدامها مجانًا في تطبيقاتك الخاصة أثناء الترميز والاختبار وتصحيح الأخطاء. ما عليك سوى إجراء واحرص على استبداله بمعرّف وحدتك الإعلانية قبل نشر تطبيقك.
لمزيد من المعلومات عن آلية عمل الإعلانات الاختبارية لحزمة "SDK لإعلانات Google على الأجهزة الجوّالة"، اطّلِع على الإعلانات الاختبارية .
إنشاء GADBannerView
يتم عرض إعلانات البانر في عناصر GADBannerView
، لذا فإنّ الخطوة الأولى نحو دمج إعلانات البانر هي تضمين GADBannerView
في التدرّج الهرمي للعرض. يتم ذلك عادةً إما آليًا أو
من خلال أداة إنشاء الواجهات
آليًا
ويمكن أيضًا إنشاء مثيل GADBannerView
مباشرةً.
ينشئ المثال التالي GADBannerView
:
Swift
import GoogleMobileAds
import UIKit
class ViewController: UIViewController {
var bannerView: GADBannerView!
override func viewDidLoad() {
super.viewDidLoad()
let viewWidth = view.frame.inset(by: view.safeAreaInsets).width
// Here the current interface orientation is used. Use
// GADLandscapeAnchoredAdaptiveBannerAdSizeWithWidth or
// GADPortraitAnchoredAdaptiveBannerAdSizeWithWidth if you prefer to load an ad of a
// particular orientation,
let adaptiveSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(viewWidth)
bannerView = GADBannerView(adSize: adaptiveSize)
addBannerViewToView(bannerView)
}
func addBannerViewToView(_ bannerView: GADBannerView) {
bannerView.translatesAutoresizingMaskIntoConstraints = false
view.addSubview(bannerView)
// This example doesn't give width or height constraints, as the provided
// ad size gives the banner an intrinsic content size to size the view.
view.addConstraints(
[NSLayoutConstraint(item: bannerView,
attribute: .bottom,
relatedBy: .equal,
toItem: view.safeAreaLayoutGuide,
attribute: .bottom,
multiplier: 1,
constant: 0),
NSLayoutConstraint(item: bannerView,
attribute: .centerX,
relatedBy: .equal,
toItem: view,
attribute: .centerX,
multiplier: 1,
constant: 0)
])
}
}
واجهة المستخدم
لاستخدام GADBannerView
، يجب إنشاء UIViewRepresentable
:
private struct BannerView: UIViewRepresentable {
let adSize: GADAdSize
init(_ adSize: GADAdSize) {
self.adSize = adSize
}
func makeUIView(context: Context) -> UIView {
// Wrap the GADBannerView in a UIView. GADBannerView automatically reloads a new ad when its
// frame size changes; wrapping in a UIView container insulates the GADBannerView from size
// changes that impact the view returned from makeUIView.
let view = UIView()
view.addSubview(context.coordinator.bannerView)
return view
}
func updateUIView(_ uiView: UIView, context: Context) {
context.coordinator.bannerView.adSize = adSize
}
func makeCoordinator() -> BannerCoordinator {
return BannerCoordinator(self)
}
لإدارة إعداد وسلوك GADBannerView
، يمكنك إنشاء
Coordinator
:
class BannerCoordinator: NSObject, GADBannerViewDelegate {
private(set) lazy var bannerView: GADBannerView = {
let banner = GADBannerView(adSize: parent.adSize)
banner.adUnitID = "ca-app-pub-3940256099942544/2435281174"
banner.load(GADRequest())
banner.delegate = self
return banner
}()
let parent: BannerView
init(_ parent: BannerView) {
self.parent = parent
}
للحصول على عرض العرض، استخدِم GeometryReader
. هذا الصف
تحسب حجم الإعلان المناسب لاتجاه الجهاز الحالي. يتم ضبط
frame
على الارتفاع المحسوب من حجم الإعلان.
var body: some View {
GeometryReader { geometry in
let adSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(geometry.size.width)
VStack {
Spacer()
BannerView(adSize)
.frame(height: adSize.size.height)
}
}
Objective-C
لاحظ أننا في هذه الحالة لا نضع قيودًا على العرض أو الارتفاع، حيث إن وفقًا لحجم الإعلان، سيُمنح البانر حجم محتوى أساسيًا لتحديد حجم مشاهدة.
@import GoogleMobileAds;
@interface ViewController ()
@property(nonatomic, strong) GADBannerView *bannerView;
@end
@implementation ViewController
- (void)viewDidLoad {
[super viewDidLoad];
// Here safe area is taken into account, hence the view frame is used after the
// view has been laid out.
CGRect frame = UIEdgeInsetsInsetRect(self.view.frame, self.view.safeAreaInsets);
CGFloat viewWidth = frame.size.width;
// Here the current interface orientation is used. If the ad is being preloaded
// for a future orientation change or different orientation, the function for the
// relevant orientation should be used.
GADAdSize adaptiveSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(viewWidth);
// In this case, we instantiate the banner with desired ad size.
self.bannerView = [[GADBannerView alloc] initWithAdSize:adaptiveSize];
[self addBannerViewToView:self.bannerView];
}
- (void)addBannerViewToView:(UIView *)bannerView {
bannerView.translatesAutoresizingMaskIntoConstraints = NO;
[self.view addSubview:bannerView];
// This example doesn't give width or height constraints, as the provided
// ad size gives the banner an intrinsic content size to size the view.
[self.view addConstraints:@[
[NSLayoutConstraint constraintWithItem:bannerView
attribute:NSLayoutAttributeBottom
relatedBy:NSLayoutRelationEqual
toItem:self.view.safeAreaLayoutGuide
attribute:NSLayoutAttributeBottom
multiplier:1
constant:0],
[NSLayoutConstraint constraintWithItem:bannerView
attribute:NSLayoutAttributeCenterX
relatedBy:NSLayoutRelationEqual
toItem:self.view
attribute:NSLayoutAttributeCenterX
multiplier:1
constant:0]
]];
}
@end
أداة إنشاء الواجهات
يمكنك إضافة GADBannerView
إلى لوحة قصة أو ملف xib. عند استخدام هذه
الطريقة، احرص على إضافة قيود مواضع الإعلانات على البانر فقط. على سبيل المثال، عند عرض إعلان بانر تكيُّفي في أسفل الشاشة، اضبط الجزء السفلي
لعرض البانر على أنّه يساوي الجزء العلوي من دليل التنسيق السفلي، واضبطcenterX
القيود على أنّها تساوي centerX
لعرض الإعلان الفائق.
لا يزال حجم إعلان البانر يتم ضبطه آليًا:
Swift
bannerView.adSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(viewWidth)
Objective-C
self.bannerView.adSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(viewWidth);
تحميل إعلان
بعد وضع GADBannerView
وخصائصها.
مهيأ، يحين وقت تحميل إعلان. ويتم ذلك من خلال استدعاء loadRequest:
على كائن
GADRequest
:
Swift
override func viewDidLoad() {
super.viewDidLoad()
// Set the ad unit ID and view controller that contains the GADBannerView.
bannerView.adUnitID = "ca-app-pub-3940256099942544/2435281174"
bannerView.rootViewController = self
bannerView.load(GADRequest())
}
SwiftUI
banner.adUnitID = "ca-app-pub-3940256099942544/2435281174"
banner.load(GADRequest())
Objective-C
- (void)viewDidLoad {
[super viewDidLoad];
// Set the ad unit ID and view controller that contains the GADBannerView.
self.bannerView.adUnitID = @"ca-app-pub-3940256099942544/2435281174";
self.bannerView.rootViewController = self;
[self.bannerView loadRequest:[GADRequest request]];
}
تمثّل عناصر GADRequest طلب إعلان واحدًا، وتحتوي على سمات لعناصر مثل معلومات الاستهداف.
إذا تعذّر تحميل إعلانك، ليس عليك طلب إعلان آخر صراحةً طالما أنّك أعددت وحدتك الإعلانية لإعادة التحميل، لأنّ حزمة تطوير البرامج (SDK) لـ "إعلانات Google" للأجهزة الجوّالة تمتثل لأي معدّل إعادة تحميل حدّدته في واجهة مستخدم AdMob. إذا لم تكن قد فعّلت ميزة "إعادة التحميل"، عليك تقديم طلب جديد.
أحداث الإعلانات
وتتيح لكم "GADBannerViewDelegate
" الاطّلاع على آخر الأحداث في مختلف مراحل النشاط،
مثلاً، عندما يتم إغلاق إعلان أو عندما يغادر المستخدم التطبيق
التسجيل في أحداث البانر
للتسجيل في أحداث إعلانات البانر، اضبط سمة delegate
في
GADBannerView
على عنصر ينفِّذ بروتوكول
GADBannerViewDelegate
. بشكل عام، الفئة التي تنفّذ إعلانات البانر
تؤدي الإعلانات أيضًا صفة المفوَّض، وفي هذه الحالة، يمكن للسمة delegate
يمكن ضبطها على self
.
Swift
import GoogleMobileAds
import UIKit
class ViewController: UIViewController, GADBannerViewDelegate {
var bannerView: GADBannerView!
override func viewDidLoad() {
super.viewDidLoad()
// ...
bannerView.delegate = self
}
}
SwiftUI
banner.delegate = self
Objective-C
@import GoogleMobileAds;
@interface ViewController () <GADBannerViewDelegate>
@property(nonatomic, strong) GADBannerView *bannerView;
@end
@implementation ViewController
- (void)viewDidLoad {
[super viewDidLoad];
// ...
self.bannerView.delegate = self;
}
تنفيذ أحداث إعلانات البانر
يتم تصنيف كل طريقة من الطرق في GADBannerViewDelegate
على أنّها اختيارية، وبالتالي يمكنك
فقط إلى تنفيذ الطرق التي تريدها. ينفِّذ هذا المثال كل طريقة ويُسجِّل رسالة في وحدة التحكّم:
Swift
func bannerViewDidReceiveAd(_ bannerView: GADBannerView) {
print("bannerViewDidReceiveAd")
}
func bannerView(_ bannerView: GADBannerView, didFailToReceiveAdWithError error: Error) {
print("bannerView:didFailToReceiveAdWithError: \(error.localizedDescription)")
}
func bannerViewDidRecordImpression(_ bannerView: GADBannerView) {
print("bannerViewDidRecordImpression")
}
func bannerViewWillPresentScreen(_ bannerView: GADBannerView) {
print("bannerViewWillPresentScreen")
}
func bannerViewWillDismissScreen(_ bannerView: GADBannerView) {
print("bannerViewWillDIsmissScreen")
}
func bannerViewDidDismissScreen(_ bannerView: GADBannerView) {
print("bannerViewDidDismissScreen")
}
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");
}
الاطّلاع على مثال "مفوَّض الإعلانات" لمعرفة كيفية تنفيذ طرق تفويض إعلانات البانر في التطبيق التجريبي لواجهة برمجة تطبيقات iOS.
حالات الاستخدام
في ما يلي بعض أمثلة حالات الاستخدام لهذه الطرق لأحداث الإعلانات.
إضافة بانر إلى العرض الهرمي للعرض بعد تلقّي الإعلان
يمكنك تأخير إضافة GADBannerView
إلى
التسلسل الهرمي للعرض إلى أن يتم تلقّي الإعلان يمكنك إجراء ذلك من خلال الاستماع
إلى حدث bannerViewDidReceiveAd:
:
Swift
func bannerViewDidReceiveAd(_ bannerView: GADBannerView) {
// 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: GADBannerView) {
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
.
لتسجيل جميع أنواع العروض التقديمية المركّبة أو استدعاءات المتصفح الخارجي، لا
فقط تلك التي تأتي من النقرات على الإعلانات، يكون من الأفضل لتطبيقك أن يستمع
طرق مماثلة في UIViewController
أو UIApplication
. إليك جدول
طرق iOS المكافئة التي تم استدعاؤها في الوقت نفسه
طريقتان (GADBannerViewDelegate
):
طريقة GADBannerViewDelegate | طريقة iOS |
---|---|
bannerViewWillPresentScreen: |
viewWillDisappear: في UIViewController |
bannerViewWillDismissScreen: |
viewWillAppear: من UIViewController |
bannerViewDidDismissScreen: |
viewDidAppear: من UIViewController |
مراجع إضافية
أمثلة على GitHub
- مثال على إعلانات البانر التكيّفية الثابتة: Swift | SwiftUI | Objective-C
- عرض توضيحي للميزات المتقدمة: Swift | Objective-C
الخطوات التالية
إعلانات البانر القابلة للتصغير
إعلانات البانر القابلة للتصغير هي إعلانات بانر يتم عرضها في البداية كإعلانات بحجم أكبر مع زر لتصغير الإعلان إلى حجم أصغر. ننصحك باستخدامه لتحسين أدائك بشكلٍ أكبر اطّلِع على إعلانات البانر القابلة للتصغير للحصول على مزيد من التفاصيل.
إعلانات البانر التكيّفية المضمّنة
إعلانات البانر التكيُّفية المضمّنة هي إعلانات بانر أكبر وأطول مقارنةً بإعلانات البانر التكيُّفية الثابتة. إعلانات البانر. ويكون ارتفاعها متغيرًا، ويمكن أن يكون بطول شاشة الجهاز. ننصحك باستخدام إعلانات البانر التكيّفية المضمّنة بدلاً من إعلانات البانر التكيّفية الثابتة في التطبيقات التي تضع إعلانات البانر في محتوى قابل للتصفّح. الاطّلاع على الصفحة التكيُّفية المضمّنة إعلانات بانر لمزيد من التفاصيل.