Anúncios rich media para dispositivos móveis

O SDK dos anúncios para dispositivos móveis do Google agora tem suporte Beta para MRAID v3, baseado no suporte existente para MRAID v2, permitindo que os anunciantes veiculem criativos MRAID v3 para os editores do Ad Manager. Este guia esclarece os detalhes de implementação do MRAID que não estavam claros e abertos a interpretação nas especificações do MRAID v3. O público-alvo são os autores de criativos do MRAID v3.

Pré-requisitos

Os editores precisam executar:

  • Google Play Services 15.0.0 ou posterior para MRAID v3
  • Google Play Services 7.8 ou posterior para MRAID v2

Guias úteis

Se você não conhece o MRAID, saiba mais na página de MRAID do IAB. Também é possível fazer o download do documento Definições do MRAID v3, que fornece detalhes sobre todos os parâmetros discutidos abaixo, bem como da postagem do blog do IAB sobre o MRAID v3 (links em inglês).

Detalhes de implementação do MRAID v3 (Beta)

Visibilidade - evento de exposição

Esse evento é compatível. Recomendamos usar um listener para o novo evento exposureChange em vez do viewableChange descontinuado. O método mraid.isViewable() também foi descontinuado. No entanto, esses métodos descontinuados continuam tendo suporte para manter a compatibilidade com versões anteriores.

A definição do evento exposureChange é enviada sempre que a visualização do anúncio é alterada. O SDK tem um mecanismo de pesquisa para evitar a geração de muitos eventos. O estado inicial é enviado de forma assíncrona depois que o anúncio registra um listener. O callback inclui o parâmetro exposed_percentage, que é um número de ponto flutuante entre 0.0 e 100.0.

Consulte a especificação MRAID v3 para ver exemplos de uso.

Detecção e inicialização de MRAID e atributos MRAID_ENV

O SDK está em conformidade com o protocolo de inicialização, conforme definido na especificação MRAID v3.

No objeto MRAID_ENV, o SDK não envia IDFA, limitAdTracking, ID do app ou COPPA, que são opcionais. Ele fornece todas as variáveis obrigatórias no objeto MRAID_ENV, incluindo a versão do MRAID, o nome e a versão do SDK.

Medição de áudio

Um novo evento (audioVolumeChange) é introduzido para identificar se o áudio pode ser ouvido e quando o volume muda.

O evento audioVolumeChange tem um único parâmetro: volume_percentage. O valor é a porcentagem do volume máximo de reprodução de áudio. É um número de ponto flutuante entre 0.0 e 100.0 (0.0 quando a reprodução não é permitida) ou null se o volume não puder ser determinado.

Consulte a especificação MRAID v3 para ver exemplos de uso.

mraid.getLocation()

Como mraid.getLocation() não é compatível, ele sempre retorna -1.

mraid.unload()

Esse método pode ser chamado a qualquer momento, e o SDK reage dispensando o anúncio, desalocando os recursos e removendo a visualização da Web ou substituindo-a por outro documento ou um novo anúncio.

Quando o criativo chama unload(), a camada nativa responde da seguinte maneira para os diferentes tipos de criativos:

Tipo Comportamento de unload()
Banner Faça uma nova solicitação de anúncio com os mesmos parâmetros de solicitação do anúncio atual.
Intersticial Feche o intersticial.

VPAID (Definição de interface entre anúncio e player de vídeo)

O SDK dos anúncios para dispositivos móveis do Google não é compatível com VPAID. mraid.supports('vpaid') retorna falso.

mraid.useCustomClose()

mraid.useCustomClose() pode não ser compatível, dependendo do formato e do tipo de criativo.

Detalhes de implementação do MRAID v2

mraid.getVersion()

mraid.getVersion() não retorna 2.0 até que o criativo seja carregado. Não verifique a versão do MRAID enquanto mraid.getState() retornar loading.

mraid.resize()

Quando mraid.resize() é chamado, o banner original é substituído pela imagem da captura de tela do banner. Isso é perceptível se o anúncio redimensionado não cobrir o espaço do anúncio original.

Os anúncios redimensionados também não seguem o frame do banner original. Se um banner for colocado em uma visualização de rolagem, o anúncio redimensionado não rolará com o banner.

mraid.setResizeProperties()

Todas as chamadas para mraid.setResizeProperties() precisam conter uma lista completa das propriedades obrigatórias. Se as propriedades de redimensionamento forem inválidas, elas serão redefinidas para os padrões, e todas as chamadas subsequentes para mraid.resize() vão falhar até que mraid.setResizeProperties() seja chamado novamente com parâmetros válidos.

mraid.getMaxSize()

mraid.getMaxSize() só deve ser usado para determinar o tamanho máximo de anúncios redimensionados. Para determinar o tamanho de um anúncio expansível, use mraid.getScreenSize().

mraid.setOrientationProperties()

Ao chamar mraid.setOrientationProperties() com a propriedade allowOrientationChange definida como true, definir a propriedade forceOrientation não tem efeito. Os criativos que quiserem forçar a orientação precisam definir allowOrientationChange como false.

mraid.isViewable()

Se uma visualização cobrir um anúncio que estava visível, mraid.isViewable() ainda vai retornar true. O conteúdo do app não pode cobrir anúncios visíveis.

mraid.getCurrentPosition()

Enquanto um anúncio expansível em duas partes estiver no estado expandido, uma chamada para mraid.getCurrentPosition() na primeira parte retornará o tamanho da tela.

mraid.storePicture()

Para que um app ofereça suporte a mraid.storePicture(), ele precisa incluir a permissão android.permission.WRITE_EXTERNAL_STORAGE.