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.
