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

בחירת פלטפורמה: Android (גרסת בטא) חדש Android iOS

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

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

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

כדי שהאפליקציה תקבל מידע נוסף על המודעות שמוצגות בה, צריך להגדיר את המודעה כGADAdMetadataDelegate. לאחר מכן, אפשר להאזין לשינויים במטא-נתונים של המודעות על ידי הטמעה של השיטה adMetadataDidChange: ב-GADAdMetadataDelegate. אחרי שקוראים לפונקציית ה-delegate הזו, בודקים את המאפיין 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
String. מזהה המודעה שמשמש למודעת wrapper, ריק אם לא זמין.
AdSystem
String. מערכת המודעות שמשמשת למודעת wrapper, ריק אם לא זמין.
CreativeId
String. מזהה הקריאייטיב שמשמש למודעה עוטפת. אם המזהה לא זמין, הערך יהיה ריק.