O SDK de Inserção de anúncios dinâmicos (DAI, na sigla em inglês) do Google 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 de DAI oferece suporte.
Entender as mensagens do criativo para o player
A tabela a seguir lista as mensagens que o criativo da SIMID pode enviar para o IMA DAI:
| Mensagem | Descrição |
|---|---|
clickThru |
O SDK de DAI envia pings para os URLs de rastreamento de cliques configurados na tag de anúncio de DAI. O SDK de DAI ignora qualquer URI personalizado ou opções de navegação fornecidas pelo criativo. |
getMediaState |
Retorna o estado atual do player de mídia, incluindo as propriedades currentTime, duration, volume, muted, paused e fullscreen. A propriedade currentSrc sempre retorna null porque a DAI usa streams costurados do lado do servidor. |
log |
Encaminha mensagens de registro do criativo para o registro do console de depuração do SDK de DAI para solução de problemas. |
reportTracking |
Solicita que o SDK de DAI envie pings para URLs de rastreamento do criativo. |
requestPause |
Solicita que o SDK de DAI pause o player de mídia. |
requestPlay |
Solicita que o SDK de DAI retome a reprodução no player de mídia. |
requestSkip |
Solicita que o SDK de DAI pule o anúncio atual. Aceito apenas com streams de VOD. Rejeita se o criativo enviar essa mensagem para uma transmissão ao vivo. |
Analisar mensagens não aceitas do criativo para o player
O SDK de DAI não processa os seguintes tipos de CreativeMessage:
fatalErrorrequestChangeAdDurationrequestFullscreenrequestExitFullscreenhandleSkipShownrequestFocusrequestNavigation: sempre rejeitado. O player espera que o criativo processe a navegação.requestResize: sempre rejeitado. O SDK de DAI não oferece suporte ao redimensionamento de criativos.requestStop: sempre rejeitado. Esse tipo é para casos de uso de duração estendida, que a DAI não oferece suporte.requestChangeVolume: o SDK de DAI resolve esse evento com sucesso, mas não realiza mudanças de volume para o criativo.
Entender as mensagens do player para o criativo
A tabela a seguir lista as mensagens que o SDK de DAI 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úncio. |
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 de DAI pulou o anúncio. Aceito apenas com streams de VOD. |
Analisar mensagens não aceitas do player para o criativo
O SDK de DAI não oferece suporte nem envia as seguintes mensagens ao criativo:
resizeappBackgroundedappForegroundedlog
Analisar atualizações de estado de mídia
O SDK de DAI envia mensagens mediaStateUpdate ao criativo para os seguintes eventos:
playpausestalled(armazenamento em buffer)seekingseekedtimeupdate(periodicamente)volumechange(incluindo o status de desativação)
O SDK de DAI não oferece suporte aos seguintes eventos e não envia atualizações de estado de mídia quando eles ocorrem:
endeddurationchangeerror