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
- 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 item de linha.
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 |
---|---|
|
|
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();