מודעות באנר הן מודעות מלבניות שתופסות חלק מהפריסה של האפליקציה. הן מוצגות במסך גם בזמן אינטראקציות של המשתמשים באפליקציה – מעוגנות בראש המסך או בתחתית המסך או משולבות בתוכן בזמן שמשתמשים גוללים בו. יכול להיות שיתבצע רענון אוטומטי של מודעות באנר אחרי פרק זמן מסוים. למידע נוסף, תוכלו לקרוא את הסקירה הכללית בנושא מודעות באנר.
במדריך הזה מוסבר איך להתחיל להשתמש במודעות באנר מותאמות מוצמדות, שמאפשרות למקסם את הביצועים על ידי אופטימיזציה של גודל המודעה לכל מכשיר לפי רוחב המודעה שציינתם.
מודעת באנר מותאמת ומעוגנת
מודעות באנר מותאמות ומעוגנות הן מודעות ביחס גובה-רוחב קבוע, ולא מודעות רגילות בגודל קבוע. יחס הגובה-רוחב דומה ליחס 320x50 שמקובל בתחום. אחרי שמציינים את מלוא רוחב המודעה הזמין, המערכת מחזירה מודעה בגובה אופטימלי לרוחב הזה. הגובה האופטימלי לא משתנה בבקשות מאותו מכשיר, והתצוגות שמסביב לא צריכות לזוז כשהמודעה מתעדכנת.
דרישות מוקדמות
- קוראים את המדריך לתחילת העבודה.
תמיד כדאי לבדוק באמצעות מודעות בדיקה
כשאתם מפתחים ובודקים את האפליקציות, חשוב להשתמש במודעות בדיקה במקום במודעות פעילות בסביבת הייצור. אם לא תעשו זאת, החשבון שלכם עלול להיחסם.
הדרך הקלה ביותר לטעון מודעות בדיקה היא להשתמש במזהה הייעודי של יחידת המודעות לבדיקה של מודעות באנר ל-iOS:
/21775744923/example/adaptive-banner
הוא מוגדר במיוחד להחזיר מודעות בדיקה לכל בקשה, ואתם יכולים להשתמש בו באפליקציות שלכם בזמן הכתיבה, הבדיקה ותיקון הבאגים. רק חשוב לוודא שתחליפו אותו במזהה של יחידת המודעות שלכם לפני שתפרסמו את האפליקציה.
מידע נוסף על אופן הפעולה של מודעות הבדיקה של Mobile Ads SDK זמין במאמר מודעות בדיקה.
יצירת 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 מייצגים בקשה אחת להצגת מודעה, ומכילים מאפיינים כמו פרטי טירגוט.
רענון מודעה
אם הגדרתם את יחידת המודעות להתעדכן, לא תצטרכו לבקש מודעה אחרת אם המודעה לא נטענת. Google Mobile Ads SDK מתייחס לכל קצב רענון שציינתם בממשק המשתמש של Ad Manager. אם לא הפעלתם את הרענון, צריך לשלוח בקשה חדשה. פרטים נוספים על רענון יחידות המודעות, למשל הגדרת קצב רענון, זמינים במאמר קצב רענון של מודעות באפליקציות לנייד.
אירועי מודעות
באמצעות 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");
}
בדוגמה של Ad Delegate מוסבר איך מטמיעים שיטות של נציגים של מודעות באנר באפליקציית הדגמה של iOS API.
תרחישים לדוגמה
ריכזנו כאן כמה תרחישים לדוגמה לשימוש בשיטות האלה של אירועי מודעות.
הוספת באנר להיררכיית התצוגה אחרי קבלת מודעה
מומלץ להשהות את ההוספה של 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
האלה.
כדי לזהות את כל סוגי הצגת שכבות-על או הפעלות חיצוניות של הדפדפן, ולא רק את אלה שמגיעות מקליקים על מודעות, מומלץ לאפליקציה להאזין לשיטות המקבילות ב-UIViewController
או ב-UIApplication
. בטבלה הבאה מפורטות השיטות המקבילות ל-iOS שמופעלות בו-זמנית עם השיטות של GADBannerViewDelegate
:
שיטת GADBannerViewDelegate | שיטת iOS |
---|---|
bannerViewWillPresentScreen: |
viewWillDisappear: של UIViewController |
bannerViewWillDismissScreen: |
viewWillAppear: של UIViewController |
bannerViewDidDismissScreen: |
viewDidAppear: של UIViewController |
ספירת חשיפות ידנית
אם יש לכם תנאים מיוחדים לתיעוד חשיפות, תוכלו לשלוח באופן ידני פינגים של חשיפות אל Ad Manager. כדי לעשות זאת, צריך קודם להפעיל GAMBannerView
לחשיפות ידניות לפני טעינת המודעה:
Swift
bannerView.enableManualImpressions = true
Objective-C
self.bannerView.enableManualImpressions = YES;
כשאתם קובעים שהמודעה הוחזרה בהצלחה ומוצגת במסך, תוכלו להפעיל ידנית חשיפה:
Swift
bannerView.recordImpression()
Objective-C
[self.bannerView recordImpression];
אירועים באפליקציה
אירועים באפליקציה מאפשרים ליצור מודעות שיכולות לשלוח הודעות לקוד של האפליקציה. לאחר מכן האפליקציה יכולה לבצע פעולות על סמך ההודעות האלה.
אפשר להאזין לאירועי אפליקציה ספציפיים ל-Ad Manager באמצעות 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;
אפשר להטמיע את שיטות האירועים של האפליקציה ב-view controller:
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>
בדוגמה של אירועים באפליקציות ב-Ad Manager מוסבר איך מטמיעים אירועים באפליקציות באפליקציית הדגמה של API ל-iOS.
מקורות מידע נוספים
דוגמאות ב-GitHub
- דוגמה למודעות באנר מותאמות ומעוגנות: Swift | SwiftUI | Objective-C
- הדגמה של תכונות מתקדמות: Swift | Objective-C
השלבים הבאים
מודעות באנר שאפשר לכווץ
מודעות באנר שאפשר לכווץ הן מודעות באנר שמוצגות בהתחלה כשכבת-על גדולה יותר, עם לחצן לכווץ את המודעה לגודל קטן יותר. מומלץ להשתמש בה כדי לשפר עוד יותר את הביצועים. פרטים נוספים זמינים במאמר מודעות באנר שאפשר לכווץ.
מודעות באנר מותאמות שמוצגות בתוך הטקסט
מודעות באנר מותאמות שמוצגות בתוך הטקסט הן מודעות באנר גדולות וגבוהות יותר בהשוואה למודעות באנר מותאמות ומעוגנות. הגובה שלהן משתנה, והן יכולות להיות בגובה המסך של המכשיר. מומלץ להשתמש במודעות באנר מותאמות שמוצגות בתוך הטקסט במקום במודעות באנר מותאמות שמוצגות כמודעות עוגן באפליקציות שמציגות מודעות באנר בתוכן שניתן לגלילה. פרטים נוספים זמינים במאמר באנרים דינמיים בתוך הדף.