Revisar o suporte ao SIMID

O SDK do Google Interactive Media Ads (IMA) para HTML5 oferece suporte à versão 1.1 da Secure Interactive Media Interface Definition (SIMID). Este guia aborda os recursos e as mensagens específicos da SIMID que o SDK do IMA oferece suporte.

Entender as mensagens do criativo para o player

A tabela a seguir lista as mensagens que o criativo da SIMID pode enviar ao SDK do IMA:

Mensagem Descrição
clickThru Processa cliques em anúncios com base no URI fornecido pelo criativo.
fatalError Encerra a sessão de anúncios e informa um erro fatal do criativo.
getMediaState Retorna o estado atual do player de mídia, incluindo URI, currentTime, duration, volume e status de desativação do som.
log Encaminha mensagens de registro do criativo para o SDK do IMA para depuração.
reportTracking Solicita que o SDK do IMA faça ping em URLs de acompanhamento em nome do criativo.
requestChangeAdDuration Solicita a modificação da duração total da sessão de anúncios.
requestNavigation Solicita a navegação para um URI externo.
requestPause Solicita que o SDK do IMA pause o player de mídia.
requestPlay Solicita que o SDK do IMA retome ou reproduza o player de mídia.
requestResize Solicita o redimensionamento do player de vídeo. Se o player permitir o redimensionamento, o SDK do IMA vai redimensioná-lo.
requestSkip Solicita que o SDK pule o anúncio atual.
requestStop Solicita que o SDK interrompa a sessão de anúncios.
handleSkipShown Notifica o SDK do IMA de que o criativo mostrou a interface de pular o anúncio.
requestFocus Solicita o foco para o iframe do criativo.

Analisar mensagens não compatíveis do criativo para o player

O SDK do IMA não processa os seguintes tipos de CreativeMessage:

  • requestChangeVolume
  • requestFullscreen
  • requestExitFullscreen

Entender as mensagens do player para o criativo

A tabela a seguir lista as mensagens que o SDK do IMA oferece suporte para enviar ao criativo da SIMID:

Mensagem Descrição
init Enviada durante a configuração da sessão com dados do ambiente e parâmetros de anúncios.
startCreative Notifica o criativo para iniciar e mostrar o iframe do criativo.
adStopped Notifica que a sessão de anúncios terminou, incluindo um código de motivo.
adSkipped Notifica o criativo de que o usuário ou o SDK do IMA pulou o anúncio.
resize Notifica o criativo sobre mudanças nas dimensões do player ou do vídeo.
appBackgrounded Notifica o criativo de que o aplicativo entrou em segundo plano.
appForegrounded Notifica o criativo de que o aplicativo retornou ao primeiro plano.
fatalError Notifica o criativo de um erro do lado do player.
log Envia mensagens de registro do player para o criativo.
focusIn Notifica que o criativo recebeu o foco.

Analisar atualizações de estado de mídia

O SDK do IMA envia mensagens mediaStateUpdate ao criativo para os seguintes eventos:

  • play
  • pause
  • stalled (armazenamento em buffer)
  • seeking
  • seeked
  • ended
  • durationchange
  • timeupdate, periodicamente.
  • volumechange, incluindo o status de desativação do som.