فعال کردن طرح‌آگهی‌های جاوا اسکریپت VPAID 2

کیت توسعه نرم‌افزار IMA HTML5 از طرح‌آگهی‌های VPAID 2 JavaScript پشتیبانی می‌کند. هنگام فعال کردن پشتیبانی، دو تفاوت اصلی وجود دارد که باید بین مشخصات VPAID 2 و نحوه پشتیبانی IMA SDK از VPAID 2 به آن‌ها توجه کرد. این تفاوت‌ها بر کد پیاده‌سازی پخش‌کننده یا کیت توسعه نرم‌افزار تأثیر نمی‌گذارد، اما برای نویسندگان عناصر خلاقانه جاوا اسکریپت VPAID 2 مهم است، زیرا عناصر خلاقانه ممکن است هنگام پردازش توسط کیت توسعه نرم‌افزار IMA HTML5 خطا ایجاد کنند یا طبق انتظار کار نکنند.

پیش‌نیازها

برای دنبال کردن این راهنما، با برنامه‌ای شروع کنید که موارد زیر را داشته باشد:

  • پخش‌کننده ویدیو HTML5 با کیت توسعه نرم‌افزار IMA HTML5 ادغام شده است. اگر ندارید، راه‌اندازی IMA SDK را بررسی کنید.
  • نشانی وب برچسب آگهی VAST که به عنصر خلاق جاوا اسکریپت VPAID 2 اشاره می‌کند.

مقدمه‌های مفید

  • اگر با VPAID 2 آشنا نیستید، می‌توانید در صفحه IAB VPAID اطلاعات بیشتری بخوانید.

فعال کردن پشتیبانی از VPAID 2

برای فعال کردن پشتیبانی از جاوا اسکریپت 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، به مستندات API برای ImaSdkSettings.VpaidMode مراجعه کنید.

موارد احتیاطی پشتیبانی از VPAID 2

امنیت IFrame

به‌طور پیش‌فرض، «کیت توسعه نرم‌افزار IMA» به‌جای iframe دوستانه (همان دامنه) یا اسکریپت درون‌صفحه‌ای برای پرداز کردن عناصر خلاقانه جاوا اسکریپت VPAID 2 از iframe ایمن استفاده می‌کند. این یعنی اگر یک عنصر خلاقانه انتظار داشته باشد به «مدل شیء سند» صفحه والد دسترسی داشته باشد، این امر می‌تواند باعث بروز خطا شود. برای اینکه آگهی‌تان در iframe دوستانه پرداز شود، می‌توانید از ImaSdkSettings.setVpaidMode(...) به این صورت استفاده کنید:

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

عنصر پراکسی پخش‌کننده ویدیو

برای امنیت و عملکرد مناسب تلفن همراه، در حالت ENABLED، IMA HTML5 SDK عنصر ویدیویی واقعی را به آگهی ارائه نمی‌دهد؛ درعوض، یک عنصر پراکسی ارائه می‌دهد که بیشتر عملکرد عنصر ویدیویی عادی را تقلید می‌کند. برای عناصر خلاقانه آگهی که فقط روش‌های پشتیبانی‌شده «میانای برنامه‌سازی کاربردی» را فرا می‌خوانند، نباید هیچ‌گونه تغییر رفتاری در پرداز کردن عناصر خلاقانه وجود داشته باشد. با حالت 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

پرسشگان

آیا طرح‌آگهی‌های VPAID 2 JavaScript در کیت‌های توسعه نرم‌افزار iOS یا Android پشتیبانی می‌شوند؟
«کیت توسعه نرم‌افزار IMA HTML5» تنها پلاتفرم «کیت توسعه نرم‌افزار IMA» است که از عناصر خلاقانه جاوا اسکریپت VPAID 2 پشتیبانی می‌کند.
آیا این کار باعث فعال شدن عناصر خلاقانه VPAID در IMA HTML5 SDK می‌شود؟
بله، «کیت توسعه نرم‌افزار IMA HTML5» از عناصر خلاقانه جاوا اسکریپت VPAID 2 پشتیبانی می‌کند.