خلاقیت های جاوا اسکریپت VPAID 2

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

پیش نیازها

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

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

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

فعال کردن پشتیبانی از 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 SDK از یک iframe ایمن به جای یک iframe دوستانه (همان دامنه) یا یک اسکریپت درون صفحه برای ارائه خلاقیت های جاوا اسکریپت VPAID 2 استفاده می کند. این بدان معنی است که اگر یک خلاق انتظار دسترسی به 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 SDK تنها پلتفرم IMA SDK است که در حال حاضر از خلاقیت های جاوا اسکریپت VPAID 2 پشتیبانی می کند.
آیا این کار خلاقیت های VPAID را در IMA HTML5 SDK فعال می کند؟
بله، IMA HTML5 SDK از خلاقیت های جاوا اسکریپت VPAID 2 پشتیبانی می کند.