Open Measurement 사용 설정
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
HTML5용 IMA SDK에는 서드 파티 조회가능성 및 확인 측정을 지원하기 위해 Interactive Advertising Bureau (IAB)에서 개발한 업계 표준인 Open Measurement (OM) SDK가 포함되어 있습니다. HTML5용 IMA SDK를 사용하는 경우 포함된 OM SDK는 VAST 광고 태그 내의 <AdVerifications> 태그를 자동으로 파싱하고 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에서 동영상 플레이어를 샌드박스 처리합니다.
조회가능성 파트너의 OmidAccessMode를 FULL로 설정합니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-31(UTC)
[null,null,["최종 업데이트: 2025-08-31(UTC)"],[[["\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`."]]
