خلاقیت های جاوا اسکریپت VPAID 2 را فعال کنید

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

پیش‌نیازها

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

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

پرایمرهای مفید

  • اگر با VPAID 2 آشنا نیستید، می‌توانید اطلاعات بیشتر را در صفحه IAB 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، به مستندات API مربوط به ImaSdkSettings.VpaidMode مراجعه کنید.

هشدارهای پشتیبانی VPAID 2

امنیت آی‌فریم

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

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

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

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