O SDK do Interactive Media Ads (IMA) do Google para HTML5 é compatível com a versão 1.1 da Secure Interactive Media Interface Definition (SIMID). Este guia aborda os recursos e as mensagens específicos do SIMID compatíveis com o SDK do IMA.
Entender as mensagens do criativo para o jogador
A tabela a seguir lista as mensagens que o criativo do SIMID pode enviar ao SDK da IMA:
| Mensagem | Descrição |
|---|---|
clickThru |
Processa cliques em anúncios com base no URI fornecido pelo criativo. |
fatalError |
Encerra a sessão de anúncio e informa um erro fatal do criativo. |
getMediaState |
Retorna o estado atual do player de mídia, incluindo URI, currentTime, duração, volume e status de mudo. |
log |
Encaminha mensagens de registro do criativo para o SDK do IMA para depuração. |
reportTracking |
Solicita ao SDK do IMA que faça ping nos URLs de rastreamento em nome do criativo. |
requestChangeAdDuration |
Solicitações para modificar a duração total da sessão de anúncio. |
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 pare a sessão de anúncio. |
handleSkipShown |
Notifica o SDK do IMA de que o criativo mostrou a interface de usuário para pular anúncio. |
requestFocus |
Solicita o foco do iframe do criativo. |
Revisar mensagens de criativos incompatíveis para o player
O SDK do IMA não processa os seguintes tipos de CreativeMessage:
requestChangeVolumerequestFullscreenrequestExitFullscreen
Entender as mensagens do jogador para o criativo
A tabela a seguir lista as mensagens que o SDK IMA pode enviar ao criativo SIMID:
| Mensagem | Descrição |
|---|---|
init |
Enviado durante a configuração da sessão com dados de ambiente e parâmetros de anúncio. |
startCreative |
Notifica o criativo para iniciar e mostrar o iframe do criativo. |
adStopped |
Notifica que a sessão de anúncio terminou, incluindo um código de motivo. |
adSkipped |
Notifica o criativo de que o usuário ou o SDK do IMA ignorou 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 voltou ao primeiro plano. |
fatalError |
Notifica o criativo sobre um erro do lado do player. |
log |
Envia mensagens de registro do player para o criativo. |
focusIn |
Notifica que o criativo recebeu foco. |
Analisar atualizações do estado da mídia
O SDK do IMA envia mensagens mediaStateUpdate ao criativo para os seguintes
eventos:
playpausestalled(armazenando em buffer)seekingseekedendeddurationchangetimeupdate, periodicamente.volumechange, incluindo o status de desativação.