Códigos de erro VAST comuns e como resolvê-los
Publicados: 2022-09-04A maioria dos anúncios em vídeo na Internet deve seguir as especificações descritas pelo padrão VAST (Modelo de veiculação de anúncios em vídeo) para garantir a funcionalidade e a compatibilidade com players de vídeo. Um dos problemas mais comuns encontrados pelos editores que produzem publicidade em vídeo por meio das plataformas do Google, como YouTube e Google AdSense, são os códigos de erro VAST.
Saiba o que são códigos de erro VAST, quais são os códigos de erro mais comuns e como resolvê-los.
O que é um erro VAST?
Um código de erro de modelo de veiculação de anúncio em vídeo é um dos muitos estados de erro possíveis definidos pelo Interactive Advertising Bureau (IAB) . Um erro VAST indica um problema entre o servidor que hospeda o conteúdo do anúncio e o player de vídeo do consumidor-alvo, o que pode dificultar ou impedir a exibição adequada do anúncio .
A natureza exata do erro depende do código exibido; cada código corresponde a um problema identificado.
Desafios comuns para exibir anúncios VAST na tecnologia de anúncios
Embora a exibição de anúncios VAST tenda a ser mais simples de implementar e mais econômica a longo prazo do que soluções alternativas como Video Player-Ad Interface Definition (VPAID), o principal desafio para os editores é garantir a visibilidade do anúncio .
Muitos tipos de problemas técnicos frequentemente interrompem a visibilidade e a funcionalidade dos anúncios VAST. Em muitos casos, ocorrem interrupções devido a definições de configuração inadequadas , por parte do comprador ou do editor. Essas interrupções se manifestam na forma de códigos de erro VAST .
Os códigos de erro VAST são categorizados em dois níveis de gravidade: erros fatais e potencialmente não fatais .
Códigos comuns de erro fatal VAST e como resolvê-los
Um código de erro VAST fatal é o mais grave porque é o mais provável de ter interrompido a solicitação de anúncio , resultando em uma interrupção da exibição. Alguns erros fatais comuns do VAST incluem:
Erro VAST 100: erro de análise de XML
O VAST Error 100 é um dos erros fatais mais comuns. As causas potenciais por trás do Erro 100 do VAST incluem uma resposta do comprador malformada ou um documento XML inválido, corrompido ou formatado incorretamente . Outra possibilidade é um problema de redirecionamento de URL VAST, por exemplo, quando o redirecionamento não é resolvido corretamente.
Os editores que notarem um código de erro 100 devem alertar o comprador . Por sua vez, os compradores devem verificar se o URL VAST está configurado corretamente e, em seguida, garantir que todos os documentos XML VAST estejam funcionais e formatados corretamente com os atributos adequados.
Erro 101 do VAST: erro de validação do esquema
Um erro de validação de esquema geralmente ocorre quando a resposta do comprador não contém os elementos ou atributos XML necessários ou contém elementos não reconhecidos.
A melhor maneira de resolver um código de erro 101 é o comprador consultar a documentação do IAB , verificar as especificações VAST XML e garantir que todos os elementos necessários e formatados corretamente estejam presentes .
Erro VAST 102: versão de resposta não compatível
Esse código de erro comum é acionado quando um player de vídeo de destino não é compatível com a versão VAST da solicitação de lance. Isso também pode acontecer se a troca tiver enviado a versão VAST errada .
Em casos raros, o anúncio VAST pode não especificar um número de versão. Nesse caso, também pode ser considerado um erro de validação de esquema .
Para corrigir o erro 102, o comprador deve garantir que as respostas apresentem apenas versões VAST compatíveis .
Erro 300 do VAST: erro do wrapper
O VAST Error 300 é um erro geral do wrapper. Ele é acionado quando o limite do wrapper é atingido .
Este código de erro não é acionável; não há métodos de resolução . No entanto, há algumas etapas corretivas que podem impedir a exibição de um erro 300, como revisar periodicamente os URIs VAST e garantir que nenhum deles esteja expirando.
Erro 301 do VAST: tempo limite de redirecionamento atingido
O IAB definiu inicialmente o código de erro 301 para indicar um URI VAST com defeito, sem resposta ou com tempo limite. No entanto, os especialistas em tecnologia de anúncios normalmente associam os Error 301s a alta latência (coloquialmente conhecida como "lag") e conexões de Internet ruins ou instáveis .
Possíveis causas diretas de um erro 301 incluem:
- A configuração de tempo limite do player é muito baixa (a configuração padrão é 5)
- Dimensão do criativo incorreta (tamanho do anúncio)
- URI inválido
- Tempo limite do URI VAST
- Alta latência
- HTTP para HTTPS
- Site mal otimizado
Erro 302 do VAST: limite do wrapper atingido
O player de vídeo que recebe um anúncio normalmente é configurado com seu próprio limite de wrapper predefinido. Atingir esse limite é a causa mais comum de um código de erro 302.
Os erros 302 geralmente ocorrem devido a um número excessivo de respostas de wrapper recebidas sem uma resposta em linha. A ação corretiva é o editor aumentar o limite de wrapper do player de vídeo .
Em casos raros, o erro 302 ocorre devido ao encadeamento em série: um loop ou um número excessivo de redirecionamentos VAST antes de retornar um arquivo de mídia, fazendo com que o player de vídeo cancele a solicitação de anúncio. Nesse caso, o comprador deve garantir que nenhum redirecionamento VAST aponte para outro redirecionamento.
Erro VAST 303: resposta VAST vazia retornada
O código de erro 303 indica uma resposta VAST vazia, normalmente devido a uma solicitação de anúncio contida em um wrapper de terceiros .
Os compradores e editores que trabalham com redes de terceiros devem verificar a taxa de preenchimento , que geralmente é inferior a 100%. Por exemplo, uma taxa de preenchimento de 86% significa que há uma chance de 14% desse erro ocorrer.
Para resolver um erro VAST 303, os editores devem ativar o recurso substituto no Google Ad Manager . Siga esses passos:
- Faça login na sua conta do Google Ad Manager e abra o painel.
- Clique no botão Admin no painel esquerdo, navegue até Vídeo e, em seguida, Configurações de vídeo.
- Ative o Video Fallback e clique em Salvar.
Erro VAST 400: erro linear geral
Um erro 404 VAST geralmente é o resultado de um player de vídeo não conseguir exibir um anúncio linear .
As causas mais comuns de falha na exibição de anúncios lineares incluem:
- O navegador da web restringe a reprodução automática (autoplay) com som
- O formato MediaFile é inválido (por exemplo, não é um arquivo de vídeo válido ou formato especificado incorretamente)
- Fonte desconhecida ou não especificada
Os editores que notarem um erro 400 devem verificar se há problemas no player de vídeo e configurá-lo para detectar navegadores com reprodução automática restrita . Se essas medidas não resolverem o problema, os compradores deverão verificar a resposta do VAST e garantir que ela retorne um criativo válido .
Erro VAST 401: MediaFile não encontrado
Se você vir um código de erro 401, isso indica que o URI do MediaFile não retorna um criativo de vídeo válido ou não pode encontrar um arquivo de vídeo válido.
Os editores que encontrarem esse código de erro devem alertar os compradores o mais rápido possível e os compradores devem garantir que todos os URIs de MediaFile retornem um criativo de vídeo válido.
Erro 402 do VAST: não é possível fazer download ou tempo limite do URI do MediaFile
Um erro VAST 402 pode ter várias causas possíveis. Os quatro problemas a seguir são os mais prováveis:
- O valor (em milissegundos) na variável loadVideoTimeout no SDK do IMA do arquivo é muito baixo. Se o tempo de carregamento da página demorar mais do que esse valor, a reprodução do anúncio será cancelada , resultando possivelmente em um erro.
- Baixo desempenho ou otimização do site, causando atrasos no tempo de carregamento suficientes para cancelar a reprodução do anúncio
- O arquivo de vídeo é reproduzido automaticamente ou tentou reproduzir automaticamente em um ambiente móvel em que não se destina a se comportar dessa maneira (a maioria dos anúncios em vídeo em dispositivos móveis deve ser reproduzido com um clique, exceto em casos selecionados)
- Nos navegadores Google Chrome, exibir um anúncio em vídeo em um ambiente de reprodução automática apesar da janela não estar em foco (por exemplo, janela minimizada, guia diferente selecionada ou outro programa em outra tela ativa no momento)
Embora nem todas essas causas tenham soluções correspondentes, a solução recomendada para os editores é inspecionar o limite de tempo limite do player de vídeo e definir a variável loadVideoTimeout com um valor mais alto. O valor padrão é -1, correspondendo a 8 segundos (8.000 ms).
Outras possíveis soluções incluem a otimização do site para atingir velocidades de carregamento mais rápidas ou o ajuste da taxa de bits do vídeo para um melhor desempenho de veiculação de anúncios em dispositivos móveis.
Erro VAST 403: Resposta declarada tipos MIME não suportados para todos os arquivos de mídia
Esse código de erro está entre os encontrados com mais frequência e é mais comum em dispositivos móveis.
O código de erro 403 indica que uma resposta VAST declarou um ou vários tipos de MIME (Multipurpose Internet Mail Extensions) não suportados para todos os MediaFiles disponíveis (por exemplo, tentando reproduzir conteúdo Flash em dispositivos móveis). Esse código de erro também pode ocorrer quando o tipo de criativo incorreto tenta reproduzir .
Ao receber esse código de erro, os editores devem garantir que o formato de arquivo e a tecnologia dos anúncios sejam compatíveis com o dispositivo e o sistema operacional do player. Os compradores também devem verificar se todos os criativos retornados respeitam os formatos de vídeo da solicitação de lance (por exemplo, aplicativos para dispositivos móveis não devem solicitar criativos VPAID).
Erro 405 do VAST: erro de exibição do MediaFile
Um erro de exibição do MediaFile (VAST 405) geralmente ocorre devido a um criativo defeituoso . Os tipos de falhas comuns incluem:
- O tipo MIME e o tipo de arquivo de vídeo não correspondem
- Configuração inadequada de compartilhamento de recursos de origem cruzada (CORS) na CDN do criativo
- Problema de transcodificação
Para resolver esse problema, os compradores devem verificar se todos os tipos MIME de criativos e as opções de configuração de CDN estão corretos .
Erro VAST 406: arquivo mezanino obrigatório ausente
A causa mais comum de um código de erro 406 é uma resposta VAST retornada sem um arquivo mezanino obrigatório . Um arquivo mezanino é um arquivo de vídeo de alta qualidade e alta resolução, geralmente bruto (descompactado) ou compactado para que seja indistinguível do arquivo bruto.
Os arquivos mezanino geralmente são necessários em ambientes que dependem de implementações de anúncios do lado do servidor . Esses arquivos são empregados para gerar arquivos de vídeo de qualidade adequada para a plataforma de destino, como para ambientes móveis ou para realizar ad-stitching.
Os compradores que veem um código de erro 406 devem garantir que um arquivo mezanino apropriado seja incluído na resposta VAST .
Erro VAST 407: arquivo mezanino baixado pela primeira vez
O código de erro 407 indica que o arquivo mezanino está sendo baixado e transcodificado pela primeira vez , causando uma falha na veiculação de um anúncio. Esse código de erro é esperado e não acionável; a única ação corretiva é aguardar a conclusão do processo de transcodificação .
Dependendo do tamanho do arquivo mezanino, esse processo pode levar várias horas.
Erro 408 do VAST: anúncio rejeitado na resposta do VAST
Se você vir o código de erro 408 do VAST, isso indica que o arquivo de anúncio retornado na resposta do VAST foi rejeitado .
Os editores devem alertar os compradores sobre o erro 408 o mais rápido possível, e os compradores devem garantir que as respostas VAST contenham apenas criativos aprovados . As entidades que atuam como anfitriões de anúncios (por exemplo, a agência de publicidade ou publicação) também devem estar cientes de quaisquer rejeições de anúncios para tomar as medidas apropriadas.
Erro 409 do VAST: o criativo interativo definido no nó InteractiveCreativeFile não foi executado
A causa mais provável de um erro VAST 409 é uma falha ao reproduzir o criativo definido pelo nó Os compradores devem garantir que todos os criativos interativos (por exemplo, uma demonstração jogável de um jogo para celular) retornados na resposta VAST sejam reproduzidos corretamente quando solicitados.
Erro 410 do VAST: o código referenciado no nó de verificação não foi executado
Os erros 410 do VAST geralmente ocorrem devido a uma falha na execução do código definido no nó Os compradores devem garantir que o código AdVerification seja funcional e implementado corretamente.
Erro 500 do VAST: erro geral de anúncios não lineares
Se esse código de erro for retornado, normalmente indica que o player de vídeo não exibiu um anúncio não linear por motivos desconhecidos .
Os editores podem tentar corrigir o código de erro verificando problemas no player de vídeo e os compradores devem verificar todas as respostas VAST para garantir que retornem criativos válidos.
Erro 501 do VAST: as dimensões do criativo de anúncio não linear não se alinham com a área de exibição do criativo
Um erro VAST 501 geralmente é resultado de uma falha ao reproduzir um anúncio não linear devido a uma incompatibilidade entre as dimensões do criativo (tamanho do anúncio) e a área de exibição do criativo (espaço na tela). Especificamente, os erros 501 ocorrem quando as dimensões do criativo são muito grandes para a área de exibição (em outras palavras, o anúncio é muito grande para a tela).
Em casos mais raros, um erro 501 pode ser acionado por CSS configurado incorretamente , como estilos CSS que fixam a altura e a largura do elemento de conteúdo de vídeo.
Os editores podem corrigir esse código de erro alterando a altura e a largura definidas do criativo para corresponder à área de exibição. Se o editor tiver definido o tamanho do elemento de conteúdo de vídeo usando estilos CSS, a ação recomendada é usar atributos HTML.
Erro VAST 502: não foi possível buscar anúncios não lineares/recurso não linear
A causa mais comum de um código VAST 502 é a resposta de um comprador que retorna um anúncio não linear que não retornou um criativo válido . Os compradores devem garantir que todas as respostas de anúncios não lineares retornem criativos válidos.
Erro VAST 503: não foi possível encontrar recurso não linear com tipo compatível
Os editores que solicitam um tamanho de criativo maior do que as dimensões do player de vídeo podem encontrar um código de erro 503. Um tipo de mídia inválido pode resultar nesse código de erro em casos mais raros.
A ação corretiva recomendada é que o editor garanta que todos os tamanhos de criativos e tipos de mídia solicitados sejam compatíveis com o player de vídeo.
Erro VAST 901: erro geral de VPAID
Um erro 901 é um código de erro fatal genérico que qualquer erro VPAID pode causar. As causas possíveis incluem:
- O wrapper SSP VPAID expirou
- O wrapper SSP VPAID não está comprando
- Os criativos VPAID exigem modo não seguro
- Uso de uma tag "Adaptador do IMA" com o SDK do IMA (a tag VAST correta a ser usada é "SDK direto")
Os editores devem garantir que todas as solicitações de VPAID sejam compatíveis com dispositivos de destino e players de vídeo. O recurso de perfil de criativo em vídeo do Google pode ajudar você a gerenciar seus criativos e evitar esse código de erro.
Os compradores podem examinar as respostas VAST que retornam wrappers VPAID HTML5 e garantir que elas incluam um recurso MP4 e não abortem a reprodução.
Códigos de erro VAST potencialmente não fatais comuns e como resolvê-los
Um erro não fatal indica um problema que pode não ter impedido a exibição do anúncio. No entanto, abordar a causa do erro o mais rápido possível é fundamental para garantir o desempenho ideal e evitar erros mais graves. Veja alguns erros comuns de VAST não fatais:
Erro 200 do VAST: o player de vídeo esperava um tipo de anúncio diferente
Um erro VAST 200 geralmente ocorre quando o player de vídeo não oferece suporte ou espera o tipo de anúncio solicitado em uma solicitação de lance.
Um exemplo de um tipo de anúncio incompatível são os anúncios ignoráveis enviados a players que só podem oferecer suporte a anúncios lineares.
Os editores podem corrigir esse código de erro verificando erros de tráfego . Se o editor não conseguir resolver o problema, o comprador deverá garantir que as respostas VAST enviem apenas os tipos de anúncio especificados .
Erro VAST 201: o player de vídeo esperava uma linearidade diferente
Esse código de erro geralmente é causado por uma incompatibilidade de linearidade entre a solicitação do player de vídeo e a resposta do comprador . Um exemplo de incompatibilidade de linearidade é uma resposta VAST que envia um anúncio não linear quando a solicitação especifica um anúncio linear.
Os editores devem garantir que as solicitações de anúncios especifiquem a linearidade correta e os compradores devem verificar se as respostas VAST incluem apenas a linearidade especificada na solicitação de anúncio.
Erro VAST 202: duração diferente esperada do player de vídeo
O código de erro VAST 202 ocorre quando a resposta retorna um criativo com duração diferente da especificada . Por exemplo, se a duração especificada for 30 segundos, mas a duração real do MediaFile for 45 segundos, isso poderá resultar em um erro 202.
Os editores devem configurar corretamente a duração do criativo no Google Ad Manager e os compradores devem garantir que a resposta respeite a duração máxima especificada da solicitação.
Erro VAST 203: tamanho diferente esperado do player de vídeo
Esse código de erro geralmente é causado por uma incompatibilidade entre os MediaFiles retornados e o dispositivo de destino . Por exemplo, enviar um criativo com alta taxa de bits para dispositivos móveis, mesmo que esses dispositivos sejam mais adequados para taxas de bits mais baixas.
Os compradores podem corrigir um erro 203 garantindo que todas as respostas VAST incluam MediaFiles compatíveis com vários tipos de dispositivos e tecnologias , incluindo compatibilidade com taxa de bits.
Erro 600 do VAST: erro geral de anúncios complementares
O erro 600 é um erro genérico não fatal normalmente causado por um problema não especificado com anúncios complementares. Ocorre mais comumente quando o editor não pode exibir um anúncio complementar sem motivo especificado.
Para resolver esse código de erro, os editores podem tentar verificar possíveis problemas de veiculação de anúncios e os compradores devem garantir que as respostas VAST retornem arquivos de criativos válidos.
Erro 601 do VAST: as dimensões do criativo complementar não se alinharam com a área de exibição complementar
Esse código de erro geralmente ocorre quando o tamanho de um criativo complementar é muito grande para caber na área de exibição do anúncio complementar.
Os editores devem garantir que o tamanho do anúncio complementar solicitado (altura e comprimento) se ajuste às dimensões do bloco de anúncios.
Erro 602 do VAST: não é possível exibir o complemento obrigatório
Um erro VAST 602 significa que o editor não conseguiu renderizar o criativo complementar retornado na resposta VAST correspondente .
Esse código de erro geralmente é o sintoma de um problema de veiculação de anúncios , que os editores devem verificar e resolver. Os compradores também devem garantir que a resposta VAST retorne um criativo válido.
Erro 603 do VAST: não foi possível buscar anúncios complementares/recurso complementar
Os erros 603 vastos geralmente ocorrem quando a resposta do comprador retorna um complementar que não pôde retornar um criativo válido . O comprador deve verificar e garantir que todas as respostas de anúncios complementares retornem criativos válidos.
Erro 604 do VAST: não foi possível encontrar o recurso complementar com o tipo compatível
Um grande erro 604 geralmente é o resultado de um editor solicitando um tipo de criativo não compatível para um local de anúncio complementar.
Para resolver esse código de erro, os editores devem garantir que o local do anúncio complementar seja compatível com os tipos de criativos especificados.
Códigos de erro VAST potencialmente fatais e não fatais
Esses códigos de erro podem ou não corresponder a erros fatais.
Erro VAST 900: Erro VAST 2 (potencialmente não fatal)
Esse código de erro específico é causado por um erro VAST 2 de qualquer tipo , mesmo que versões posteriores do VAST sejam solicitadas (por exemplo, VAST 3) ou sua versão padrão da rede seja VAST 3 ou posterior.
Para resolver esse código de erro, os editores devem começar a solicitar o VAST 3 ou ativar o VAST 3 em sua rede . Os compradores são aconselhados a trabalhar com o editor para uma solução de problemas mais específica.
Erro fatal VAST 900: erro VAST 3 indefinido
Esse código de erro é retornado quando ocorre um erro VAST 3 desconhecido e interrompe a solicitação de anúncio. Devido à natureza não específica desse código de erro, é recomendável que editores e compradores trabalhem juntos para identificar o problema exato .
Práticas recomendadas para os editores lidarem com erros
Embora a melhor maneira de evitar códigos de erro de qualquer tipo seja evitar as condições necessárias para que um código de erro ocorra, às vezes eles são inevitáveis. Aqui estão algumas práticas recomendadas para os editores seguirem:
- Preste muita atenção ao número do código de erro . Muitos erros podem ser resolvidos ou mitigados sem entrar em contato com o comprador, economizando muito tempo.
- Garanta que as plataformas do lado da demanda (DSPs) tenham a oportunidade de verificar todos os criativos e resolver possíveis problemas causadores de erros antes de veicular o anúncio.
- Comunique-se e faça parceria com seus DSPs, plataformas de fornecimento (SSPs), redes de anúncios e servidores de anúncios para melhorar o desempenho de seus criativos.
Resolva os códigos de erro VAST com CodeFuel
Compreender a natureza de cada erro VAST é fundamental para resolver todos os possíveis problemas de veiculação de anúncios e otimizar o desempenho de seus anúncios em vídeo .
Se você precisar de ajuda para resolver erros de VAST , o CodeFuel pode ajudar. Nossa equipe de especialistas em anúncios em vídeo e especialistas em monetização pode ajudar e resolver quaisquer códigos de erro VAST que possam ocorrer. Contacte-nos hoje para mais informações.