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

בחירת פלטפורמה: Android Android (בטא) iOS Flutter Unity

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

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

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

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

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

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

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

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

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

/21775744923/example/native

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

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

טעינת מודעות

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

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

אתחול טוען המודעות

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

Swift

adLoader = AdLoader(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 צריך להכיל קבוע אחד או יותר מהקבועים הבאים:

• GADAdLoaderAdTypeNative

• GADAdLoaderAdTypeCustomNative

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

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

Swift

public func adLoader(_ adLoader: AdLoader,
            didReceive nativeAd: NativeAd)

Objective-C

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

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

Swift

func adLoader(_ adLoader: AdLoader,
  Receive customNativeAd: CustomNativeAd)

Objective-C

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

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

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

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

Swift

adLoader.load(AdManagerRequest())

Objective-C

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

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

טעינת כמה מודעות (אופציונלי)

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

Swift

let multipleAdOptions = MultipleAdsAdLoaderOptions()
multipleAdOptions.numberOfAds = 5;
adLoader = AdLoader(adUnitID: "/21775744923/example/native",
    // The UIViewController parameter is optional.
    rootViewController: self,
    adTypes: [ .native ],
    options: [ multipleAdOptions ])

Objective-C

GADMultipleAdsAdLoaderOptions *multipleAdsOptions =
    [[GADMultipleAdsAdLoaderOptions alloc] init];
multipleAdsOptions.numberOfAds = 5;
self.adLoader = [[GADAdLoader alloc]
      initWithAdUnitID:@"/21775744923/example/native"
    // The UIViewController parameter is nullable.
    rootViewController:rootViewController
               adTypes:@[ GADAdLoaderAdTypeNative ]
               options:@[ multipleAdsOptions ]];

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

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

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

קביעה מתי הטעינה הסתיימה

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

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

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

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

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

Swift

class ViewController: UIViewController, NativeAdLoaderDelegate {

  var adLoader: GADAdLoader!

  override func viewDidLoad() {
    super.viewDidLoad()

    let multipleAdOptions = MultipleAdsAdLoaderOptions()
    multipleAdOptions.numberOfAds = 5;
    adLoader = AdLoader(adUnitID: "/21775744923/example/native",
        // The UIViewController parameter is optional.
        rootViewController: rootViewController,
        adTypes: [ .native ],
        options: [ multipleAdOptions ])

    adLoader.delegate = self
    adLoader.load(Request())
  }

  func adLoader(_ adLoader: AdLoader,
       didReceive nativeAd: NativeAd) {
    // A native ad has loaded, and can be displayed.
  }

  func adLoaderDidFinishLoading(_ adLoader: AdLoader) {
    // The adLoader has finished loading ads, and a new request can be sent.
  }

}

Objective-C

@interface ViewController () <GADNativeAdLoaderDelegate, GADVideoControllerDelegate>
@property(nonatomic, strong) GADAdLoader *adLoader;

@end

@implementation ViewController

- (void)viewDidLoad {
  [super viewDidLoad];

  GADMultipleAdsAdLoaderOptions *multipleAdsOptions =
      [[GADMultipleAdsAdLoaderOptions alloc] init];
  multipleAdsOptions.numberOfAds = 5;
  self.adLoader = [[GADAdLoader alloc]
        initWithAdUnitID:@"/21775744923/example/native"
      // The UIViewController parameter is nullable.
      rootViewController:rootViewController
                 adTypes:@[ GADAdLoaderAdTypeNative ]
                 options:@[ multipleAdsOptions ]];

  self.adLoader.delegate = self;
  [self.adLoader loadRequest:[GADRequest request]];
}

- (void)adLoader:(GADAdLoader *)adLoader
    didReceiveNativeAd:(GADNativeAd *)nativeAd {
  // A native ad has loaded, and can be displayed.
}

- (void)adLoaderDidFinishLoading:(GADAdLoader *) adLoader {
  // The adLoader has finished loading ads, and a new request can be sent.
}

@end

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

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

Swift

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

Objective-C

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

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

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

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

Swift

nativeAd.delegate = self

Objective-C

nativeAd.delegate = self;

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

Swift

func nativeAdDidRecordImpression(_ nativeAd: NativeAd) {
  // The native ad was shown.
}

func nativeAdDidRecordClick(_ nativeAd: NativeAd) {
  // The native ad was clicked on.
}

func nativeAdWillPresentScreen(_ nativeAd: NativeAd) {
  // The native ad will present a full screen view.
}

func nativeAdWillDismissScreen(_ nativeAd: NativeAd) {
  // The native ad will dismiss a full screen view.
}

func nativeAdDidDismissScreen(_ nativeAd: NativeAd) {
  // The native ad did dismiss a full screen view.
}

func nativeAdWillLeaveApplication(_ nativeAd: NativeAd) {
  // 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:.

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

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

הצגת המודעה

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