O Enigma do ThumbnailUrl: Um Caso Real de Dados Estruturados de Vídeo

Se você usa vídeos incorporados em páginas de serviço ou cursos no seu site, já deve ter dado de cara com algum aviso estranho no Google Search Console sobre dados estruturados de vídeo. Recentemente, resolvi um caso assim para um cliente da área de estética, e o processo de diagnóstico mostra um erro comum que quase todo mundo comete ao tentar corrigir esse tipo de problema.

O problema

Na Inspeção de URL do Search Console, uma página com 11 vídeos incorporados aparecia assim: "Vídeos: 11 itens inválidos detectados. Erro: 'O campo thumbnailUrl não foi encontrado'".

Ou seja: o Google conseguia detectar os vídeos, mas os dados estruturados (JSON-LD, do tipo VideoObject) enviados junto com a página não traziam a imagem de capa de nenhum dos 11 vídeos. Sem essa informação, o Google não consegue exibir o vídeo com destaque nos resultados de busca. O rich snippet simplesmente não é gerado.

A armadilha: seguir a pista óbvia

Minha primeira reação foi pensar que faltava configurar a capa do vídeo. E é aí que mora a armadilha: existem pelo menos três lugares diferentes onde uma "capa de vídeo" pode ser configurada num site WordPress, e só um deles realmente alimenta o schema que o Google lê.

Testei, nessa ordem, três hipóteses. As três estavam erradas:

1. A capa não estava configurada no construtor de páginas: os widgets de vídeo no Elementor já tinham a imagem de capa configurada corretamente. Hipótese descartada.
2. Um plugin de performance estava removendo o atributo poster do HTML: essa foi enganosa. O plugin de otimização (lazy loading de vídeos e iframes) realmente removia esse atributo do código publicado. Corrigi isso, e o erro no Search Console continuou exatamente igual.
3. Tentei associar a imagem diretamente ao arquivo de mídia do vídeo como "imagem destacada". Também não resolveu.

Esse segundo item foi o ponto-chave do diagnóstico. O atributo poster do HTML e o campo thumbnailUrl do schema são dois sistemas completamente independentes. Um é visual: a imagem que aparece antes de dar play no vídeo, para quem visita o site. O outro é um dado estruturado à parte, que o Google lê separadamente do HTML visual da página. Corrigir um não tem nenhum efeito sobre o outro, e é fácil perder tempo nessa pista achando que você está no caminho certo, porque tecnicamente você encontrou e corrigiu um bug real.

A causa real

A causa estava em um lugar bem mais específico. O plugin de SEO que uso no site (Rank Math, nesse caso) gera o schema de vídeo através de um construtor manual de dados estruturados, configurado na própria tela de edição da página. Cada vídeo tinha um bloco de schema próprio, do tipo "Video", e dentro de cada bloco existe um campo específico chamado "Video Thumbnail".

Esse campo, nos 11 blocos, estava vazio. Não era um bug, não era um plugin conflitando com outro. Era um campo de configuração manual que simplesmente nunca tinha sido preenchido. O Google não inventava um thumbnailUrl a partir de nenhuma outra fonte, nem do poster do HTML, nem da imagem destacada do arquivo. Se o campo do schema estivesse vazio, o campo saía vazio do JSON-LD.

A correção

1. Abri a aba de dados estruturados do plugin de SEO, na edição da página.
2. Preenchi o campo "Video Thumbnail" em cada um dos 11 blocos, com a URL da imagem de capa já usada no site.
3. Salvei cada bloco e, ao final, atualizei a página inteira. Esse passo é essencial, porque salvar cada bloco de schema só atualiza uma lista temporária na tela; só a atualização da página grava a mudança no banco de dados.
4. Conferi diretamente no código-fonte publicado que os 11 VideoObject passaram a trazer o thumbnailUrl preenchido.

Resultado, confirmado no teste em tempo real do Search Console: antes, 11 itens inválidos. Depois, 11 itens válidos.

O que fica de lição

Se você trabalha com SEO técnico, esse caso resume bem um princípio que vale a pena guardar: quando um erro de dados estruturados aparece, o problema quase nunca está onde a interface visual sugere. O Search Console fala em "vídeo", então o instinto manda ir direto ao player. Mas dados estruturados manuais, gerados por plugins de SEO, muitas vezes vivem numa camada de configuração totalmente separada do conteúdo visual da página. Só uma inspeção direta do JSON-LD publicado, não do editor visual, revela o que está de fato sendo enviado ao Google.

Se você tem vídeos no seu site e nunca conferiu como o seu plugin de SEO está gerando, ou não, o schema deles, vale a pena checar. É rápido de corrigir, mas fácil de nunca notar até o Search Console avisar.