啟用 Open Measurement
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
HTML5 適用的 IMA SDK 包含Open Measurement (OM) SDK，這是互動廣告協會 (IAB) 開發的業界標準，可評估第三方可視度和驗證。使用適用於 HTML5 的 IMA SDK 時，內含的 OM SDK 會自動剖析 VAST 廣告代碼中的 <AdVerifications> 標記，並使用 OMID API 將可視度資料傳送給指定的評估供應商。您可以視需要為每項要求設定存取模式規則，控管驗證指令碼可存取的內容。
IMA SDK 支援 OM SDK 1.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 中將影片播放器設為沙箱，與網站的其餘部分隔離。
將可視度合作夥伴的 OmidAccessMode 設為 FULL。
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-09-05 (世界標準時間)。
[null,null,["上次更新時間：2025-09-05 (世界標準時間)。"],[[["\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`."]]
