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

اختيار النظام الأساسي: Android iOS

هذا الدليل مخصّص للناشرين الذين يدمجون بيانات وصفية للإعلانات مع حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة لنظام التشغيل 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
String. معرّف الإعلان المستخدَم في الإعلان الغلافي، ويكون فارغًا إذا لم يكن متاحًا.
AdSystem
String. نظام الإعلانات المستخدَم في الإعلان المغلّف، ويكون فارغًا إذا لم يكن متاحًا.
CreativeId
String. معرّف تصميم الإعلان المستخدَم في الإعلان الإطاري، ويكون فارغًا إذا لم يكن متاحًا.