تفعيل تصميمات الإعلانات المستندة إلى JavaScript في VPAID 2

تتوافق أداة تطوير برامج HTML5 لإعلانات الوسائط التفاعلية مع تصميمات إعلانات JavaScript لـ VPAID 2. من السهل تفعيل التوافق، ولكن هناك فرقان يجب الانتباه إليهما بين مواصفات VPAID 2 وطريقة توافق حزمة تطوير البرامج لإعلانات الوسائط التفاعلية مع VPAID 2. لا تؤثّر هذه الاختلافات في رمز تنفيذ المشغّل أو حزمة تطوير البرامج (SDK)، ولكنها مهمة لمؤلفي تصميمات الإعلانات المستندة إلى JavaScript في معيار VPAID 2، لأنّ تصميمات الإعلانات قد تُعرِض أخطاء أو لا تعمل على النحو المتوقّع عند عرضها بواسطة أداة تطوير برامج HTML5 لإعلانات الوسائط التفاعلية.

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

مقدّمات مفيدة

تفعيل التوافق مع معيار VPAID 2

لتفعيل إتاحة JavaScript في VPAID 2، استخدِم الطريقة التالية قبل بدء AdDisplayContainer:

      google.ima.settings.setVpaidMode(google.ima.ImaSdkSettings.VpaidMode.ENABLED);
      ...
      var adDisplayContainer = new google.ima.AdDisplayContainer(adContainerElement);
      var adsLoader = new google.ima.AdsLoader(adDisplayContainer);
      ...

في ما يلي أوضاع VPAID المتاحة:

  • ‫ENABLED - السماح بعرض إعلانات VPAID باستخدام الإعدادات التلقائية
  • INSECURE - السماح بعرض إعلانات VPAID في الوضع غير الآمن لمزيد من المعلومات، يُرجى الاطّلاع على أمان IFrame وعنصر الوكيل لتشغيل الفيديو.
  • DISABLED - لا يتم تشغيل إعلانات VPAID. إذا عرض إعلان مطلوب تصميم إعلان VPAID، يتم عرض خطأ.
لمزيد من المعلومات عن أوضاع VPAID، يُرجى الاطّلاع على مستندات واجهة برمجة التطبيقات الخاصة بـ ImaSdkSettings.VpaidMode.

ملاحظات حول توافق معيار VPAID 2

أمان إطارات iframe

تستخدِم أداة تطوير البرامج (SDK) لإعلانات الوسائط التفاعلية من Google تلقائيًا إطار iframe آمنًا بدلاً من إطار iframe متوافق (النطاق نفسه) أو نص برمجي داخل الصفحة لعرض تصميمات الإعلانات المستندة إلى JavaScript في VPAID 2. وهذا يعني أنّه إذا كان تصميم الإعلان يتوقّع الوصول إلى نموذج DOM للصفحة الرئيسية، قد يؤدي ذلك إلى حدوث خطأ. لعرض إعلانك في إطار iframe متوافق بدلاً من ذلك، يمكنك استخدام ImaSdkSettings.setVpaidMode(...) على النحو التالي: 

adsLoader.getSettings().setVpaidMode(google.ima.ImaSdkSettings.VpaidMode.INSECURE);

عنصر الوكيل لمشغّل الفيديو

لضمان الأمان وتوفير الوظائف المناسبة للأجهزة الجوّالة، لا توفّر أداة تطوير البرامج HTML5 لإعلانات الوسائط التفاعلية عنصر الفيديو الفعلي للإعلان في وضع ENABLED، بل تقدّم عنصرًا وكيلاً يحاكي الكثير من وظائف عنصر الفيديو العادي. بالنسبة إلى تصميمات الإعلانات التي تستدعي طرق واجهة برمجة التطبيقات المتوافقة فقط، من المفترض ألا تحدث أي تغييرات في السلوك عند عرض تصميمات الإعلانات. في وضع VpaidMode.INSECURE، توفّر حزمة تطوير البرامج عنصر مشغّل الفيديو بدلاً من الخادم الوكيل.

في ما يلي الطرق والمستمعون والسمات المتاحة في عنصر الوكيل للفيديو:

الطُرق

  • addEventListener
  • canPlayType
  • load
  • play
  • pause
  • setattribute

أنواع الأحداث لواجهة addEventListener

  • abort
  • canplay
  • canplaythrough
  • click
  • durationchange
  • emptied
  • ended
  • error
  • loadeddata
  • loadedmetadata
  • loadstart
  • pause
  • play
  • playing
  • progress
  • ratechange
  • suspend
  • seeked
  • seeking
  • timeupdate
  • waiting

السمات

  • currentTime
  • duration
  • ended
  • paused
  • playbackRate
  • src
  • type

الأسئلة الشائعة

هل يمكن استخدام تصميمات الإعلانات المستندة إلى JavaScript في معيار VPAID 2 في حِزم تطوير البرامج (SDK) لنظامَي التشغيل iOS أو Android؟
تُعدّ أداة تطوير برامج HTML5 لإعلانات الوسائط التفاعلية هي المنصة الوحيدة لحزمة تطوير برامج إعلانات الوسائط التفاعلية التي تتيح حاليًا تصميمات الإعلانات المستندة إلى JavaScript في إطار عمل VPAID 2.
هل يؤدي ذلك إلى تفعيل تصميمات إعلانات VPAID في أداة تطوير برامج HTML5 لإعلانات الوسائط التفاعلية؟
نعم، تتيح أداة تطوير برامج HTML5 لإعلانات الوسائط التفاعلية استخدام تصميمات الإعلانات المستندة إلى JavaScript في معيار VPAID 2.