فراداده آگهی

پلتفرم مورد نظر را انتخاب کنید: اندروید (بتا)جدید اندروید، آی‌او‌اس

این راهنما برای ناشرانی در نظر گرفته شده است که می‌خواهند متادیتای تبلیغات را با 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 آرایه این آرایه با عناصری که از داخلی‌ترین پوشه (نزدیک به پوشه درون‌خطی) شروع می‌شوند و به سمت بیرونی‌ترین پوشه حرکت می‌کنند، پر شده است. هر عنصر در آرایه یک دیکشنری است که شامل کلیدها و مقادیر زیر است.
AdId
رشته . شناسه تبلیغ برای تبلیغ پوششی استفاده می‌شود، در صورت عدم وجود، خالی است.
AdSystem
رشته . سیستم تبلیغاتی مورد استفاده برای تبلیغ پوششی، در صورت عدم وجود، خالی است.
CreativeId
رشته . شناسه‌ی سازنده‌ی مورد استفاده برای تبلیغ پوششی، در صورت عدم وجود، خالی.