啟用 Open Measurement
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
適用於 HTML5 的 IMA SDK 包含 Open Measurement (OM) SDK，這是由 Interactive Advertising Bureau (IAB) 開發的業界標準，可用於第三方可視度和驗證評估。使用 IMA SDK for HTML5 時，內含的 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-08-31 (世界標準時間)。
[null,null,["上次更新時間：2025-08-31 (世界標準時間)。"],[[["\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`."]]
