O SDK do Interactive Media Ads (IMA) do Google para HTML5 é compatível com a versão 1.1 da Definição de Interface de Mídia Interativa Segura (SIMID, na sigla em inglês). 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 do IMA:
| Mensagem | Descrição |
|---|---|
clickThru |
Processa cliques no anúncio 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, duration, volume e status de silenciado. |
log |
Encaminha mensagens de registro do criativo para o SDK do IMA para depuração. |
reportTracking |
Solicita que o SDK do IMA envie um ping para os 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 redimensionar o player. |
requestSkip |
Solicita que o SDK pule o anúncio atual. |
requestStop |
Solicita que o SDK interrompa a sessão de anúncio. |
handleSkipShown |
Notifica o SDK do IMA de que o criativo exibiu a interface de pular anúncio. |
requestFocus |
Solicita o foco para o iframe do criativo. |
Analisar mensagens de criativo não compatível com o player
O SDK do IMA não processa os seguintes tipos de CreativeMessage:
requestChangeVolumerequestFullscreenrequestExitFullscreen
Entender as mensagens do player para o criativo
A tabela a seguir lista as mensagens que o SDK do IMA pode enviar ao criativo do SIMID:
| Mensagem | Descrição |
|---|---|
init |
Enviado durante a configuração da sessão com dados do ambiente e parâmetros de anúncio. |
startCreative |
Notifica o criativo para iniciar e exibir 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 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 voltou ao primeiro plano. |
fatalError |
Notifica o criativo sobre um erro do player. |
log |
Envia mensagens de registro do player para o criativo. |
focusIn |
Notifica que o criativo recebeu foco. |
Analisar atualizações de estado de 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 do som.