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

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