إعلانات البانر هي إعلانات مستطيلة تشغل جزءًا من تصميم التطبيق. وتظل معروضة على الشاشة أثناء تفاعل المستخدمين مع التطبيق، سواء في الجزء العلوي أو السفلي من الشاشة أو مضمَّنة مع المحتوى أثناء تمرير الشاشة. يمكن إعادة تحميل إعلانات البنر تلقائيًا بعد فترة زمنية محدّدة. اطّلِع على نظرة عامة على إعلانات البانر لمزيد من المعلومات.
يوضّح لك هذا الدليل كيفية بدء استخدام إعلانات البانر التكيُّفية المرسَلة، التي تحقّق أفضل أداء من خلال تحسين حجم الإعلان لكل جهاز باستخدام عرض إعلان تحدّده.
إعلان بانر تكيُّفي ثابت
إعلانات البانر التكيّفية الثابتة هي إعلانات بنِسب عرض إلى ارتفاع ثابتة بدلاً من إعلانات الحجم الثابت العادية. تكون نسبة العرض إلى الارتفاع مشابهة للمعيار المتّبع في المجال والذي يبلغ 320×50. بعد تحديد العرض الكامل المتاح، يتم عرض إعلان بالارتفاع الأمثل لعرضه. لا يتغيّر الارتفاع الأمثل للإعلان في الطلبات الواردة من الجهاز نفسه، ولا يلزم نقل العروض المحيطة عند إعادة تحميل الإعلان.
المتطلبات الأساسية
- أكمِل دليل البدء.
إجراء الاختبار دائمًا باستخدام الإعلانات الاختبارية
عند إنشاء تطبيقاتك واختبارها، احرص على استخدام إعلانات اختبارية بدلاً من الإعلانات المنشورة. وقد يؤدي عدم إجراء ذلك إلى تعليق حسابك.
إنّ الطريقة الأسهل لتحميل الإعلانات التجريبية هي استخدام رقم تعريف الوحدة الإعلانية الاختبارية المخصّص لإعلانات بانر iOS:
/21775744923/example/adaptive-banner
تم إعداده خصيصًا لعرض إعلانات اختبارية لكل طلب، ويمكنك استخدامه في تطبيقاتك أثناء الترميز والاختبار وتحديد الأخطاء وإصلاحها. ما عليك سوى التأكّد من استبداله بمعرّف وحدتك الإعلانية قبل نشر تطبيقك.
لمزيد من المعلومات عن آلية عمل الإعلانات الاختبارية لحزمة "SDK لإعلانات Google على الأجهزة الجوّالة"، اطّلِع على الإعلانات الاختبارية.
إنشاء GAMBannerView
يتم عرض إعلانات البانر في عناصر GAMBannerView
، لذا فإنّ الخطوة الأولى نحو دمج إعلانات البانر هي تضمين GAMBannerView
في التدرّج الهرمي للعرض. ويتم ذلك عادةً إما آليًا أو
من خلال Interface Builder.
آليًا
يمكن أيضًا إنشاء مثيل GAMBannerView
مباشرةً.
ينشئ المثال التالي GAMBannerView
:
Swift
import GoogleMobileAds
import UIKit
class ViewController: UIViewController {
var bannerView: GAMBannerView!
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 = GAMBannerView(adSize: adaptiveSize)
addBannerViewToView(bannerView)
}
func addBannerViewToView(_ bannerView: GAMBannerView) {
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)
])
}
}
SwiftUI
لاستخدام GAMBannerView
، أنشئ 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)
}
لإدارة عملية الإعداد وسلوك GAMBannerView
، أنشئ ملفًا من نوع
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) GAMBannerView *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 = [[GAMBannerView 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
Interface Builder
يمكنك إضافة GAMBannerView
إلى لوحة قصة أو ملف xib. عند استخدام هذه
الطريقة، احرص على إضافة قيود مواضع على البانر فقط. على سبيل المثال، عند عرض إعلان بانر تكيُّفي في أسفل الشاشة، اضبط الجزء السفلي
لعرض البانر على أنّه يساوي الجزء العلوي من دليل التنسيق السفلي، واضبطcenterX
القيود على أنّها تساوي centerX
لعرض البانر.
لا يزال يتمّ ضبط حجم إعلان البانر آليًا:
Swift
bannerView.adSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(viewWidth)
Objective-C
self.bannerView.adSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(viewWidth);
تحميل إعلان
بعد وضع GAMBannerView
وضبط خصائصه، حان وقت تحميل إعلان. ويتم ذلك من خلال استدعاء loadRequest:
على كائن
GAMRequest
:
Swift
override func viewDidLoad() {
super.viewDidLoad()
// Set the ad unit ID and view controller that contains the GAMBannerView.
bannerView.adUnitID = "/21775744923/example/adaptive-banner"
bannerView.rootViewController = self
bannerView.load(GAMRequest())
}
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 GAMBannerView.
self.bannerView.adUnitID = @"/21775744923/example/adaptive-banner";
self.bannerView.rootViewController = self;
[self.bannerView loadRequest:[GAMRequest request]];
}
تمثّل عناصر GAMRequest طلب إعلان واحدًا، وتحتوي على سمات لعناصر مثل معلومات الاستهداف.
إعادة تحميل إعلان
إذا أعددت وحدتك الإعلانية لإعادة التحميل، لن تحتاج إلى طلب إعلان آخر عند تعذُّر تحميل الإعلان. تلتزم حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" بأيّ معدّل تحديث حدّدته في واجهة مستخدم "مدير إعلانات Google". إذا لم تكن قد فعّلت ميزة الصعق الكهربي، قدِّم طلبًا جديدًا. لمزيد من التفاصيل حول إعادة تحميل الوحدة الإعلانية، مثل ضبط معدّل إعادة التحميل، يُرجى الاطّلاع على معدّل إعادة تحميل الإعلانات في التطبيقات المتوافقة مع الأجهزة الجوّالة.
أحداث الإعلانات
من خلال استخدام GADBannerViewDelegate
، يمكنك الاستماع إلى أحداث دورة النشاط،
مثل إغلاق إعلان أو مغادرة المستخدم للتطبيق.
التسجيل في أحداث إعلانات البانر
للتسجيل في أحداث إعلانات البانر، اضبط سمة delegate
في
GAMBannerView
على عنصر ينفِّذ بروتوكول
GADBannerViewDelegate
. بشكل عام، تعمل الفئة التي تنفِّذ إعلانات البانر
كفئات مفوَّضة أيضًا، وفي هذه الحالة، يمكن ضبط السمة delegate
على self
.
Swift
import GoogleMobileAds
import UIKit
class ViewController: UIViewController, GADBannerViewDelegate {
var bannerView: GAMBannerView!
override func viewDidLoad() {
super.viewDidLoad()
// ...
bannerView.delegate = self
}
}
SwiftUI
banner.delegate = self
Objective-C
@import GoogleMobileAds;
@interface ViewController () <GADBannerViewDelegate>
@property(nonatomic, strong) GAMBannerView *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 API Demo.
حالات الاستخدام
في ما يلي بعض أمثلة حالات الاستخدام لهذه الطرق المتعلّقة بأحداث الإعلانات.
إضافة بانر إلى التسلسل الهرمي للعرض بعد تلقّي إعلان
قد تحتاج إلى تأخير إضافة GAMBannerView
إلى
تسلسل عرض الإعلانات إلى أن يتم استلام إعلان. يمكنك إجراء ذلك من خلال الاستماع
إلى حدث bannerViewDidReceiveAd:
:
Swift
func bannerViewDidReceiveAd(_ bannerView: GADBannerView) {
// Add banner to view and add constraints.
addBannerViewToView(bannerView)
}
Objective-C
- (void)bannerViewDidReceiveAd:(GAMBannerView *)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:(GAMBannerView *)bannerView {
bannerView.alpha = 0;
[UIView animateWithDuration:1.0 animations:^{
bannerView.alpha = 1;
}];
}
إيقاف التطبيق مؤقتًا واستئناف تشغيله
يتضمّن بروتوكول GADBannerViewDelegate
طرقًا لإرسال إشعارات إليك بشأن الأحداث، مثل
الحالات التي يؤدي فيها النقر إلى عرض تراكب أو إغلاقه. إذا كنت تريد معرفة ما إذا كانت هذه الأحداث ناتجة عن الإعلانات، يمكنك الاشتراك في هذه الخطوات التالية:
GADBannerViewDelegate
.
لرصد جميع أنواع العروض التراكبية أو عمليات تشغيل المتصفّح الخارجي، وليس
فقط تلك التي تأتي من النقرات على الإعلانات، من الأفضل أن يستمع تطبيقك إلى methods المكافئة على UIViewController
أو UIApplication
. في ما يلي جدول
يعرض طرق iOS المماثلة التي يتمّ استدعاؤها في الوقت نفسه مع methods
GADBannerViewDelegate
:
طريقة GADBannerViewDelegate | طريقة iOS |
---|---|
bannerViewWillPresentScreen: |
viewWillDisappear: في UIViewController |
bannerViewWillDismissScreen: |
viewWillAppear: في UIViewController |
bannerViewDidDismissScreen: |
viewDidAppear: في UIViewController |
احتساب مرّات الظهور يدويًا
يمكنك إرسال إشعارات مرّات الظهور يدويًا إلى "مدير إعلانات Google" إذا كانت لديك شروط خاصة
لتحديد الحالات التي يجب فيها تسجيل مرّة ظهور. يمكن إجراء ذلك أولاً
من خلال تفعيل GAMBannerView
للظهورات اليدوية قبل تحميل إعلان:
Swift
bannerView.enableManualImpressions = true
Objective-C
self.bannerView.enableManualImpressions = YES;
عندما تحدّد أنّه تم عرض إعلان بنجاح على الشاشة، يمكنك بدء مرّة ظهور يدويًا:
Swift
bannerView.recordImpression()
Objective-C
[self.bannerView recordImpression];
أحداث التطبيقات
تتيح لك أحداث التطبيقات إنشاء إعلانات يمكنها إرسال رسائل إلى رمز التطبيق. ويمكن للتطبيق بعد ذلك اتّخاذ إجراءات استنادًا إلى هذه الرسائل.
يمكنك الاستماع إلى أحداث التطبيقات المتعلّقة بخدمة "مدير إعلانات Google" باستخدام GADAppEventDelegate
.
قد تحدث هذه الأحداث في أي وقت خلال دورة حياة الإعلان، حتى قبل استدعاء bannerViewDidReceiveAd:
عنصر
GADBannerViewDelegate
.
Swift
// Implement your app event within this method. The delegate will be
// notified when the SDK receives an app event message from the ad.
// Called when the banner receives an app event.
optional public func bannerView(_ banner: GAMBannerView,
didReceiveAppEvent name: String, withInfo info: String?)
Objective-C
// Implement your app event within this method. The delegate will be
// notified when the SDK receives an app event message from the ad.
@optional
// Called when the banner receives an app event.
- (void)bannerView:(GAMBannerView *)banner
didReceiveAppEvent:(NSString *)name
withInfo:(NSString *)info;
يمكن تنفيذ طرق أحداث تطبيقك في أداة تحكّم في العرض:
Swift
import GoogleMobileAds
class ViewController: UIViewController, GADAppEventDelegate {}
Objective-C
@import GoogleMobileAds;
@interface ViewController : UIViewController <GADAppEventDelegate> {}
@end
تذكَّر ضبط المفوَّض باستخدام الموقع appEventDelegate
قبل تقديم
طلب الإعلان.
Swift
bannerView.appEventDelegate = self
Objective-C
self.bannerView.appEventDelegate = self;
في ما يلي مثال يوضّح كيفية تغيير لون خلفية تطبيقك من خلال تحديد اللون من خلال حدث في التطبيق:
Swift
func bannerView(_ banner: GAMBannerView, didReceiveAppEvent name: String,
withInfo info: String?) {
if name == "color" {
guard let info = info else { return }
switch info {
case "green":
// Set background color to green.
view.backgroundColor = UIColor.green
case "blue":
// Set background color to blue.
view.backgroundColor = UIColor.blue
default:
// Set background color to black.
view.backgroundColor = UIColor.black
}
}
}
Objective-C
- (void)bannerView:(GAMBannerView *)banner
didReceiveAppEvent:(NSString *)name
withInfo:(NSString *)info {
if ([name isEqual:@"color"]) {
if ([info isEqual:@"green"]) {
// Set background color to green.
self.view.backgroundColor = [UIColor greenColor];
} else if ([info isEqual:@"blue"]) {
// Set background color to blue.
self.view.backgroundColor = [UIColor blueColor];
} else {
// Set background color to black.
self.view.backgroundColor = [UIColor blackColor];
}
}
}
في ما يلي تصميم الإعلان المقابل الذي يُرسِل رسائل أحداث تطبيقات التلوين إلى
appEventDelegate
:
<html>
<head>
<script src="//www.gstatic.com/afma/api/v1/google_mobile_app_ads.js"></script>
<script>
document.addEventListener("DOMContentLoaded", function() {
// Send a color=green event when ad loads.
admob.events.dispatchAppEvent("color", "green");
document.getElementById("ad").addEventListener("click", function() {
// Send a color=blue event when ad is clicked.
admob.events.dispatchAppEvent("color", "blue");
});
});
</script>
<style>
#ad {
width: 320px;
height: 50px;
top: 0px;
left: 0px;
font-size: 24pt;
font-weight: bold;
position: absolute;
background: black;
color: white;
text-align: center;
}
</style>
</head>
<body>
<div id="ad">Carpe diem!</div>
</body>
</html>
اطّلِع على مثال "أحداث التطبيقات" في "مدير إعلانات Google" لتنفيذ أحداث التطبيقات في تطبيق iOS API Demo.
مراجع إضافية
أمثلة على GitHub
- مثال على إعلانات البانر التكيّفية الثابتة: Swift | SwiftUI | Objective-C
- عرض توضيحي للميزات المتقدّمة: Swift | Objective-C
الخطوات التالية
إعلانات البانر القابلة للتصغير
إعلانات البانر القابلة للتصغير هي إعلانات بانر يتم عرضها في البداية كتراكب أكبر، مع زر لتصغير الإعلان إلى حجم أصغر. ننصحك باستخدامه لتحسين أدائك بشكلٍ أكبر. يمكنك الاطّلاع على إعلانات البانر القابلة للتصغير لمزيد من التفاصيل.
إعلانات البانر التكيّفية المضمّنة
إعلانات البانر التكيّفية المضمّنة هي إعلانات بانر أكبر وأطول مقارنةً بإعلانات البانر التكيّفية الثابتة. ويكون ارتفاعها متغيرًا، ويمكن أن يكون بطول شاشة الجهاز. ننصحك باستخدام إعلانات البانر التكيّفية المضمّنة بدلاً من إعلانات البانر التكيّفية الثابتة في التطبيقات التي تضع إعلانات البانر في محتوى قابل للتصفّح. اطّلِع على الإعلانات البانرات المُكيَّفة المضمّنة للحصول على مزيد من التفاصيل.