מודעות מותאמות הן נכסים שמצורפים למודעות שמוצגות למשתמשים דרך רכיבי ממשק משתמש שמותאמים לפלטפורמה. הם יוצגו באמצעות אותן הכיתות שבהן כבר השתמשתם בסטוריבורדים, ואפשר לעצב אותן כך שיתאימו לעיצוב החזותי של האפליקציה.
כשמודעה מותאמת נטענת, האפליקציה מקבלת אובייקט מודעה שמכיל את הנכסים שלה, והאפליקציה – ולא Google Mobile Ads SDK – אחראית להצגתם.
באופן כללי, יש שני חלקים כדי להטמיע מודעות מותאמות בהצלחה: טעינת מודעה באמצעות ה-SDK והצגת תוכן המודעה באפליקציה.
בדף הזה מוסבר איך להשתמש ב-SDK כדי לטעון מודעות מותאמות.
דרישות מוקדמות
- מבצעים את ההוראות במדריך לתחילת העבודה.
ביצוע בדיקות באמצעות מודעות בדיקה תמיד
כשאתם יוצרים ובודקים את האפליקציות שלכם, חשוב לוודא שאתם משתמשים במודעות בדיקה ולא במודעות פעילות בסביבת הייצור.
הדרך הקלה ביותר לטעון מודעות בדיקה היא באמצעות המזהה הייעודי של יחידת מודעות לבדיקה עבור מודעות מותאמות ב-iOS:
/6499/example/native
היא הוגדרה במיוחד כך שיחזירו מודעות בדיקה לכל בקשה, ואפשר להשתמש בה באפליקציות שלכם תוך כדי תכנות, בדיקות וניפוי באגים. רק הקפידו להחליף אותו במזהה יחידת המודעות שלכם לפני פרסום האפליקציה.
במאמר מודעות בדיקה מוסבר איך פועלות מודעות הבדיקה של Google Mobile Ads SDK.
טעינת מודעות
המודעות המותאמות נטענות באמצעות המחלקה GADAdLoader
, ששולחת הודעות למשתמשים שקיבלו הרשאה בהתאם לפרוטוקול GADAdLoaderDelegate
.
בנוסף לפורמט המותאם אישית שמוגדר על ידי המערכת, תוכלו ליצור פורמטים מותאמים אישית של מודעות מותאמות, שבהם תוכלו להשתמש במודעות מותאמות למכירה ישירה. פורמטים מותאמים אישית של מודעות מותאמות מאפשרים להעביר נתונים מובְנים שרירותיים לאפליקציה. המודעות האלה מיוצגות על ידי המחלקה GADCustomNativeAd
.
הפעלת הכלי לטעינת מודעות
כדי לטעון מודעה, צריך לאתחל את טוען המודעות.
הקוד הבא מראה איך לאתחל GADAdLoader
:
Swift
adLoader = GADAdLoader(adUnitID: "/6499/example/native",
rootViewController: self,
adTypes: [ .native ],
options: [ ... ad loader options objects ... ])
adLoader.delegate = self
Objective-C
self.adLoader = [[GADAdLoader alloc]
initWithAdUnitID:@"/6499/example/native"
rootViewController:rootViewController
adTypes:@[ GADAdLoaderAdTypeNative ]
options:@[ ... ad loader options objects ... ]];
self.adLoader.delegate = self;
אתם צריכים מזהה של יחידת מודעות (אפשר להשתמש במזהה הבדיקה), קבועים להעברה במערך adTypes
כדי לציין אילו פורמטים מותאמים רוצים לבקש, ואת האפשרויות שרוצים להגדיר בפרמטר options
. רשימת הערכים האפשריים לפרמטר options
מופיעה בדף Native Ad 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]];
ה-method loadRequest:
ב-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.