این راهنما برای ناشرانی در نظر گرفته شده است که میخواهند متادیتای تبلیغات را با SDK 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"];
}
پس از بازیابی فراداده، میتوانید بسته را برای کلیدهای مورد نظر خود بررسی کنید. انواع مختلف تبلیغات ممکن است کلیدهای فراداده تبلیغاتی متفاوتی داشته باشند. تبلیغات ویدیویی VAST کلیدهای زیر را دارند:
| کلید | نوع | توضیحات |
|---|---|---|
AdId | رشته | شناسه تبلیغ، یا رشته خالی در صورت عدم وجود. |
AdTitle | رشته | عنوان، در صورت عدم تعیین، خالی است. |
CreativeDurationMs | عدد صحیح | مدت زمان خلاقیت انتخاب شده بر حسب میلی ثانیه، در صورت غیرخطی بودن -1 . |
TraffickingParameters | رشته | پارامترهای قاچاق، یا رشته خالی در صورت موجود نبودن. |
DealId | رشته | اولین شناسه معامله موجود در زنجیره پوششی برای تبلیغ فعلی، از بالا شروع میشود، یا اگر این اطلاعات در دسترس نباشد، رشته خالی است. |
AdSystem | رشته | سرور تبلیغاتی منبع تبلیغ، در صورت عدم دسترسی، خالی است. |
CreativeId | رشته | شناسهی آگهی تبلیغاتی انتخابشده، در صورت موجود نبودن، خالی است. |
MediaURL | رشته | آدرس اینترنتی (URL) رسانه انتخاب شده. |
Wrappers | آرایه | این آرایه با عناصری که از داخلیترین پوشه (نزدیک به پوشه درونخطی) شروع میشوند و به سمت بیرونیترین پوشه حرکت میکنند، پر شده است. هر عنصر در آرایه یک دیکشنری است که شامل کلیدها و مقادیر زیر است.
|