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

הפלטפורמה: Android iOS

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

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

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

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

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

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

@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"];
}

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

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