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

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

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

لمتابعة هذا الدليل، ابدأ بتطبيق يتضمّن ما يلي:

مقدمات مفيدة

  • إذا لم تكن على دراية بإصدار معيار دقّة واجهة عرض الإعلانات على مشغّل الفيديو (VPAID) 2، يمكنك الاطّلاع على مزيد من المعلومات في صفحة IAB VPAID.

تفعيل التوافق مع الإصدار 2 من VPAID

لتفعيل توافق 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.

ملاحظات حول توافق الإصدار 2 من VPAID

أمان إطار IFrame

تستخدم حزمة تطوير البرامج للإعلانات التفاعلية من Google تلقائيًا إطار iframe آمنًا بدلاً من إطار iframe سهل الاستخدام (النطاق نفسه) أو نص برمجي داخل الصفحة لعرض مواد عرض JavaScript الإبداعية المتوافقة مع معيار دقّة واجهة عرض الإعلانات على مشغّل الفيديو (VPAID‏) 2. وهذا يعني أنّه إذا كان تصميم الإعلان يتوقّع الوصول إلى نموذج المستند الخاص بالصفحة الرئيسية، قد يؤدي ذلك إلى حدوث خطأ. لعرض إعلانك في إطار 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 مع حِزم تطوير البرامج لنظام التشغيل iOS أو Android؟
إنّ حزمة تطوير البرامج HTML5 لإعلانات الوسائط التفاعلية هي منصة حزمة تطوير البرامج الوحيدة التي تتوافق مع مواد عرض JavaScript الإبداعية المتوافقة مع معيار دقّة واجهة عرض الإعلانات على مشغّل الفيديو 2 (VPAID 2).
هل يتيح ذلك استخدام تصاميم إعلانات VPAID في أداة تطوير برامج HTML5 لإعلانات الوسائط التفاعلية؟
نعم، تتوافق حزمة تطوير البرامج لإعلانات الوسائط التفاعلية (IMA) بتنسيق HTML5 مع تصاميم JavaScript الإبداعية المتوافقة مع معيار دقّة واجهة عرض الإعلانات على مشغّل الفيديو (VPAID) 2.