שימוש בפורמטים מותאמים אישית של מודעות מותאמות

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

פורמטים מותאמים אישית של מודעות

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

GADCustomNativeAdLoaderDelegate

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

Swift

public func customNativeAdFormatIDs(for adLoader: AdLoader) -> [Any]

Objective-C

- (NSArray *)customNativeAdFormatIDsForAdLoader:(AdLoader *)adLoader;

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

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

Swift

public func adLoader(_ adLoader: AdLoader,
    didReceive customNativeAd: CustomNativeAd)

Objective-C

- (void)adLoader:(AdLoader *)adLoader
    didReceiveCustomNativeAd:(CustomNativeAd *)customNativeAd;

מזהי פורמטים

מזהי הפורמטים שמשמשים להתייחסות ייחודית לפורמטים מותאמים אישית של מודעות מותאמות נמצאים בממשק המשתמש של Ad Manager בקטע Native בתפריט הנפתח Delivery:

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

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

הצגת פורמטים מותאמים של מודעות מותאמות

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

  1. הפונקציה GADCustomNativeAd נועדה לטפל בכל פורמט מותאם אישית של מודעות מותאמות, ולכן אין לה פונקציות גישה לנכסים עם שמות. במקום זאת, הוא מציע שיטות כמו imageForKey: ו-stringForKey: שמקבלות את שם השדה כארגומנט.
  2. אין מחלקה ייעודית של צפיות במודעות כמו GADNativeAdView שאפשר להשתמש בה עם GADCustomNativeAd. אתם יכולים להשתמש בכל תצוגה שמתאימה לחוויית המשתמש שלכם.
  3. מכיוון שאין מחלקה ייעודית של תצוגת מודעה, לא צריך לרשום אף אחת מהתצוגות שבהן משתמשים כדי להציג את נכסי המודעה.

דוגמה לתצוגת מודעה שיכולה להציג מודעה מותאמת פשוטה:

MySimpleNativeAdView.h

Swift

import UIKit
import GoogleMobileAds

/// Custom native ad view class with format ID 10063170.
class MySimpleNativeAdView: UIView {

  /// Weak references to this ad's asset views.
  @IBOutlet weak var headlineView: UILabel!
  @IBOutlet weak var mainImageView: UIImageView!
  @IBOutlet weak var captionView: UILabel!

  ...

  /// Populates the ad view with the custom native ad object.
  func populateWithCustomNativeAd(_ customNativeAd: CustomNativeAd) {
    ...
  }
}

Objective-C

@import UIKit;
@import GoogleMobileAds;

/// View representing a custom native ad format with format ID 10063170.
@interface MySimpleNativeAdView : UIView

// Weak references to this ad's asset views.
@property(weak, nonatomic) IBOutlet UILabel *headlineView;
@property(weak, nonatomic) IBOutlet UIImageView *mainImageView;
@property(weak, nonatomic) IBOutlet UILabel *captionView;

/// Populates the ad view with the custom native ad object.
- (void)populateWithCustomNativeAd:(GADCustomNativeAd *)customNativeAd;

@end

MySimpleNativeAdView.m (קטע)

Swift

...
func populateWithCustomNativeAd(_ customNativeAd: CustomNativeAd) {
  self.customNativeAd = customNativeAd

  // Populate the custom native ad assets.
  headlineView.text = self.customNativeAd.stringForKey("Headline")
  mainImageView.image = self.customNativeAd.imageForKey("MainImage")?.image
  captionView.text = self.customNativeAd.stringForKey("Caption")
}
...

Objective-C

...
- (void)populateWithCustomNativeAd:(GADCustomNativeAd *)customNativeAd {
  self.customNativeAd = customNativeAd;

  // Populate the custom native ad assets.
  self.headlineView.text = [customNativeAd stringForKey:@"Headline"];
  self.mainImageView.image = [customNativeAd imageForKey:@"MainImage"].image;
  self.captionView.text = [customNativeAd stringForKey:@"Caption"];
}
...

עיבוד של הסמל של AdChoices

במסגרת התמיכה ב-Digital Services Act (חוק השירותים הדיגיטליים, DSA), מודעות בהזמנה שמוצגות באזור הכלכלי האירופי (EEA) צריכות לכלול את הסמל של AdChoices וקישור אל הדף 'בנוגע למודעה הזו' ב-Google. כשמטמיעים מודעות מותאמות אישית, אתם אחראים לרנדר את הסמל של AdChoices. חשוב לבצע את השלבים הבאים כדי לרנדר ולהגדיר את רכיב click listener לסמל של AdChoices כשמציגים את נכסי המודעה העיקריים.

בדוגמה הבאה מוצג איך לרנדר את הסמל של AdChoices ולקבוע את התנהגות הקליק המתאימה.

Swift

