تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

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

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

الحد الأدنى للإصدار 7.41.0 من حزمة "SDK لإعلانات 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` سلسلة: رقم تعريف تصميم الإعلان مُستخدَم لإعلان الالتفاف، ويكون فارغًا إذا لم يكن متاحًا.