فراداده آگهی

این راهنما برای ناشران در نظر گرفته شده است که فراداده تبلیغات را با Google Mobile Ads iOS SDK ادغام می کنند.

پیش نیازها

واکشی ابرداده آگهی

برای اینکه یک برنامه بیشتر درباره تبلیغاتی که ارائه می شود بداند، تبلیغ را به عنوان 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"];
}

پس از بازیابی متادیتا، می‌توانید Bundle را برای یافتن کلیدهایی که برایتان مهم هستند بررسی کنید. انواع مختلف تبلیغات ممکن است دارای کلیدهای فراداده تبلیغات متفاوتی باشند. تبلیغات ویدیویی VAST دارای کلیدهای زیر هستند:

کلید تایپ کنید شرح
AdId رشته شناسه آگهی، یا رشته خالی اگر در دسترس نیست.
AdTitle رشته عنوان، اگر مشخص نشده باشد خالی است.
CreativeDurationMs عدد صحیح مدت زمان خلاقیت انتخاب شده بر حسب میلی ثانیه، -1 اگر غیرخطی باشد.
TraffickingParameters رشته پارامترهای قاچاق، یا رشته خالی اگر در دسترس نباشد.
DealId رشته اولین شناسه معامله موجود در زنجیره بسته بندی آگهی فعلی، که از بالا شروع می شود، یا رشته خالی اگر این اطلاعات در دسترس نباشد.
AdSystem رشته سرور آگهی منبع آگهی، در صورت موجود نبودن خالی است.
CreativeId رشته شناسه خلاقیت انتخاب شده برای تبلیغ، در صورت موجود نبودن خالی است.
MediaURL رشته URL رسانه انتخاب شده.
Wrappers آرایه آرایه با عناصری پر شده است که از درونی‌ترین آگهی بسته‌بندی شروع می‌شوند (نزدیک به آگهی درون خطی) و به سمت بیرونی‌ترین آگهی بسته‌بندی حرکت می‌کنند. هر عنصر در آرایه یک فرهنگ لغت است که حاوی کلیدها و مقادیر زیر است.
AdId
رشته . شناسه آگهی استفاده شده برای آگهی بسته بندی، اگر در دسترس نباشد خالی است.
AdSystem
رشته . سیستم تبلیغاتی مورد استفاده برای تبلیغات لفاف دار، اگر در دسترس نباشد خالی است.
CreativeId
رشته . شناسه خلاق مورد استفاده برای تبلیغات بسته بندی، اگر در دسترس نباشد خالی است.