Gerar Schema VideoObject Sem Escrever JSON Manualmente
Preencha os campos, título, descrição, URL da miniatura, data de upload, e ele constrói um JSON-LD VideoObject válido que você pode colar diretamente na sua página. Sem escrever colchetes à mão, sem esquecer uma vírgula que quebra silenciosamente todo o bloco. Ele é executado no navegador, então os detalhes nunca saem da sua máquina.
Estes são os dados estruturados que o Google lê para mostrar uma miniatura de vídeo na pesquisa, listar seu vídeo na guia Vídeos e, às vezes, linkar para momentos chave dentro dele. Sem eles, um vídeo incorporado na sua página é frequentemente invisível para toda essa superfície.
Os Campos Que o Google Realmente Requer
A maioria dos guias de schema lista vinte propriedades opcionais e esconde as quatro que importam. Para um resultado rico de vídeo, o Google precisa exatamente destes: name, description, thumbnailUrl e uploadDate. Perder qualquer um deles e o resultado rico não aparece, ponto final.
Então há o par que decide se o vídeo pode ser indexado: contentUrl (um link direto para o arquivo de mídia, geralmente um .mp4) ou embedUrl (o src do iframe do player). Um dos dois tem que ser acessível pelo Googlebot. Um contentUrl atrás de um login ou um URL assinado que expira é a razão mais comum pela qual um schema tecnicamente válido ainda não obtém resultados.
O gerador marca esses campos obrigatórios e informa, ao vivo, se o que você digitou é suficiente para um resultado rico ou apenas o suficiente para ser válido.
Onde as Pessoas Erram na Duração e na Data
Dois campos confundem as pessoas mais que os outros.
A duração tem que ser ISO 8601, o que não é óbvio. Seis minutos e trinta segundos é PT6M30S, não 6:30 e não 390. O gerador pega minutos e segundos simples e escreve a string PT... para você, porque errar isso é silencioso, o schema valida, mas a duração não aparece.
A data de upload requer uma data de publicação real no formato YYYY-MM-DD. Se você não sabe a data exata em que um vídeo foi ao ar, o próprio arquivo geralmente sabe. O analisador de metadados de vídeo lê a data de gravação diretamente de um MP4 ou MOV, que é a fonte honesta para isso, em vez de um palpite.
Adicione, Depois Teste
Copie o bloco gerado e cole-o no <head> da página onde o vídeo está, ou em qualquer lugar no <body>, ambos funcionam. É uma tag <script type="application/ld+json">, então não renderiza nada visível, apenas fica lá para os crawlers lerem.
Então teste. Cole o URL da página no Teste de Resultados Rich do Google ou no Validador de Marcação Schema e confirme que ele é analisado sem erros e que o Google vê um vídeo. Faça isso antes de assumir que funcionou, um schema que parece correto para você ainda pode acionar um validador em um campo no qual você não pensou.
Um limite honesto: o schema não força um resultado rico. Ele torna seu vídeo elegível. O Google ainda decide se mostra a miniatura com base na consulta, na qualidade da página e em seu próprio julgamento. Marcação válida é necessária, não suficiente.
Depois da Marcação
O schema descreve o vídeo, mas uma página ranqueia por mais do que apenas a marcação. Para escrever a descrição e o título que o acompanham, o gerador de descrição de vídeo transforma o vídeo em um texto pronto para a plataforma. Para verificar o título e a descrição contra os mecanismos que decidem os cliques, execute-os através do analisador de SEO de vídeo. E se você quiser uma transcrição na página (o que ajuda tanto leitores quanto crawlers), o gerador de transcrição produz uma a partir do arquivo.
Perguntas Frequentes
O que é o schema VideoObject?
É um pedaço de dados estruturados, escrito como JSON-LD, que informa aos motores de busca que uma página contém um vídeo e lhes dá seu título, descrição, miniatura, data e duração. O Google o utiliza para exibir miniaturas de vídeo nos resultados da pesquisa e para listar o vídeo na aba Vídeos.
Este gerador de schema de vídeo é gratuito?
Sim, e funciona inteiramente no seu navegador. Não há necessidade de inscrição, upload ou limite, pois a marcação é construída no seu dispositivo a partir dos campos que você digita. Nada é enviado para um servidor.
Quais campos eu realmente preciso?
Para um resultado rico de vídeo, o Google exige name, description, thumbnailUrl e uploadDate. Para que o vídeo seja indexado, adicione contentUrl (um link direto para a mídia) ou embedUrl (a fonte do iframe do player). O gerador sinaliza quais destes estão faltando.
Por que meu schema válido ainda não está mostrando um resultado rico?
Geralmente, o contentUrl ou embedUrl não está acessível, está atrás de um login ou a URL expira. A outra causa comum é que a marcação válida apenas torna o vídeo elegível; o Google ainda escolhe se vai exibir o resultado rico para uma dada pesquisa. Teste a página no Rich Results Test para separar um problema de marcação de um de julgamento do Google.
Como eu escrevo a duração corretamente?
Use o formato ISO 8601: PT seguido de minutos e segundos, como PT6M30S para seis minutos e trinta segundos. Este gerador o escreve a partir dos números simples que você insere, então você não precisa memorizar o formato.
Onde eu colo o código?
No HTML da página onde o vídeo está, seja no <head> ou no <body>. É uma tag de script que não renderiza nada visível. Se você usa WordPress ou um CMS, a maioria tem um campo ou um plugin para adicionar JSON-LD a uma página específica.
