הגדרת מודעות באנר

מודעות באנר הן מודעות מלבניות שתופסות חלק מהפריסה של האפליקציה. מודעות באנר מותאמות ומעוגנות מוצגות תמיד במסך, מעוגנות לחלק העליון או התחתון של המסך, והגובה המקסימלי שלהן הוא 20% מגודל המסך, עד 150 פיקסלים. כדי להתאים את גודל המודעה לכל מכשיר, כדאי להשתמש במודעות באנר מותאמות.

המדריך הזה מסביר איך לטעון מודעת באנר מותאמת ומעוגנת באפליקציה ל-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 ל-storyboard או לקובץ xib. אם בחרתם בשיטה הזו, חשוב להוסיף רק אילוצי מיקום למודעת הבאנר. לדוגמה, כשמציגים מודעת באנר מותאמת בתחתית המסך, מגדירים את החלק התחתון של תצוגת הבאנר כך שיהיה שווה לחלק העליון של Bottom Layout Guide, ומגדירים את האילוץ centerX כך שיהיה שווה ל-centerX של תצוגת העל.

הגדרת גודל המודעה

מודעות באנר מותאמות גדולות הן פורמט גדול יותר שמיועד לפריסות ללא גלילה. בהשוואה למודעות באנר מותאמות ומעוגנות רגילות, במודעות האלה הגובה המקסימלי גדול יותר (עד 20% מגובה המסך, בין 50 ל-150 נקודות). השטח המוגדל הזה מותאם לקטע וידאו.

בדוגמה הבאה מוצג גודל של מודעת באנר מותאמת ומעוגנת גדולה:

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);

צריך להגדיר גודל מודעה שקטן מגודל המסך של המכשיר או שווה לו. כדי לקבוע את גודל המסך המקסימלי ב-iOS 26 ואילך, משתמשים במאפיין UIWindowScene.effectiveGeometry.coordinateSpace. ב-iOS 18 ובגרסאות קודמות, משתמשים במאפיין UIWindowScene.coordinateSpace. פרטים על מגבלות הגודל זמינים במאמר דרישות הגודל של בקשות להצגת מודעות.

טעינת מודעה

אחרי שיוצרים את GADBannerView ומגדירים את המאפיינים שלו, כמו adUnitID, אפשר לטעון מודעה. כדי לעשות את זה, צריך להפעיל את loadRequest: באובייקט GADRequest:

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");
}

אפשר לעיין בדוגמה של Ad Delegate כדי לראות הטמעה של שיטות להעברת מודעות באנר באפליקציית 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 האלה.

כדי לזהות את כל הסוגים של הצגת שכבות-על או הפעלות של דפדפנים חיצוניים, ולא רק כאלה שמגיעות מקליקים על מודעות, עדיף שהאפליקציה תאזין לשיטות המקבילות ב-UIViewController או ב-UIApplication. בטבלה הבאה מוצגות המתודות המקבילות ב-iOS שמופעלות בו-זמנית עם המתודות של GADBannerViewDelegate:

השיטה GADBannerViewDelegate שיטה ל-iOS
bannerViewWillPresentScreen: viewWillDisappear: של UIViewController
bannerViewWillDismissScreen: viewWillAppear: של UIViewController
bannerViewDidDismissScreen: viewDidAppear: של UIViewController

מקורות מידע נוספים

דוגמאות ב-GitHub

השלבים הבאים

מודעות באנר שאפשר לכווץ

מודעות באנר שאפשר לכווץ הן מודעות באנר שמוצגות בהתחלה כשכבת-על גדולה יותר, עם כפתור שאפשר ללחוץ עליו כדי לכווץ אותן לגודל קטן יותר. כדאי להשתמש בו כדי לשפר עוד יותר את הביצועים. פרטים נוספים זמינים במאמר בנושא מודעות באנר שאפשר לכווץ.

מודעות באנר מותאמות שמוצגות בתוך הטקסט

מודעות באנר מותאמות שמוצגות בתוך הטקסט הן מודעות באנר גדולות וגבוהות יותר בהשוואה למודעות באנר מותאמות ומעוגנות. הגובה שלהם משתנה, והם יכולים להיות בגובה של מסך המכשיר. אם אתם מציבים מודעות באנר בתוכן שניתן לגלול, מומלץ להשתמש במודעות באנר מותאמות שמוצגות בתוך הטקסט ולא במודעות באנר מותאמות ומעוגנות. מידע נוסף זמין במאמר מודעות באנר מותאמות להצגה בתוך האפליקציה.

נושאים נוספים