تصميمات إعلانات JavaScript VPAID 2

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

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

  • مشغّل فيديو HTML5 مع دمج حزمة تطوير برامج HTML5 لإعلانات الوسائط التفاعلية وإذا لم يكن لديك حساب، يمكنك الاطّلاع على دليل البدء.
  • عنوان URL لعلامة إعلان VAST التي تشير إلى تصميم إعلان جافا سكريبت VPAID 2.

مواد تمهيدية مفيدة

  • إذا لم تكن معتادًا على استخدام VPAID 2، يمكنك قراءة المزيد من المعلومات في صفحة VPAID من IAB.

تفعيل دعم 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

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

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

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

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

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

الطُرق

  • 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.