Open Measurement را فعال کنید
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
IMA SDK برای HTML5 شامل Open Measurement (OM) SDK است، یک استاندارد صنعتی که توسط دفتر تبلیغات تعاملی (IAB) برای فعال کردن قابلیت مشاهده و اندازه‌گیری تأیید شخص ثالث ایجاد شده است. هنگام استفاده از کیت توسعه نرم افزار IMA برای HTML5، کیت توسعه نرم افزاری OM ارائه شده به طور خودکار تگ <AdVerifications> را در برچسب های تبلیغات VAST تجزیه می کند و داده های قابلیت مشاهده را با استفاده از OMID API به فروشندگان اندازه گیری مشخص شده ارسال می کند. می توانید به صورت اختیاری قوانین حالت دسترسی را برای هر درخواست تنظیم کنید تا کنترل کنید اسکریپت تأیید به چه محتوایی می تواند دسترسی داشته باشد.
IMA SDK از OM SDK v1.4 پشتیبانی می کند.
پیش نیازها
اگر از VAST 4.1 یا بالاتر استفاده می‌کنید، تبلیغات باید برای تأیید با استفاده از <AdVerifications> پیکربندی شوند. اگر از نسخه‌های قبلی VAST استفاده می‌کنید، تبلیغات باید از <Extension type="AdVerifications"> استفاده کنند.
اگر تبلیغات شما از طریق Ad Manager قاچاق می شود، یک ارائه دهنده قابلیت مشاهده برای شبکه Ad Manager خود پیکربندی کنید و آن ارائه دهنده قابلیت مشاهده را به مورد خط خود اختصاص دهید. برای اطلاعات بیشتر، به پیکربندی ارائه‌دهنده قابلیت مشاهده برای شبکه Ad Manager خود مراجعه کنید.
حالت های دسترسی
OM SDK از اجرای اسکریپت های تأیید در چهار حالت دسترسی مختلف پشتیبانی می کند که میزان دسترسی اسکریپت تأیید را کنترل می کند:
FULL : اسکریپت تأیید دسترسی مستقیم به صفحه خلاق و ناشر دارد.
CREATIVE : اسکریپت تأیید صحت و خلاقیت از صفحه ناشر در جعبه ایمنی قرار می گیرند. با این حال، فیلمنامه دسترسی مستقیم به خلاق دارد.
LIMITED : اسکریپت تأیید در جعبه ایمنی است و نمی‌تواند به صفحه خلاق یا ناشر دسترسی پیدا کند و نمی‌تواند مستقیماً تأیید کند که در کدام دامنه ناشر قرار دارد.
برخی از ارائه دهندگان قابلیت مشاهده ممکن است از همه حالت های دسترسی پشتیبانی نکنند. برای بررسی اینکه کدام حالت ها پشتیبانی می شوند، با ارائه دهندگان قابلیت مشاهده خود تماس بگیرید. قبلا، IMA از حالت دسترسی DOMAIN پشتیبانی می‌کرد که اکنون به حالت LIMITED پیش‌فرض می‌شود.
قوانین حالت دسترسی را برای یک درخواست تنظیم کنید
قوانین حالت دسترسی باید در سطح
AdsRequest تنظیم شوند. برای تنظیم حالت‌های دسترسی مختلف برای ارائه‌دهندگان مختلف اسکریپت تأیید، فرهنگ لغتی را ارسال کنید که هر
OmidVerificationVendor به یکی از حالت‌های دسترسی فهرست‌شده در بالا نگاشت می‌کند. فیلد
OmidVerificationVendor.OTHER برای تنظیم حالت دسترسی پیش‌فرض برای همه فروشندگانی که به صراحت در فرهنگ لغت گنجانده نشده‌اند، استفاده می‌شود. اگر قوانین حالت دسترسی مشخص نشده باشد، اسکریپت‌های تأیید در حالت دسترسی
LIMITED برای فروشندگان اجرا می‌شوند.
مثال زیر را ببینید که GOOGLE روی google.ima.OmidAccessMode.FULL تنظیم می کند. همه ارائه دهندگان دیگر، از جمله ارائه دهندگان فهرست شده در OmidVerificationVendor ، به طور پیش فرض نحوه تنظیم OmidVerificationVendor.OTHER را تنظیم می کنند.
request.omidAccessModeRules = {};
request.omidAccessModeRules[google.ima.OmidVerificationVendor.GOOGLE]
= google.ima.OmidAccessMode.FULL;
request.omidAccessModeRules[google.ima.OmidVerificationVendor.OTHER]
= google.ima.OmidAccessMode.LIMITED;
برای اجرای حالت دسترسی CREATIVE ، باید هر دو مرحله زیر را دنبال کنید:
پخش‌کننده ویدیوی خود را در یک iframe ایمن، جدا از سایر قسمت‌های سایتتان، Sandbox کنید.
OmidAccessMode برای شریک قابلیت مشاهده خود روی FULL تنظیم کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThe IMA SDK for HTML5 utilizes the Open Measurement (OM) SDK for third-party viewability and verification measurement, automatically sending data to specified vendors.\u003c/p\u003e\n"],["\u003cp\u003eAds must be configured to supply verification using \u003ccode\u003e<AdVerifications>\u003c/code\u003e (VAST 4.1+) or \u003ccode\u003e<Extension type="AdVerifications">\u003c/code\u003e (previous VAST versions).\u003c/p\u003e\n"],["\u003cp\u003eFour access modes (FULL, CREATIVE, DOMAIN, LIMITED) control verification script access to the creative and publisher page, impacting the level of data access.\u003c/p\u003e\n"],["\u003cp\u003eAccess mode rules are set at the \u003ccode\u003eAdsRequest\u003c/code\u003e level, allowing customized access for different verification vendors, with \u003ccode\u003eLIMITED\u003c/code\u003e as the default.\u003c/p\u003e\n"],["\u003cp\u003eImplementing \u003ccode\u003eCREATIVE\u003c/code\u003e access mode requires sandboxing the video player in a secure iframe and setting the \u003ccode\u003eOmidAccessMode\u003c/code\u003e to \u003ccode\u003eFULL\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Enable Open Measurement\n\nThe IMA SDK for HTML5 includes the\n[Open Measurement (OM) SDK](//iabtechlab.com/standards/open-measurement-sdk/),\nan industry standard developed by the\n[Interactive Advertising Bureau (IAB)](//www.iab.com/) to enable third-party\nviewability and verification measurement. When using the IMA SDK for HTML5, the\nincluded OM SDK automatically parses the `\u003cAdVerifications\u003e` tag within VAST ad\ntags and sends viewability data to the specified measurement vendors using the\nOMID API. You can optionally set access mode rules for each request to control\nwhat content the verification script can access.\n\nThe IMA SDK supports OM SDK v1.4.\n\nPrerequisites\n-------------\n\n- If using VAST 4.1 or higher, ads must be configured to supply verification\n using `\u003cAdVerifications\u003e`. If using previous VAST versions, ads must use\n `\u003cExtension type=\"AdVerifications\"\u003e`.\n\n- If your ads are trafficked through Ad Manager, configure a viewability\n provider for your Ad Manager network and assign that viewability provider to\n your line item. For more information, see\n [Configure a viewability provider for your Ad Manager network](//support.google.com/admanager/answer/9025968#configure-a-viewability-provider).\n\nAccess modes\n------------\n\nThe OM SDK supports running verification scripts in four different access modes\nwhich controls how much the verification script can access:\n\n- `FULL`: The verification script has direct access to the creative and the\n publisher page.\n\n- `CREATIVE`: The verification script and creative are sandboxed from the\n publisher page. However, the script has direct access to the creative.\n\n- `LIMITED`: The verification script is sandboxed and cannot access the creative\n or publisher page, and cannot directly confirm what publisher domain it is on.\n\nSome viewability providers might not support all access modes. Contact your\nviewability providers to verify which modes are supported. Previously, IMA\nsupported a `DOMAIN` access mode, which now defaults to `LIMITED` mode.\n\nSet the access mode rules for a request\n---------------------------------------\n\nAccess mode rules must be set at the [`AdsRequest`](/interactive-media-ads/docs/sdks/html5/client-side/reference/js/google.ima.AdsRequest#omidAccessModeRules) level. To set different access modes for different verification script providers, pass a dictionary that maps each [`OmidVerificationVendor`](/interactive-media-ads/docs/sdks/html5/client-side/reference/js/google.ima#.OmidVerificationVendor) to one of the access modes listed above. The `OmidVerificationVendor.OTHER` field is used to set the default access mode for all vendors not explicitly included in the dictionary. If no access mode rules are specified, verification scripts run in `LIMITED` access mode for vendors.\n\n\u003cbr /\u003e\n\nSee the following example which sets `GOOGLE` to\n`google.ima.OmidAccessMode.FULL`. All other providers, including those\nlisted in\n[`OmidVerificationVendor`](/interactive-media-ads/docs/sdks/html5/client-side/reference/js/google.ima#.OmidVerificationVendor),\ndefault to how `OmidVerificationVendor.OTHER` is set. \n\n request.omidAccessModeRules = {};\n request.omidAccessModeRules[google.ima.OmidVerificationVendor.GOOGLE]\n = google.ima.OmidAccessMode.FULL;\n request.omidAccessModeRules[google.ima.OmidVerificationVendor.OTHER]\n = google.ima.OmidAccessMode.LIMITED;\n\n\nTo implement `CREATIVE` access mode, you must follow both of the following\nsteps:\n\n1. Sandbox your video player in a secure iframe, isolated from the rest of your\n site.\n\n2. Set the `OmidAccessMode` for your viewability partner to `FULL`."]]
