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

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

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

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

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

تفعيل دعم VPAID 2

لتفعيل دعم VPAID 2 JavaScript، يمكنك طلب الإجراء التالي قبل إعداد 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

أمان IFrame

وبشكلٍ تلقائي، تستخدم حزمة تطوير البرامج لإعلانات الوسائط التفاعلية إطار iframe آمن بدلاً من إطار iframe متوافق (النطاق نفسه) أو نصًا برمجيًا في الصفحة لعرض تصميمات إعلانات VPAID 2 JavaScript. وهذا يعني أنّه في حال توقّع تصميم الإعلان الوصول إلى نموذج العناصر في المستند (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

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

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