Open Measurement no SDK do IMA

O SDK do IMA para Android inclui o SDK do Open Measurement (OM), um padrão do setor desenvolvido pelo Interactive Advertising Bureau (IAB) para permitir a medição de verificações e visibilidade de terceiros. Ao usar o SDK do IMA para Android, o SDK do OM incluído analisa automaticamente a tag <AdVerifications> nas tags de anúncios VAST e envia dados de visibilidade para os fornecedores de medição especificados pela API OMID.O SDK do IMA oferece suporte à v1.4 do SDK do OM, às extensões de verificação de anúncios do GAM no VAST 2+ e ao nó de verificação de anúncios no VAST 4+.Para aproveitar o Open Measurement, considere os seguintes pontos:

  • Para usar o Open Measurement, você precisa ter a versão 3.11.0 ou mais recente do SDK do IMA para Android. No entanto, o exemplo neste guia foi criado para a versão mais recente do SDK e inclui APIs introduzidas na versão 3.16.5.

  • Os anúncios precisam ser configurados para transmitir <AdVerifications> no VAST, de acordo com a especificação VAST 4.1 se você estiver usando o VAST 4.1 ou mais recente. Caso contrário, use <Extension type="AdVerifications">.

  • Não cubra a AdDisplayContainer com sobreposições (transparentes ou opacas), já que elas serão sinalizadas como obstruções pelo SDK do OM e reduzirão a visibilidade.

Pré-requisitos

Teste

Para testar a medição aberta usando o SDK do IMA, use uma das versões necessárias do SDK acima com uma tag de anúncio de teste.

Você vai encontrar o <AdVerifications> retornado na resposta VAST.

Registrar obstruções na sobreposição dos controles de vídeo

Os controles de vídeo, como botões de pausa ou barras de progresso, fornecem aos usuários informações e ações essenciais de reprodução. Em dispositivos móveis, toques imprecisos e expectativas do usuário tornaram comum renderizar controles grandes e fáceis de tocar no elemento de mídia. Esses controles geralmente aparecem e desaparecem quando o usuário toca na tela e não ficam visíveis durante a maior parte do tempo de reprodução.

Confira abaixo um exemplo de controles de vídeo renderizados pelo app YouTube:

Ao usar o SDK do IMA, a maioria dos editores implementa esses controles adicionando uma visualização acima do contêiner de exibição de anúncios que é quase transparente. Normalmente, os controles são elementos filhos dessa visualização que ocultam completamente o player de vídeo. Essa sobreposição transparente é usada para capturar eventos de toque e renderizar os controles para os usuários quando eles tocam.

Quando a visibilidade do anúncio pelo SDK do Open Measurement é calculada, todas as visualizações que se sobrepõem ao elemento de mídia são consideradas obstruções e reduzem a taxa de visibilidade. No caso em que uma sobreposição de toque transparente fica acima de todo o contêiner de exibição do anúncio, é possível que o inventário seja declarado como totalmente não visível.

O SDK do Open Measurement prevê que os controles de vídeo sejam considerados obstruções "amigáveis" que são essenciais para a experiência do usuário. Depois de serem registrados como amigáveis, esses controles são excluídos da medição de visibilidade do anúncio.

Com a compatibilidade do IAB e do MRC, o SDK do IMA apresenta uma API para registrar essas sobreposições com o SDK do Open Measurement. Esses controles precisam ser sobreposições totalmente transparentes ou botões pequenos. Todas as outras visualizações não relacionadas aos controles de vídeo não precisam ser registradas.

DO registro NÃO se registre
  • Sobreposição transparente para capturar toques do usuário
  • Botões transitórios
    • Pausar
    • Reproduzir
    • Tela cheia
    • Cast/AirPlay
    • Recolher
    • Progresso/procura
    • Outras ações relevantes para a reprodução
  • Marcas-d'água
  • Pop-ups
  • Caixas de diálogo
  • Botões não temporários
  • Outras opiniões ocultas

O exemplo de código abaixo demonstra como registrar sobreposições de controles de vídeo no contêiner de exibição de anúncios:

myTransparentTapOverlay = (ViewGroup) rootView.findViewById(R.id.overlay);
myPauseButton = (ImageButton) rootView.findViewById(R.id.pauseButton);
// Substitute "myTransparentTapOverlay" and "myPauseButton" with the
// elements you want to register as video controls overlays.
// Make sure to register before ad playback starts.
overlayObstruction = ImaSdkFactory.createFriendlyObstruction(
  myTransparentTapOverlay,
  FriendlyObstructionPurpose.NOT_VISIBLE,
  "This overlay is transparent"
);
pauseButtonObstruction = ImaSdkFactory.createFriendlyObstruction(
  myPauseButton,
  FriendlyObstructionPurpose.VIDEO_CONTROLS,
  "This is the video player pause button"
);

displayContainer.registerFriendlyObstruction(overlayObstruction);
displayContainer.registerFriendlyObstruction(pauseButtonObstruction);

Quando terminar de usá-las, essas obstruções poderão ser removidas chamando o seguinte método:

displayContainer.unregisterAllFriendlyObstructions();