מודעות באנר הן מודעות מלבניות שתופסות חלק מהפריסה של האפליקציה. הם להישאר במסך בזמן שהמשתמשים יוצרים אינטראקציה עם האפליקציה, בחלק העליון או התחתון של המסך או בשורה עם תוכן בזמן שהמשתמש גולל. מודעות באנר יכול להיות שיתבצע רענון אוטומטי של המודעות אחרי פרק זמן מסוים. לעיון בסקירה כללית בנושא מודעות באנר אפשר לקבל מידע נוסף.
במדריך הזה מוסבר איך להתחיל להשתמש במודעות באנר מותאמות ומעוגנות Google Ads, שממקסמת את הביצועים באמצעות אופטימיזציה של גודל המודעה בכל מכשיר רוחב מודעה שציינתם.
מודעת באנר מותאמת ומעוגנת
מודעות באנר מותאמות ומעוגנות הן מודעות עם יחס גובה-רוחב קבוע ולא מודעות רגילות מודעות בגודל קבוע. יחס הגובה-רוחב דומה לפורמט המקובל בתחום של 320*50. פעם אחת מציין את הרוחב המלא הזמין, תוצג לכם מודעה עם בגובה הזה. הגובה האופטימלי לא משתנה בין הבקשות באותו מכשיר, והתצוגות שמסביב לא צריכות לזוז כשהמודעה מתבצע רענון.
דרישות מוקדמות
- מבצעים את ההוראות במדריך לתחילת העבודה.
ביצוע בדיקות באמצעות מודעות בדיקה תמיד
כשיוצרים ובודקים אפליקציות, חשוב להשתמש במודעות בדיקה במקום במודעות בדיקה של מודעות בשידור חי. אם לא תעשו זאת, ייתכן שהחשבון שלכם יושעה.
הדרך הקלה ביותר לטעון מודעות בדיקה היא להשתמש במזהה הייעודי של יחידת מודעות לבדיקה ל-iOS באנרים:
ca-app-pub-3940256099942544/2435281174
הוא הוגדר במיוחד להחזרת מודעות בדיקה עבור כל בקשה, לשימוש בחינם באפליקציות שלכם תוך כדי תכנות, בדיקות וניפוי באגים. צריך רק ליצור יש להחליף אותו במזהה יחידת המודעות שלך לפני פרסום האפליקציה.
מידע נוסף על אופן הפעולה של מודעות הבדיקה של Mobile Ads SDK זמין במאמר בדיקה מודעות.
יצירת 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) 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) ]) } }
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]; [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
חדש. כאשר משתמשים בשיטה זו, חשוב להוסיף מגבלות מיקום רק
הבאנר. לדוגמה, כשמציגים מודעת באנר מותאמת בתחתית
במסך, מגדירים את החלק התחתון של תצוגת הבאנר לחלק העליון של החלק התחתון
מדריך הפריסה, ומגדירים את ה-X המרכזי כך שיהיה שווה למרכז ה-X של תצוגת העל.
גודל המודעה של הבאנר עדיין מוגדר באופן פרוגרמטי:
Swift
bannerView.adSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(viewWidth)
Objective-C
self.bannerView.adSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(viewWidth);
טעינת מודעה
אחרי הצבת ה-GADBannerView
והמאפיינים שלו
הגיע הזמן לטעון מודעה. פעולה זו מתבצעת על ידי התקשרות אל loadRequest:
במכשיר
GADRequest
object:
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()) }
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 מייצגים בקשה אחת להצגת מודעה, וגם מכילים מאפיינים לדברים כמו פרטי טירגוט.
אם הטעינה של המודעה נכשלת, אין צורך לבקש מודעה נוספת באופן מפורש, למשל כל עוד הגדרתם את יחידת המודעות לרענון, Google Mobile Ads SDK מתייחס לכל קצב רענון שציינתם ב-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 } }
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 API.
תרחישים לדוגמה
ריכזנו כאן כמה תרחישים לדוגמה של שיטות לאירועי מודעות כאלה.
הוספת באנר להיררכיית התצוגות אחרי שהמודעה מתקבלת
מומלץ לדחות את הוספת GADBannerView
אל
היררכיית התצוגות עד לאחר שהמודעה התקבלה. אפשר לעשות זאת על ידי האזנה
עבור האירוע bannerViewDidReceiveAd:
:
Swift
func bannerViewDidReceiveAd(_ bannerView: GADBannerView) { // Add banner to view and add constraints as above. 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
השלבים הבאים
מודעות באנר שאפשר לכווץ
מודעות באנר שאפשר לכווץ הן מודעות באנר שמוצגות בהתחלה בתור שכבת-על, עם לחצן שמכווץ את המודעה לגודל קטן יותר. כדאי להשתמש בה כדי לבצע אופטימיזציה נוספת של הביצועים. פרטים נוספים זמינים במאמר בנושא מודעות באנר שאפשר לכווץ.
מודעות באנר מותאמות שמוצגות בתוך הטקסט
מודעות באנר מותאמות שמוצגות בתוך הטקסט הן מודעות באנר גדולות וגבוהות יותר בהשוואה למודעות באנר מותאמות ומעוגנות באנרים. הגובה שלהם משתנה, והם יכולים להגיע לגובה של מסך המכשיר. מומלץ להשתמש במודעות באנר מותאמות שמוצגות בתוך הטקסט על פני מודעות באנר מותאמות ומעוגנות אפליקציות שמציבות מודעות באנר בתוכן שאפשר לגלול. למידע נוסף, ראו מודעות מוטבעות מודעות באנר פרטים.