class MySimpleNativeAdView: UIView {
  @IBOutlet weak var adChoicesView: UIImageView!

  override func awakeFromNib() {
    super.awakeFromNib()

    // Enable clicks on AdChoices.
    adChoicesView.addGestureRecognizer(
      UITapGestureRecognizer(
        target: self,
        action: #selector(performClickOnAdChoices(_:))))
    adChoicesView.isUserInteractionEnabled = true
  }

  @objc func performClickOnAdChoices(_ sender: UIImage!) {
    customNativeAd.performClickOnAsset(withKey:
      NativeAssetIdentifier.adChoicesViewAsset.rawValue)
  }

  func populate(withCustomNativeAd customNativeAd: CustomNativeAd) {

    // Render the AdChoices image.
    let adChoicesKey = NativeAssetIdentifier.adChoicesViewAsset.rawValue
    let adChoicesImage = customNativeAd.image(forKey: adChoicesKey)?.image
    adChoicesView.image = adChoicesImage
    adChoicesView.isHidden = adChoicesImage == nil
    ...
  }
}

Objective-C

@interface MySimpleNativeAdView ()

@property(nonatomic, weak) IBOutlet UIImageView *adChoicesView;

@end

@implementation MySimpleNativeAdView

- (void)awakeFromNib {
  [super awakeFromNib];
  // Enable clicks on AdChoices.
  [self.adChoicesView addGestureRecognizer:[[UITapGestureRecognizer alloc]
                                            initWithTarget:self
                                            action:@selector(performClickOnAdChoices:)]];
  self.adChoicesView.userInteractionEnabled = YES;
}

- (void)performClickOnAdChoices:(UITapGestureRecognizer *)sender {
    [self.customNativeAd performClickOnAssetWithKey:GADNativeAdChoicesViewAsset];
}

- (void)populateWithCustomNativeAd:(GADCustomNativeAd *)customNativeAd {
  // Render the AdChoices image.
  GADNativeAdImage *adChoicesAsset = [customNativeAd
    imageForKey:GADNativeAdChoicesViewAsset];
  self.adChoicesView.image = adChoicesAsset.image;
  self.adChoicesView.hidden = (adChoicesAsset == nil);
  ...
}

סרטון מותאם לפורמטים מותאמים אישית של מודעות מותאמות

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

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

בדוגמה הבאה נבדק אם במודעה יש תוכן וידאו, ואם אין תוכן וידאו מוצגת תמונה במקומו:

Swift

...
  /// Populates the ad view with the custom native ad object.
  func populate(withCustomNativeAd customNativeAd: CustomNativeAd) {
    if customNativeAd.videoController.hasVideoContent(),
      let mediaView = customNativeAd.mediaView {
      updateMainView(mediaView)
    } else {
      // Assumes your native format has an image asset with the name MainImage.
      let image: UIImage? = customNativeAd.image(forKey: "MainImage")?.image
      updateMainView(UIImageView(image: image))
    }
  }

  private func updateMainView(_ mainView:UIView) {
    // Assumes you have a placeholder view for your media content.
    // Remove all the placeholder's subviews.
    for subview: UIView in mainPlaceholder.subviews {
      subview.removeFromSuperview()
    }
    mainPlaceholder.addSubview(mainView)
    // Size the media view to fill our container size.
    mainView.translatesAutoresizingMaskIntoConstraints = false
    let viewDictionary: [AnyHashable: Any] = ["mainView":mainView]
    mainPlaceholder.addConstraints(NSLayoutConstraint.constraints(
      withVisualFormat: "H:|[mainView]|", options: [], metrics: nil,
      views: viewDictionary as? [String : Any] ?? [String : Any]()))
    mainPlaceholder.addConstraints(NSLayoutConstraint.constraints(
      withVisualFormat: "V:|[mainView]|", options: [], metrics: nil,
      views: viewDictionary as? [String : Any] ?? [String : Any]()))
  }
...

Objective-C

...
- (void)populateWithCustomNativeAd:(GADCustomNativeAd *)ad {
  UIView *mainView = nil;
  if (ad.videoController.hasVideoContent) {
    mainView = ad.mediaView;
  } else {
    // Assumes your native format has an image asset with the name MainImage.
    UIImage *image = [ad imageForKey:@"MainImage"].image;
    mainView = [[UIImageView alloc] initWithImage:image];
  }
  // Assumes you have a placeholder view for your media content.
  for (UIView *subview in self.mainPlaceholder.subviews) {
    [subview removeFromSuperview];
  }
  [self.mainPlaceholder addSubview:mainView];

  // Size the main view to fill our container size.
  [mainView setTranslatesAutoresizingMaskIntoConstraints:NO];
  NSDictionary *viewDictionary = NSDictionaryOfVariableBindings(mainView);
  [self.mainPlaceholder
      addConstraints:[NSLayoutConstraint constraintsWithVisualFormat:@"H:|[mainView]|"
                                                             options:0
                                                             metrics:nil
                                                               views:viewDictionary]];
}
...

מידע נוסף על התאמה אישית של חוויית הצפייה בסרטון במודעה מותאמת אישית מסוג Native זמין במאמר בנושא GADVideoController.

כדי לראות דוגמה פעילה של מודעת וידאו מותאמת, אפשר להוריד את הדוגמה של Ad Manager Custom Rendering ‎.

טיפול בקליקים ובחשיפות של מודעות מותאמות בהתאמה אישית

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

תיעוד חשיפות

כדי להקליט חשיפה של מודעה מותאמת אישית, פשוט מפעילים את השיטה recordImpression באובייקט GADCustomNativeAd המתאים:

Swift

myCustomNativeAd.recordImpression()

Objective-C

[myCustomNativeAd recordImpression];

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

דיווח על קליקים

כדי לדווח ל-SDK על קליק בתצוגת נכס, קוראים ל-method‏ performClickOnAssetWithKey: ב-GADCustomNativeAd המתאים ומעבירים את שם הנכס שעליו לחצו. לדוגמה, אם יש לכם נכס בפורמט מותאם אישית שנקרא MainImage, ואתם רוצים לדווח על קליק על התצוגה שמתאימה לנכס הזה, הקוד שלכם ייראה כך:

Swift

myCustomNativeAd.performClickOnAsset(withKey: "MainImage")

Objective-C

[myCustomNativeAd performClickOnAssetWithKey:@"MainImage"];

שימו לב שלא צריך להפעיל את ה-method הזה לכל תצוגת נכס שמשויכת למודעה. לדוגמה, אם יש לכם נכס אחר בשם Caption (כיתוב), שאמור להיות מוצג אבל המשתמש לא אמור ללחוץ עליו או להקיש עליו, האפליקציה לא צריכה לקרוא ל-performClickOnAssetWithKey: בשביל התצוגה הזו.

תגובה לפעולות לחיצה בהתאמה אישית

‫GADCustomNativeAd יש מאפיין customClickHandler מסוג GADNativeAdCustomClickHandler

Swift

typealias NativeAdCustomClickHandler = (assetID: String) -> Void

Objective-C

typedef void (^GADNativeAdCustomClickHandler)(NSString *assetID);

זהו בלוק (Objective-C) או סגירה (Swift) שמקבלים assetID כפרמטר קלט, שמזהה את נכס הקריאייטיב שהמשתמש לחץ עליו.

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

  1. מפעילים את הבלוק customClickHandler ב-Objective-C או את הסגירה ב-Swift, אם הוגדר אחד מהם.
  2. מבצעים לולאה על כתובות ה-URL של הקישורים העמוקים של המודעה ופותחים את הראשונה שבה אפשר למצוא אפליקציה תואמת.
  3. פותחים דפדפן ועוברים לכתובת ה-URL הרגילה של דף הנחיתה של המודעה.

המאפיין customClickHandler מקבל בלוק ב-Objective-C וסגירה ב-Swift. אם מגדירים חסימה או סגירה, ה-SDK יפעיל אותה ולא יבצע פעולות נוספות. עם זאת, אם מגדירים ערך nil, ערכת ה-SDK תחזור לדיפלינק או לכתובות היעד שרשומות במודעה.

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

Swift

myCustomNativeAd.customClickHandler = { assetID in
  if assetID == "MainImage" {
    let alertView = UIAlertView(title: "Custom Click",
        message: "You just clicked on the image!",
        delegate: self,
        cancelButtonTitle: "OK")
    alertView.alertViewStyle = .default
    alertView.show()
  }
}
myCustomNativeAd.performClickOnAsset(withKey: "MainImage")

Objective-C

[self.customNativeAd setCustomClickHandler:^(NSString *assetID){
  if ([assetID isEqualToString:@"MainImage"]) {
    [[[UIAlertView alloc] initWithTitle:@"Custom Click"
                                message:@"You just clicked on the image!"
                               delegate:self
                      cancelButtonTitle:@"OK"
                      otherButtonTitles:nil] show];
  }
}];
[self.customNativeAd performClickOnAssetWithKey:@"MainImage"];

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

מודעות במכירה ישירה

אם אתם רוצים לבדוק איך נראות מודעות מותאמות שמוצגות ישירות, אתם יכולים להשתמש במזהה יחידת המודעות הבא ב-Ad Manager:

/21775744923/example/native

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

  • כותרת (טקסט)
  • MainImage (תמונה)
  • כיתוב (טקסט)

מודעות מותאמות למילוי שטחי פרסום

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

/21775744923/example/native-backfill

המערכת תציג מודעות לדוגמה להתקנת אפליקציות ומודעות באתרי תוכן שכוללות את שכבת-העל של AdChoices.

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