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

מדריך זה מיועד לבעלי אתרים שמשלבים מטא נתונים של מודעות עם Google Mobile Ads iOS SDK.

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

מאחזר מטא נתונים של מודעות

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

הפונקציה adMetadataDidChange: מופעלת מיד אחרי טעינת מודעה או כשהמטא-נתונים של המודעה משתנים באופן אסינכרוני לאחר הטעינה. לא נוכל להבטיח שהמטא-נתונים של המודעות יהיו זמינים בזמן הטעינה, לכן מומלץ להמתין לקריאה החוזרת (callback) לפני שניגשים למטא-נתונים של המודעה.

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

@interface ViewController () <GADFullScreenContentDelegate, GADAdMetadataDelegate>

@end

@implementation ViewController
- (void)loadRewardedAd {
   *request = [ request];
  [GADRewardedAd
       loadWithAdUnitID:@"ca-app-pub-3940256099942544/4806952744"
                request:request
      completionHandler:^(GADRewardedAd *ad, NSError *error) {
        if (error) {
          NSLog(@"Rewarded ad failed to load with error: %@", [error localizedDescription]);
          return;
        }
        self.rewardedAd = ad;
        self.rewardedAd.fullScreenContentDelegate = self;

        /// Set the ad to be the delegate of its ad metadata.
        self.rewardedAd.adMetadataDelegate = self;

        NSLog(@"Rewarded ad loaded.");
      }];
}

/#pragma mark GADAdMetadataDelegate implementation

- (void)adMetadataDidChange:(id<GADAdMetadataProvider>)ad {
  NSDictionary<NSString*, id> *adMetadata = _rewardedAd.adMetadata;
  NSString *adId = adMetadata[@"AdId"];
}

לאחר אחזור המטא-נתונים, תוכלו לחפש ב-Bundle את המפתחות שחשובים לכם. לסוגים שונים של מודעות יכולים להיות מפתחות שונים של מטא-נתונים של מודעות. למודעות וידאו מסוג VAST יש את המפתחות הבאים:

מפתח תיאור התיאור
AdId מחרוזת המזהה של המודעה או המחרוזת הריקה אם היא לא זמינה.
AdTitle מחרוזת הכותרת, ריקה אם לא צוינה.
CreativeDurationMs מספר שלם משך הזמן שנבחר לקריאייטיב באלפיות השנייה, -1 אם הוא לא לינארי.
TraffickingParameters מחרוזת פרמטרים של ניהול טראפיק או המחרוזת הריקה אם היא לא זמינה.
DealId מחרוזת מזהה העסקה הראשון שמופיע בשרשרת ה-wrapper של המודעה הנוכחית, החל מהחלק העליון, או במחרוזת הריקה אם המידע הזה לא זמין.
AdSystem מחרוזת שרת מודעות המקור של המודעה, ריק אם לא זמין.
CreativeId מחרוזת המזהה של הקריאייטיב שנבחר למודעה, ריק אם הוא לא זמין.
MediaURL מחרוזת כתובת ה-URL של המדיה שנבחרה.
Wrappers Array המערך מאוכלס ברכיבים שמתחילים במודעת ה-wrapper הפנימית ביותר (קרובה למודעה שבגוף הדף) ונעים החוצה למודעת ה-wrapper החיצונית ביותר. כל רכיב במערך הוא מילון שמכיל את המפתחות והערכים הבאים.
AdId
מחרוזת. מזהה המודעה משמש למודעת wrapper, ריק אם לא זמין.
AdSystem
מחרוזת. מערכת המודעות משמשת למודעת wrapper, ריקה אם לא זמינה.
CreativeId
מחרוזת. מזהה הקריאייטיב משמש למודעת wrapper, ריק אם לא זמין.