يغطّي هذا الدليل كيفية تحميل "إعلان بانر تكيُّفي ثابت" في تطبيق iOS.
المتطلبات الأساسية
قبل المتابعة، عليك إعداد Google Mobile Ads SDK.
الاختبار دائمًا باستخدام الإعلانات الاختبارية
عند إنشاء تطبيقاتك واختبارها، تأكَّد من استخدام الإعلانات الاختبارية بدلاً من الإعلانات الفعلية المعروضة للمستخدمين. وقد يؤدي عدم إجراء ذلك إلى تعليق حسابك.
أسهل طريقة لتحميل الإعلانات الاختبارية هي استخدام رقم تعريف الوحدة الإعلانية الاختبارية المخصّصة لإعلانات البانر على iOS:
ca-app-pub-3940256099942544/2435281174
تم إعداد رقم التعريف هذا خصيصًا لعرض إعلانات اختبارية لكل طلب، ويمكنك استخدامه بحرية في تطبيقاتك أثناء الترميز والاختبار وتحديد الأخطاء وحلّها. ما عليك سوى استبداله برقم تعريف الوحدة الإعلانية الخاص بك قبل نشر تطبيقك.
لمزيد من المعلومات عن آلية عمل الإعلانات الاختبارية في Google Mobile Ads SDK، اطّلِع على مقالة الإعلانات الاختبارية.
إنشاء GADBannerView
تظهر إعلانات البانر في GADBannerView
عناصر، لذا فإنّ الخطوة الأولى نحو دمج إعلانات البانر هي تضمين GADBannerView
في هيكلية طرق العرض. ويتم ذلك عادةً إما برمجيًا أو من خلال أداة Interface Builder.
برمجيًا
يمكن أيضًا إنشاء مثيل لـ GADBannerView مباشرةً.
ينشئ المثال التالي GADBannerView:
Swift
// Initialize the banner view.
bannerView = BannerView()
bannerView.delegate = self
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),
])
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)
}
أضِف UIViewRepresentable إلى هيكلية طرق العرض، مع تحديد قيمتَي height وwidth:
var body: some View {
Spacer()
// Request an anchored adaptive banner with a width of 375.
let adSize = largeAnchoredAdaptiveBanner(width: 375)
BannerViewContainer(adSize)
.frame(width: adSize.size.width, height: adSize.size.height)
}
Objective-C
// Initialize the banner view.
GADBannerView *bannerView = [[GADBannerView alloc] init];
bannerView.delegate = self;
UIView *view = self.view;
bannerView.translatesAutoresizingMaskIntoConstraints = NO;
[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 activateConstraints:@[
// Align the banner's bottom edge with the safe area's bottom edge
[bannerView.bottomAnchor
constraintEqualToAnchor:view.safeAreaLayoutGuide.bottomAnchor],
// Center the banner horizontally in the view
[bannerView.centerXAnchor constraintEqualToAnchor:view.centerXAnchor],
]];
self.bannerView = bannerView;
Interface Builder
يمكنك إضافة GADBannerView إلى لوحة عرض أو ملف xib. عند استخدام هذه الطريقة، احرص على إضافة قيود الموضع فقط على البانر. على سبيل المثال،
عند عرض إعلان بانر تكيُّفي في أسفل الشاشة، اضبط أسفل
طريقة عرض البانر ليساوي أعلى دليل تصميم أسفل الشاشة، واضبط
centerX
القيد ليساوي centerX طريقة العرض الرئيسية.
ضبط حجم الإعلان
يحصل المثال التالي على حجم "إعلان بانر تكيُّفي ثابت" كبير:
Swift
// Request a large anchored adaptive banner with a width of 375.
bannerView.adSize = largeAnchoredAdaptiveBanner(width: 375)
Objective-C
// Request a large anchored adaptive banner with a width of 375.
self.bannerView.adSize = GADLargeAnchoredAdaptiveBannerAdSizeWithWidth(375);
تحميل إعلان
بعد وضع GADBannerView وضبط خصائصه، مثل adUnitID، حان وقت تحميل إعلان. ويتم ذلك من خلال استدعاء loadRequest:
على عنصر GADRequest
object:
Swift
func loadBannerAd(bannerView: BannerView) {
// Request a large anchored adaptive banner with a width of 375.
bannerView.adSize = largeAnchoredAdaptiveBanner(width: 375)
bannerView.load(Request())
}
SwiftUI
banner.adUnitID = "ca-app-pub-3940256099942544/2435281174"
banner.load(Request())
Objective-C
// Request a large anchored adaptive banner with a width of 375.
self.bannerView.adSize = GADLargeAnchoredAdaptiveBannerAdSizeWithWidth(375);
[self.bannerView loadRequest:[GADRequest request]];
تمثّل عناصر GADRequest طلب عرض إعلان واحدًا، وتحتوي على خصائص لمعلومات مثل معلومات الاستهداف.
إعادة تحميل إعلان
إذا ضبطت وحدتك الإعلانية على إعادة التحميل، ليس عليك طلب إعلان آخر عندما يتعذّر تحميل الإعلان. Google Mobile Ads SDK تراعي أي معدّل إعادة تحميل تحدّده في واجهة مستخدم AdMob. إذا لم تفعِّل إعادة التحميل، أرسِل طلبًا جديدًا. لمزيد من التفاصيل عن إعادة تحميل الوحدة الإعلانية، مثل ضبط معدّل إعادة التحميل، اطّلِع على مقالة ضبط خيار إعادة التحميل التلقائية لإعلانات البانر.
التعامل مع تغييرات اتجاه الشاشة
عند تغيير اتجاه شاشة تطبيقك، مثلاً من
portrait
الوضع الأفقي، غالبًا ما يتغيّر العرض المتاح للبانر أيضًا. للتأكّد من عرض إعلان بالحجم المناسب للتصميم الجديد، اطلب بانرًا جديدًا. إذا كان عرض البانر ثابتًا، أو إذا كانت قيود التصميم يمكنها التعامل مع تغيير الحجم، يمكنك تخطّي هذه الخطوة.
Swift
override func viewWillTransition(
to size: CGSize, with coordinator: UIViewControllerTransitionCoordinator
) {
coordinator.animate(alongsideTransition: { _ in
// Load a new ad for the new orientation.
})
}
Objective-C
- (void)viewWillTransitionToSize:(CGSize)size
withTransitionCoordinator:(id<UIViewControllerTransitionCoordinator>)coordinator {
[coordinator animateAlongsideTransition:^(id<UIViewControllerTransitionCoordinatorContext> context) {
// Load a new ad for the new orientation.
} completion:nil];
}
أحداث الإعلانات
من خلال استخدام GADBannerViewDelegate، يمكنك الاستماع إلى أحداث مراحل النشاط، مثل وقت إغلاق الإعلان أو مغادرة المستخدم للتطبيق.
التسجيل في أحداث البانر
للتسجيل في أحداث إعلانات البانر، اضبط السمة delegate في
GADBannerView على عنصر ينفّذ بروتوكول
GADBannerViewDelegate. بشكل عام، تعمل الفئة التي تعرض إعلانات البانر أيضًا كفئة مفوَّضة، وفي هذه الحالة، يمكن ضبط السمة delegate على self.
Swift
bannerView.delegate = self
SwiftUI
banner.delegate = context.coordinator
Objective-C
bannerView.delegate = self;
تنفيذ أحداث البانر
تم وضع علامة "اختياري" على كل طريقة من طرق GADBannerViewDelegate، لذا ليس عليك تنفيذ سوى الطرق التي تريدها. ينفّذ هذا المثال كل طريقة ويسجِّل رسالة في وحدة التحكّم:
Swift
func bannerViewDidReceiveAd(_ bannerView: BannerView) {
print("Banner ad loaded.")
}
func bannerView(_ bannerView: BannerView, didFailToReceiveAdWithError error: Error) {
print("Banner ad failed to load: \(error.localizedDescription)")
}
func bannerViewDidRecordImpression(_ bannerView: BannerView) {
print("Banner ad recorded an impression.")
}
func bannerViewDidRecordClick(_ bannerView: BannerView) {
print("Banner ad recorded a click.")
}
func bannerViewWillPresentScreen(_ bannerView: BannerView) {
print("Banner ad will present screen.")
}
func bannerViewWillDismissScreen(_ bannerView: BannerView) {
print("Banner ad will dismiss screen.")
}
func bannerViewDidDismissScreen(_ bannerView: BannerView) {
print("Banner ad did dismiss screen.")
}
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.
حالات الاستخدام
في ما يلي بعض حالات الاستخدام النموذجية لطرق أحداث الإعلانات هذه.
إضافة بانر إلى هيكلية طرق العرض بعد تلقّي إعلان
قد تريد تأخير إضافة 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 هذه.
للحصول على جميع أنواع عروض التراكب أو استدعاءات المتصفّح الخارجي، وليس فقط تلك الناتجة عن النقرات على الإعلانات، من الأفضل أن يستمع تطبيقك إلى الطرق المكافئة في UIViewController أو UIApplication. في ما يلي جدول يعرض طرق iOS المكافئة التي يتم استدعاؤها في الوقت نفسه الذي يتم فيه استدعاء طرق GADBannerViewDelegate:
| طريقة GADBannerViewDelegate | طريقة iOS |
|---|---|
bannerViewWillPresentScreen: |
viewWillDisappear: في UIViewController |
bannerViewWillDismissScreen: |
viewWillAppear: في UIViewController |
bannerViewDidDismissScreen: |
viewDidAppear: في UIViewController |
مراجع إضافية
أمثلة على GitHub
- مثال على "إعلانات البانر التكيُّفية الثابتة": Swift | SwiftUI | Objective-C
- عرض توضيحي للميزات المتقدّمة: Swift | Objective-C
الخطوات التالية
إعلانات البانر القابلة للتصغير
"إعلانات البانر القابلة للتصغير" هي إعلانات بانر يتم عرضها في البداية كتراكب أكبر، مع زر لتصغير الإعلان إلى حجم أصغر. ننصحك باستخدامها لزيادة تحسين أدائك. اطّلِع على مقالة إعلانات البانر القابلة للتصغير لمزيد من التفاصيل.
إعلانات البانر التكيّفية المضمّنة
"إعلانات البانر التكيُّفية" المضمّنة هي أكبر وأطول مقارنةً بـ "إعلانات البانر التكيُّفية الثابتة". ويختلف ارتفاعها، ويمكن أن يكون بطول شاشة الجهاز. ننصح باستخدام "إعلانات البانر التكيُّفية" المضمّنة بدلاً من "إعلانات البانر التكيُّفية الثابتة" للتطبيقات التي تضع إعلانات بانر في محتوى قابل للتمرير. اطّلِع على مقالة إعلانات البانر التكيّفية المضمّنة لمزيد من التفاصيل.