Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
O SDK do IMA para HTML5 inclui o SDK do Open Measurement (OM), um padrão do setor desenvolvido pelo Interactive Advertising Bureau (IAB) para permitir a medição de visibilidade e verificação de terceiros. Ao usar o SDK do IMA para HTML5, o SDK da OM incluído analisa automaticamente a tag <AdVerifications> nas tags de anúncio VAST e envia dados de visibilidade aos fornecedores de medição especificados usando a API OMID. Você também pode definir regras de modo de acesso para cada solicitação e controlar
o conteúdo que o script de verificação pode acessar.
O SDK do IMA é compatível com o SDK OM v1.4.
Pré-requisitos
Se você estiver usando VAST 4.1 ou uma versão mais recente, os anúncios precisarão ser configurados para fornecer verificação
usando <AdVerifications>. Se você estiver usando versões anteriores do VAST, os anúncios precisarão usar
<Extension type="AdVerifications">.
O SDK OM permite executar scripts de verificação em quatro modos de acesso diferentes
que controlam o quanto o script de verificação pode acessar:
FULL: o script de verificação tem acesso direto ao criativo e à página do editor.
CREATIVE: o script de verificação e o criativo são isolados da página do editor. No entanto, o script tem acesso direto ao criativo.
LIMITED: o script de verificação está em sandbox e não pode acessar o criativo ou a página do editor nem confirmar diretamente em qual domínio do editor ele está.
Alguns provedores de visibilidade podem não oferecer suporte a todos os modos de acesso. Entre em contato com seus provedores de visibilidade para verificar quais modos são compatíveis. Antes, a IMA
era compatível com um modo de acesso DOMAIN, que agora é o modo LIMITED por padrão.
Definir as regras de modo de acesso para uma solicitação
As regras de modo de acesso precisam ser definidas no nível
AdsRequest. Para definir diferentes modos de acesso para diferentes provedores de script de verificação, transmita um dicionário que mapeia cada
OmidVerificationVendor
para um dos modos de acesso listados acima. O campo OmidVerificationVendor.OTHER é usado para definir o modo de acesso padrão para todos os fornecedores não incluídos explicitamente no dicionário. Se nenhuma regra de modo de acesso for especificada, os scripts de verificação serão executados no modo de acesso LIMITED para fornecedores.
Confira o exemplo a seguir, que define GOOGLE como
google.ima.OmidAccessMode.FULL. Todos os outros provedores, incluindo os listados em OmidVerificationVendor, usam como padrão a configuração de OmidVerificationVendor.OTHER.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-05 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`."]]
