البيانات الوصفية للإعلان

هذا الدليل موجَّه للناشرين الذين يدمجون البيانات الوصفية للإعلانات مع حزمة تطوير البرامج لنظام التشغيل iOS لإعلانات Google على الأجهزة الجوّالة.

المتطلبات الأساسية

جارٍ استرجاع البيانات الوصفية للإعلان

إذا أردت أن يتعرّف تطبيق على المزيد من المعلومات عن الإعلانات المعروضة، عليك ضبط الإعلان ليكون خاصًا 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 على المفاتيح التالية:

المفتاح Type الوصف
AdId سلسلة رقم تعريف الإعلان، أو السلسلة الفارغة إذا لم يكن ذلك متاحًا.
AdTitle سلسلة حقل العنوان فارغ في حال عدم تحديده
CreativeDurationMs عدد صحيح مدة تصميم الإعلان المحدّدة بالمللي ثانية، و-1 إذا لم تكن خطية.
TraffickingParameters سلسلة مَعلمات عدد الزيارات أو السلسلة الفارغة إذا لم تكن متوفّرة.
DealId سلسلة رقم تعريف الصفقة الأول الوارد في سلسلة برامج تضمين للإعلان الحالي، بدءًا من أعلى الصفحة أو السلسلة الفارغة إذا لم تكن هذه المعلومات متاحة.
AdSystem سلسلة خادم الإعلان المصدر للإعلان، فارغًا إذا لم يكن متاحًا.
CreativeId سلسلة رقم تعريف تصميم الإعلان المحدّد للإعلان، فارغًا إذا لم يكن متاحًا.
MediaURL سلسلة تمثّل هذه السمة عنوان URL للوسائط المحدّدة.
Wrappers مصفوفة تتم تعبئة المصفوفة بعناصر تبدأ من إعلان الالتفاف الداخلي (بالقرب من الإعلان المضمّن) وتنتقل إلى خارج الإعلان الخارجي. كل عنصر في المصفوفة هو قاموس يحتوي على المفاتيح والقيم التالية.
AdId
سلسلة: رقم تعريف الإعلان مُستخدَم لإعلان برنامج تضمين، فارغًا إذا لم يكن متاحًا.
AdSystem
سلسلة: نظام إعلان مُستخدَم لإعلان الالتفاف، فارغًا إذا لم يكن متاحًا.
CreativeId
سلسلة: رقم تعريف تصميم الإعلان مُستخدَم لإعلان الالتفاف، ويكون فارغًا إذا لم يكن متاحًا.