מודעות מותאמות

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

כשמודעה מותאמת נטענת, האפליקציה מקבלת אובייקט מודעה שמכיל את הנכסים שלה, והאפליקציה — במקום Google Mobile Ads SDK — אחראית להצגתם.

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

בדף הזה נסביר איך להשתמש ב-SDK כדי לטעון מודעות מותאמות.

דרישות מוקדמות

• מבצעים את ההוראות במדריך לתחילת העבודה.

תמיד כדאי לבדוק באמצעות מודעות בדיקה

כשאתם מפתחים ובודקים את האפליקציות, חשוב להשתמש במודעות בדיקה במקום במודעות פעילות בסביבת הייצור.

הדרך הקלה ביותר לטעון מודעות בדיקה היא להשתמש במזהה הייעודי של יחידת המודעות לבדיקה של מודעות מותאמות אישית ב-iOS:

/21775744923/example/native

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

מידע נוסף על אופן הפעולה של מודעות הבדיקה של Google Mobile Ads SDK זמין במאמר מודעות בדיקה.

טעינת מודעות

מודעות מותאמות נטענות עם הכיתה GADAdLoader, ששולחת הודעות לנציגים שלה בהתאם לפרוטוקול GADAdLoaderDelegate.

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

איך מאתחלים את הטעינה של המודעות

לפני שאפשר לטעון מודעה, צריך לאתחל את מערך הטעינה של המודעות. הקוד הבא מראה איך לאתחל GADAdLoader:

adLoader = GADAdLoader(adUnitID: "/21775744923/example/native",
    // The UIViewController parameter is optional.
    rootViewController: rootViewController,
    adTypes: [ .native ],
    options: [ ... ad loader options objects ... ])
adLoader.delegate = self

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 מופיעה בדף Native Ad Options.

המערך adTypes צריך להכיל אחת או יותר מהקבועות הבאות:

• GADAdLoaderAdTypeNative

• GADAdLoaderAdTypeCustomNative

הטמעת הנציג של מערך הטעינה של המודעות

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

public func adLoader(_ adLoader: GADAdLoader,
            didReceive nativeAd: GADNativeAd)

- (void)adLoader:(GADAdLoader *)adLoader
    didReceiveNativeAd:(GADNativeAd *)nativeAd;

פרוטוקול GADCustomNativeAdLoaderDelegate כולל הודעה שנשלחת לנציג כשמודעה עם תבנית מותאמת אישית נטענת.

func adLoader(_ adLoader: GADAdLoader,
  Receive customNativeAd: GADCustomNativeAd)

- (void)adLoader:(GADAdLoader *)adLoader
    didReceiveCustomNativeAd:(GADCustomNativeAd *) customNativeAd;

בקשה להצגת מודעות

אחרי אתחול של GADAdLoader, קוראים ל-method loadRequest: כדי לבקש מודעה:

adLoader.load(GAMRequest())

[self.adLoader loadRequest:[GAMRequest request]];

השיטה loadRequest: ב-GADAdLoader מקבלת את אותם אובייקטים מסוג GAMRequest כמו באנר וקטע מעבר. אפשר להשתמש באובייקטי בקשה כדי להוסיף פרטי טירגוט, בדיוק כמו בסוגים אחרים של מודעות.

אנחנו מחליטים מתי הטעינה הסתיימה

אחרי שאפליקציה קוראת ל-loadRequest:, היא יכולה לקבל את תוצאות הבקשה באמצעות קריאות אל:

• adLoader:didFailToReceiveAdWithError: ב-GADAdLoaderDelegate
• adLoader:didReceiveNativeAd: ב-GADNativeAdLoaderDelegate

בקשה להצגת מודעה אחת תוביל לקריאה אחת לאחת מהשיטות האלה.

טיפול בבקשות שנכשלו

הפרוטוקולים שלמעלה מרחיבים את הפרוטוקול GADAdLoaderDelegate, שמגדיר הודעה שתישלח כשמודעות לא נטענות.

public func adLoader(_ adLoader: GADAdLoader,
    didFailToReceiveAdWithError error: NSError)

- (void)adLoader:(GADAdLoader *)adLoader
    didFailToReceiveAdWithError:(NSError *)error;

קבלת התראות על אירועים של מודעות מותאמות

כדי לקבל התראות על אירועים שקשורים לאינטראקציות עם המודעה המותאמת, מגדירים את המאפיין delegate של המודעה המותאמת:

nativeAd.delegate = self

nativeAd.delegate = self;

לאחר מכן מטמיעים את GADNativeAdDelegate כדי לקבל את הקריאות הבאות להענקת גישה:

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.
}

- (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:.

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

• צריך למחוק מודעות מותאמות כשהן לא בשימוש.

הצגת המודעה

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