Open Measurement

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 ativar a medição de visibilidade e verificação de terceiros. Ao usar o SDK do IMA para HTML5, o SDK do 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ê pode definir regras de modo de acesso para cada solicitação, se quiser controlar o conteúdo que o script de verificação pode acessar.

O SDK do IMA é compatível com o SDK do OM v1.4.

Pré-requisitos

  • Se você estiver usando o VAST 4.1 ou mais recente, os anúncios precisam ser configurados para fornecer a verificação usando <AdVerifications>. Se você estiver usando versões anteriores do VAST, os anúncios precisarão usar <Extension type="AdVerifications">.

  • Se seus anúncios forem veiculados pelo Ad Manager, configure um provedor de visibilidade para sua rede do Ad Manager e atribua esse provedor ao seu item de linha. Para mais informações, consulte Configurar um provedor de visibilidade para a rede do Ad Manager.

Meios de acesso

O SDK OM oferece suporte à execução de scripts de verificação em quatro modos de acesso diferentes, que controlam o que 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 colocados em sandbox na página do editor. No entanto, o script tem acesso direto ao criativo.

  • DOMAIN: o script de verificação está no modo sandbox e não pode acessar o criativo ou a página do editor. No entanto, o script é carregado de forma que possa confirmar diretamente em qual domínio do editor ele está.

  • LIMITED: o script de verificação está em modo sandbox e não pode acessar a página do criativo ou 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.

Definir as regras do modo de acesso para uma solicitação

As regras do modo de acesso precisam ser definidas no nível AdsRequest. Para definir modos de acesso diferentes 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.

Veja o exemplo a seguir, que define GOOGLE como google.ima.OmidAccessMode.FULL. Todos os outros provedores, incluindo aqueles listados em OmidVerificationVendor, usam o padrão de como OmidVerificationVendor.OTHER é definido.

request.omidAccessModeRules = {};
request.omidAccessModeRules[google.ima.OmidVerificationVendor.GOOGLE]
    = google.ima.OmidAccessMode.FULL;
request.omidAccessModeRules[google.ima.OmidVerificationVendor.OTHER]
    = google.ima.OmidAccessMode.DOMAIN;

Para implementar o modo de acesso CREATIVE, siga as duas etapas a seguir:

  1. Coloque seu player de vídeo em um sandbox em um iframe seguro, isolado do restante do site.

  2. Defina o OmidAccessMode do parceiro de visibilidade como FULL.