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

בחירת פלטפורמה: Android חדש Android iOS

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

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

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

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

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

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

@interface ViewController () <GADFullScreenContentDelegate, GADAdMetadataDelegate>

@end

@implementation ViewController
- (void)loadRewardedAd {
   *request = [GAMRequest 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 מחרוזת מזהה העסקה הראשון שמופיע בשרשרת העטיפה של המודעה הנוכחית, החל מהחלק העליון, או המחרוזת הריקה אם המידע הזה לא זמין.
AdSystem מחרוזת שרת המודעות שמשמש כמקור של המודעה. הערך ריק אם הנתונים לא זמינים.
CreativeId מחרוזת המזהה של הקריאייטיב שנבחר למודעה. אם המזהה לא זמין, הערך יהיה ריק.
MediaURL מחרוזת כתובת ה-URL של קובץ המדיה שנבחר.
Wrappers מערך המערך מאוכלס ברכיבים שמתחילים במודעת ה-Wrapper הפנימית ביותר (קרוב למודעה משולבת בתוכן הדף) ומתקדמים החוצה למודעת ה-Wrapper החיצונית ביותר. כל רכיב במערך הוא מילון שמכיל את המפתחות והערכים הבאים.
AdId
מחרוזת. מזהה המודעה שמשמשת למודעת wrapper, ריק אם לא זמין.
AdSystem
מחרוזת. מערכת המודעות שמשמשת למודעת wrapper, ריק אם לא זמין.
CreativeId
מחרוזת. מזהה הקריאייטיב שמשמש למודעה עוטפת. אם המזהה לא זמין, הערך יהיה ריק.