מודעות מותאמות הן נכסים שמצורפים למודעות שמוצגות למשתמשים דרך רכיבים בממשק המשתמש. מותאמים לפלטפורמה. הן מוצגות באמצעות אותן כיתות שבהן את כבר משתמשת בסטוריבורדים, ואפשר לעצב אותן כך שיתאימו לעיצוב החזותי של האפליקציה.
כשמודעה מותאמת נטענת, האפליקציה מקבלת אובייקטים של מודעה שמכיל את הנכסים שלה, ובאפליקציה – במקום ב-Google Mobile Ads SDK – אחראים להציג אותם.
ככלל, יש שני חלקים כדי להטמיע מודעות מותאמות: טעינת מודעה באמצעות ה-SDK והצגת תוכן המודעה באפליקציה.
בדף הזה מוסבר איך להשתמש ב-SDK כדי לטעון מודעות מותאמות.
דרישות מוקדמות
- מבצעים את ההוראות במדריך לתחילת העבודה.
ביצוע בדיקות באמצעות מודעות בדיקה תמיד
כשיוצרים ובודקים אפליקציות, חשוב להשתמש במודעות בדיקה במקום במודעות בדיקה של מודעות בשידור חי.
הדרך הקלה ביותר לטעון מודעות בדיקה היא להשתמש במזהה הייעודי של יחידת מודעות לבדיקה עבור מודעות מותאמות ב-iOS:
/21775744923/example/native
הוא הוגדר במיוחד להחזרת מודעות בדיקה עבור כל בקשה, ואפשר להשתמש בו באפליקציות שלכם תוך כדי תכנות, בדיקות וניפוי באגים. רק צריך לוודא צריך להחליף אותו במזהה יחידת המודעות שלך לפני פרסום האפליקציה.
מידע נוסף על אופן הפעולה של מודעות הבדיקה של Google Mobile Ads SDK מודעות בדיקה.
טעינת מודעות
המודעות המותאמות נטענות עם
GADAdLoader
למחלקה, ששולחות הודעות למשתמשים שקיבלו הרשאה
GADAdLoaderDelegate
של Google.
בנוסף לפורמט המותאם שמוגדר על ידי המערכת, אפשר גם ליצור
פורמטים מותאמים אישית של מודעות מותאמות
שאפשר להשתמש בהן במודעות מותאמות למכירה ישירה. פורמטים מותאמים אישית של מודעות מותאמות מאפשרים לך
להעביר נתונים מובְנים שרירותיים לאפליקציה שלך. המודעות האלה מיוצגות על ידי
כיתה אחת (GADCustomNativeAd
).
הפעלת הכלי לטעינת מודעות
כדי לטעון מודעה, צריך לאתחל את טוען המודעות.
הקוד הבא מראה איך לאתחל GADAdLoader
:
Swift
adLoader = GADAdLoader(adUnitID: "/21775744923/example/native",
// The UIViewController parameter is optional.
rootViewController: rootViewController,
adTypes: [ .native ],
options: [ ... ad loader options objects ... ])
adLoader.delegate = self
Objective-C
self.adLoader = [[GADAdLoader alloc]
initWithAdUnitID:@"/21775744923/example/native"
// The UIViewController parameter is nullable.
rootViewController:rootViewController
adTypes:@[ GADAdLoaderAdTypeNative ]
options:@[ ... ad loader options objects ... ]];
self.adLoader.delegate = self;
תצטרכו מזהה יחידת מודעות (אפשר להשתמש במזהה הבדיקה), וקבועים להעביר
מערך adTypes
כדי לציין אילו פורמטים מותאמים רוצים לבקש,
שאנחנו רוצים להגדיר בפרמטר options
. רשימת האפשרויות
תוכל למצוא את הערכים של הפרמטר options
בקטע הגדרת מודעה מותאמת
דף האפשרויות.
המערך adTypes
צריך להכיל אחד או יותר מהקבועים הבאים
:
הטמעת התכונה 'גישה לטעינת מודעות'
המשתמש האחראי לטעינת מודעות צריך להטמיע פרוטוקולים ספציפיים לסוג המודעה שלכם.
במודעות מותאמות, הפרוטוקול GADNativeAdLoaderDelegate
כולל הודעה
שנשלחת למשתמש בעל ההרשאה כשמודעה מותאמת נטענה.
Swift
public func adLoader(_ adLoader: GADAdLoader,
didReceive nativeAd: GADNativeAd)
Objective-C
- (void)adLoader:(GADAdLoader *)adLoader
didReceiveNativeAd:(GADNativeAd *)nativeAd;
הפרוטוקול GADCustomNativeAdLoaderDelegate
כולל הודעה שנשלחת אל
את המשתמש שקיבל את ההרשאה כשמודעת תבנית מותאמת אישית נטענת.
Swift
func adLoader(_ adLoader: GADAdLoader,
Receive customNativeAd: GADCustomNativeAd)
Objective-C
- (void)adLoader:(GADAdLoader *)adLoader
didReceiveCustomNativeAd:(GADCustomNativeAd *) customNativeAd;
בקשה להצגת מודעות
אחרי אתחול ה-GADAdLoader
, קוראים ל-method loadRequest:
של
מבקשים להציג מודעה:
Swift
adLoader.load(GAMRequest())
Objective-C
[self.adLoader loadRequest:[GAMRequest request]];
loadRequest:
method ב-
GADAdLoader
מקבל/ת את אותה
GAMRequest
אובייקטים בתור מודעות באנר ומודעות מעברון. אפשר להשתמש באובייקטים של בקשה כדי להוסיף
מידע על טירגוט, בדיוק כמו
סוג מודעות אחר.
אנחנו מחליטים מתי הטעינה הסתיימה
אחרי שאפליקציה שולחת קריאה ל-loadRequest:
, היא יכולה לקבל את תוצאות הבקשה באמצעות
שיחות אל:
adLoader:didFailToReceiveAdWithError:
בעודGADAdLoaderDelegate
adLoader:didReceiveNativeAd:
בעודGADNativeAdLoaderDelegate
בקשה למודעה יחידה תוביל לקריאה אחת לאחת מהשיטות האלה.
טיפול בבקשות שנכשלו
הפרוטוקולים שלמעלה מרחיבים את הפרוטוקול GADAdLoaderDelegate
, שמגדיר
שנשלחת כשמודעות לא נטענות.
Swift
public func adLoader(_ adLoader: GADAdLoader,
didFailToReceiveAdWithError error: NSError)
Objective-C
- (void)adLoader:(GADAdLoader *)adLoader
didFailToReceiveAdWithError:(NSError *)error;
קבלת התראות על אירועים של מודעות מותאמות
כדי לקבל התראות על אירועים שקשורים לאינטראקציות עם מודעות מותאמות, יש להגדיר את המשתמש שהוענקה הרשאה המאפיין של המודעה המותאמת:
Swift
nativeAd.delegate = self
Objective-C
nativeAd.delegate = self;
לאחר מכן מטמיעים
GADNativeAdDelegate
כדי לקבל את הקריאות הבאות להענקת גישה:
Swift
func nativeAdDidRecordImpression(_ nativeAd: GADNativeAd) {
// The native ad was shown.
}
func nativeAdDidRecordClick(_ nativeAd: GADNativeAd) {
// The native ad was clicked on.
}
func nativeAdWillPresentScreen(_ nativeAd: GADNativeAd) {
// The native ad will present a full screen view.
}
func nativeAdWillDismissScreen(_ nativeAd: GADNativeAd) {
// The native ad will dismiss a full screen view.
}
func nativeAdDidDismissScreen(_ nativeAd: GADNativeAd) {
// The native ad did dismiss a full screen view.
}
func nativeAdWillLeaveApplication(_ nativeAd: GADNativeAd) {
// The native ad will cause the app to become inactive and
// open a new app.
}
Objective-C
- (void)nativeAdDidRecordImpression:(GADNativeAd *)nativeAd {
// The native ad was shown.
}
- (void)nativeAdDidRecordClick:(GADNativeAd *)nativeAd {
// The native ad was clicked on.
}
- (void)nativeAdWillPresentScreen:(GADNativeAd *)nativeAd {
// The native ad will present a full screen view.
}
- (void)nativeAdWillDismissScreen:(GADNativeAd *)nativeAd {
// The native ad will dismiss a full screen view.
}
- (void)nativeAdDidDismissScreen:(GADNativeAd *)nativeAd {
// The native ad did dismiss a full screen view.
}
- (void)nativeAdWillLeaveApplication:(GADNativeAd *)nativeAd {
// The native ad will cause the app to become inactive and
// open a new app.
}
שיטות מומלצות
צריך לפעול לפי הכללים הבאים כשטוענים מודעות.
אפליקציות שנעשה בהן שימוש במודעות מותאמות ברשימה צריכות לשמור מראש את רשימת המודעות.
כשמציגים מודעות במטמון, מנקים את המטמון וטוענים מחדש אחרי שעה.
אין להתקשר שוב אל
loadRequest:
במכשירGADAdLoader
עד לבקשה הקודמת סיום הטעינה, כפי שמצוין ב-adLoaderDidFinishLoading:
.
הצגת המודעה
לאחר שטענתם מודעה, כל מה שנשאר הוא להציג אותה למשתמשים שלכם. כדאי לעבור אל מודעות מותאמות מסוג Advanced מדריך כדי לראות איך עושים זאת.