خلاقیت های جاوا اسکریپت VPAID 2 را فعال کنید
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
IMA HTML5 SDK از خلاقیت های جاوا اسکریپت VPAID 2 پشتیبانی می کند. هنگام فعال کردن پشتیبانی، دو تفاوت اصلی بین مشخصات VPAID 2 و روشی که IMA SDK از VPAID 2 پشتیبانی می‌کند وجود دارد. این تفاوت‌ها بر روی پخش‌کننده یا کد پیاده‌سازی SDK تأثیری ندارند، اما برای نویسندگان خلاق جاوا اسکریپت VPAID 2 مهم هستند، زیرا خلاق‌ها ممکن است هنگام ارائه توسط HTML5 SDKMA خطاهایی ایجاد کنند یا آنطور که انتظار می‌رود کار نکنند.
پیش نیازها
برای دنبال کردن این راهنما، با برنامه ای شروع کنید که دارای موارد زیر است:
- پخش کننده ویدئو HTML5 با IMA HTML5 SDK یکپارچه. اگر ندارید، تنظیم IMA SDK را بررسی کنید.
- یک URL تگ تبلیغات 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 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 پشتیبانی می کند.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-09-03 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-09-03 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThe IMA HTML5 SDK supports VPAID 2 JavaScript creatives, requiring a simple setup process outlined in the guide.\u003c/p\u003e\n"],["\u003cp\u003eKey differences exist between the VPAID 2 spec and the IMA SDK's implementation, primarily impacting creative authors.\u003c/p\u003e\n"],["\u003cp\u003eBy default, the SDK uses a secure iframe for rendering VPAID 2 creatives, but you can switch to a friendly iframe for DOM access.\u003c/p\u003e\n"],["\u003cp\u003eA video proxy element is used for security and mobile functionality, providing a subset of video element functionalities to the ad.\u003c/p\u003e\n"],["\u003cp\u003eVPAID 2 JavaScript creative support is currently exclusive to the IMA HTML5 SDK, not available in the iOS or Android SDKs.\u003c/p\u003e\n"]]],[],null,["# Enable VPAID 2 JavaScript creatives\n\nThe IMA HTML5 SDK supports VPAID 2 JavaScript creatives. Enabling support is easy, but there are two differences to be aware of between the [VPAID 2 spec](//iabtechlab.com/standards/video-player-ad-interface-definition-vpaid/) and the way the IMA SDK supports VPAID 2. These differences do not impact player or SDK implementation code, but they are important for VPAID 2 JavaScript creative authors, as creatives may throw errors or not work as expected when rendered by the IMA HTML5 SDK.\n\nPrerequisites\n-------------\n\n- HTML5 video player with the IMA HTML5 SDK integrated. If you don't have one, check out [Set up the IMA SDK](/interactive-media-ads/docs/sdks/html5/client-side).\n- A VAST ad tag URL that points to a VPAID 2 JavaScript creative.\n\nHelpful primers\n---------------\n\n- If you're not familiar with VPAID 2, you can read more at [IAB's VPAID page](//iabtechlab.com/standards/video-player-ad-interface-definition-vpaid/).\n\nEnabling VPAID 2 support\n------------------------\n\nTo enable VPAID 2 JavaScript support, call the following method before initializing your [AdDisplayContainer](/interactive-media-ads/docs/sdks/html5/client-side/reference/class/google.ima.AdDisplayContainer): \n\n```gdscript\n google.ima.settings.setVpaidMode(google.ima.ImaSdkSettings.VpaidMode.ENABLED);\n ...\n var adDisplayContainer = new google.ima.AdDisplayContainer(adContainerElement);\n var adsLoader = new google.ima.AdsLoader(adDisplayContainer);\n ...\n```\n\nThe available VPAID modes are as follows:\n\n- `ENABLED` - Allows VPAID ads with the default settings.\n- `INSECURE` - Allows VPAID ads in insecure mode. For more information, see [IFrame security](#iframe-security) and [Video player proxy element](#proxyelement).\n- `DISABLED` - VPAID ads do not play. If a requested ad returns a VPAID creative, an error is thrown.\n\nFor more information on VPAID modes, see the API documentation for [ImaSdkSettings.VpaidMode](/interactive-media-ads/docs/sdks/html5/client-side/reference/namespace/google.ima.ImaSdkSettings#google.ima.ImaSdkSettings.VpaidMode).\n\nVPAID 2 support caveats\n-----------------------\n\n### IFrame security\n\nBy default, the IMA SDK uses a secure iframe instead of a friendly iframe (same domain) or an in-page script to render VPAID 2 JavaScript creatives. This means that if a creative expects to access the DOM of the parent page, it could potentially cause an error. To render your ad in a friendly iframe instead, you can use `ImaSdkSettings.setVpaidMode(...)` like so: \n\n```text\nadsLoader.getSettings().setVpaidMode(google.ima.ImaSdkSettings.VpaidMode.INSECURE);\n```\n\n\u003cbr /\u003e\n\n### Video player proxy element\n\nFor security and proper mobile functionality, in `ENABLED` mode the IMA HTML5 SDK doesn't provide the actual video element to the ad; instead it provides a proxy element that mimics much of the functionality of the normal video element. For ad creatives that call only supported API methods, there should be no behavior changes in the rendering of the creatives. With `VpaidMode.INSECURE` mode, the SDK provides the video player element instead of the proxy.\n\nHere are the methods, listeners and attributes available on the video proxy element:\n\n#### Methods\n\n- `addEventListener`\n- `canPlayType`\n- `load`\n- `play`\n- `pause`\n- `setattribute`\n\n#### Event types for addEventListener\n\n- `abort`\n- `canplay`\n- `canplaythrough`\n- `click`\n- `durationchange`\n- `emptied`\n- `ended`\n- `error`\n- `loadeddata`\n- `loadedmetadata`\n- `loadstart`\n- `pause`\n- `play`\n- `playing`\n- `progress`\n- `ratechange`\n- `suspend`\n- `seeked`\n- `seeking`\n- `timeupdate`\n- `waiting`\n\n#### Attributes\n\n- `currentTime`\n- `duration`\n- `ended`\n- `paused`\n- `playbackRate`\n- `src`\n- `type`\n\nFAQ\n---\n\nAre VPAID 2 JavaScript creatives supported in the iOS or Android SDKs?\n: The IMA HTML5 SDK is the only IMA SDK platform that currently supports VPAID 2 JavaScript creatives.\n\nDoes this enable VPAID creatives in the IMA HTML5 SDK?\n: Yes, the IMA HTML5 SDK supports VPAID 2 JavaScript creatives."]]
