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

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

כשמודעה מותאמת נטענת, האפליקציה מקבלת אובייקט מודעה שמכיל את הנכסים שלה, והאפליקציה – ולא 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 צריך להכיל את אחד או יותר מהקבועים הבאים:

• GADAdLoaderAdTypeNative

• GADAdLoaderAdTypeCustomNative

הטמעת התכונה 'גישה לטעינת מודעות'

המשתמש האחראי לטעינת מודעות צריך להטמיע פרוטוקולים ספציפיים לסוג המודעה שלכם. כשמדובר ב מודעות מותאמות, הפרוטוקול 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 כמו מודעות באנר ומודעות מעברון. אפשר להשתמש באובייקטים של בקשות כדי להוסיף פרטי טירגוט, בדיוק כמו שעושים עם סוגי מודעות אחרים.

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

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

אחרי שאפליקציה שולחת קריאה ל-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;

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

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

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

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.