Dados estruturados de vídeos educacionais (LearningResource
, VideoObject
, Clip
)
![Exemplo de pesquisa aprimorada de um vídeo educacional](https://developers-dot-devsite-v2-prod.appspot.com/static/search/docs/images/learning_videos_example.png?authuser=7&hl=pt)
A Pesquisa Google é uma porta de entrada para que alunos e professores conheçam e assistam vídeos educativos. Quando você divulga explicitamente informações específicas de aprendizagem com dados estruturados, como o grau de escolaridade e as habilidades abordadas no vídeo, o Google entende melhor o conteúdo e pode oferecer uma experiência melhor para ajudar os alunos a encontrar o conteúdo que procuram.
Os dados estruturados de vídeo educativo também pode ativar ícones de informação sobre o vídeo, como o grau de escolaridade e o tipo de vídeo (por exemplo, uma visão geral ou um vídeo de solução).
![Como os ícones de informações podem aparecer abaixo de um vídeo educativo antes que o usuário toque nele](https://developers-dot-devsite-v2-prod.appspot.com/static/search/docs/images/learning_videos_pretap.png?authuser=7&hl=pt)
![Como os ícones de informações podem aparecer acima de um vídeo educativo depois que o usuário toca nele](https://developers-dot-devsite-v2-prod.appspot.com/static/search/docs/images/learning_videos_posttap.png?authuser=7&hl=pt)
Disponibilidade do recurso
A pesquisa aprimorada de vídeos educacionais pode ser acessada em inglês em todas as regiões em que a Pesquisa Google está disponível. O recurso só está disponível nas pesquisas de conteúdo de aprendizado acadêmico em computadores e dispositivos móveis.
Exemplos
Vídeo educacional único
Veja um exemplo de vídeo de aprendizado único:
<html> <head> <title>Learning video markup example</title> <script type="application/ld+json"> { "@context": "https://schema.org", "@type": ["VideoObject", "LearningResource"], "name": "An introduction to Genetics", "description": "Explanation of the basics of Genetics for beginners.", "learningResourceType": "Concept Overview", "educationalLevel": "High school (US)", "contentUrl": "https://www.example.com/video/123/file.mp4", "thumbnailUrl": [ "https://example.com/photos/1x1/photo.jpg", "https://example.com/photos/4x3/photo.jpg", "https://example.com/photos/16x9/photo.jpg" ], "uploadDate": "2024-03-31T08:00:00+08:00" } </script> </head> <body> </body> </html>
Vídeos educacionais com vários clipes
Veja um exemplo de vídeo educacional com três clipes: dois para conhecer o problema e um com a visão geral do conceito.
<html> <head> <title>Learning video and clips markup example</title> <script type="application/ld+json"> { "@context": "https://schema.org", "@type": ["VideoObject", "LearningResource"], "name": "An introduction to XYZ", "description": "Solving equations using exponent properties", "educationalLevel": "High school (US)", "educationalAlignment": { "@type": "AlignmentObject", "educationalFramework": "Common Core", "targetName": "HSA-SSE.B.3", "targetUrl": "https://www.corestandards.org/Math/Content/HSA/SSE/#CCSS.Math.Content.HSA.SSE.B.3" }, "contentUrl": "https://www.example.com/video/123/file.mp4", "thumbnailUrl": [ "https://example.com/photos/1x1/photo.jpg", "https://example.com/photos/4x3/photo.jpg", "https://example.com/photos/16x9/photo.jpg" ], "hasPart": [{ "@type": ["Clip", "LearningResource"], "learningResourceType": "Concept Overview", "name": "Understanding exponents", "startOffset": 40, "endOffset": 120, "url": "https://www.example.com/example?t=501" },{ "@type": ["Clip", "LearningResource"], "learningResourceType": "Problem Walkthrough", "name": "Example problem 1: suspended wires", "text": "Consider a weight suspended from two wires as shown in Figure. Find the tension in each wire.", "startOffset": 150, "endOffset": 225, "url": "https://www.example.com/example?t=30" },{ "@type": ["Clip", "LearningResource"], "learningResourceType": "Problem Walkthrough", "name": "Example problem 2: exponents", "text": "Consider a weight suspended from five wires as shown in Figure. Find the tension in one wire.", "startOffset": 275, "endOffset": 500, "url": "https://www.example.com/example?t=201" }], "uploadDate": "2024-03-31T08:00:00+08:00" } </script> </head> <body> </body> </html>
Vídeos tutoriais para solucionar problemas
O exemplo abaixo mostra todas as propriedades que precisam ser adicionadas à marcação de vídeos educacionais para validar os vídeos tutoriais e solucionar problemas.
<html> <head> <title>Problem Walkthrough Learning Video example</title> <script type="application/ld+json"> { "@context": "https://schema.org", "@type": ["VideoObject", "LearningResource"], "name": "Mechanics problem for Grade 10", "description": "Video walks through solution for problems in mechanics.", "learningResourceType": "Problem Walkthrough", "text": "Three balls have a mass of 2kg, 4kg and 6kg each. Find the relative velocity after collision.", "contentUrl": "https://www.example.com/video/123/file.mp4", "thumbnailUrl": [ "https://example.com/photos/1x1/photo.jpg", "https://example.com/photos/4x3/photo.jpg", "https://example.com/photos/16x9/photo.jpg" ], "uploadDate": "2024-03-31T08:00:00+08:00" } </script> </head> <body> </body> </html>
Vários clipes tutoriais para solucionar problemas
Confira um exemplo de página da Web com vários clipes tutoriais: O exemplo mostra todas as propriedades no nível de vídeo e clipe que precisam ser adicionadas à marcação de vídeos educacionais para que ela seja válida.
<html> <head> <title>Problem Walkthrough in clips in Learning Videos markup</title> <script type="application/ld+json"> { "@context": "https://schema.org", "@type": ["VideoObject", "LearningResource"], "name": "An introduction to XYZ", "description": "Solving equations using exponent properties", "learningResourceType": "Problem Walkthrough", "contentUrl": "https://www.example.com/video/123/file.mp4", "text": "Three balls have a mass of 2kg, 4kg and 6kg each. Find the relative velocity after collision.", "thumbnailUrl": [ "https://example.com/photos/1x1/photo.jpg", "https://example.com/photos/4x3/photo.jpg", "https://example.com/photos/16x9/photo.jpg" ], "hasPart": [{ "@type": ["Clip", "LearningResource"], "learningResourceType": "Problem Walkthrough", "name": "Example problem 1: suspended wires", "text": "Consider a weight suspended from two wires. Find the tension in each wire.", "startOffset": 150, "endOffset": 225, "url": "https://www.example.com/example?t=150" },{ "@type": ["Clip", "LearningResource"], "learningResourceType": "Problem Walkthrough", "name": "Example problem 2: exponents", "text": "Consider a weight suspended from five wires. Find the tension in one wire.", "startOffset": 275, "endOffset": 500, "url": "https://www.example.com/example?t=275" }], "uploadDate": "2024-03-31T08:00:00+08:00" } </script> </head> <body> </body> </html>
Como adicionar dados estruturados
Os dados estruturados são um formato padronizado para fornecer informações sobre uma página e classificar o conteúdo dela. Caso você não saiba muito sobre o assunto, veja como os dados estruturados funcionam.
Esta é uma visão geral de como criar, testar e lançar dados estruturados.
- Adicione as propriedades obrigatórias. Com base no formato que você está usando, saiba onde inserir dados estruturados na página.
- Siga as diretrizes.
- Valide o código com o Teste de pesquisa aprimorada e corrija os erros críticos. Corrija também os problemas não críticos que possam ser sinalizados na ferramenta, porque eles podem melhorar a qualidade dos dados estruturados, mas isso não é necessário para se qualificar para pesquisas aprimoradas.
- Implante algumas páginas que incluam os dados estruturados e use a Ferramenta de inspeção de URL para testar como o Google vê a página. Verifique se a página está
acessível ao Google e se não está bloqueada por um arquivo robots.txt, pela tag
noindex
ou por requisitos de login. Se estiver tudo certo, peça ao Google para rastrear novamente seus URLs. - Para informar o Google sobre mudanças futuras, recomendamos que você envie um sitemap. É possível automatizar isso com a API Search Console Sitemap.
Diretrizes
Se quiser qualificar sua página para a pesquisa aprimorada de vídeos educacionais, siga as orientações abaixo:
- Diretrizes gerais de dados estruturados
- Fundamentos da Pesquisa
- Práticas recomendadas de vídeo
- Diretrizes para sitemaps de vídeo
- Diretrizes técnicas
Diretrizes técnicas
- Além da marcação de vídeos educacionais, você
precisa adicionar as
propriedades
VideoObject
obrigatórias e recomendadas. - O vídeo precisa estar disponível publicamente para ser assistido sem uma assinatura.
- A duração total do vídeo precisa ser de no mínimo 30 segundos.
- A marcação dos vídeos educacionais precisa ser adicionada a páginas onde os usuários possam assistir o vídeo. Não direcione os usuários a uma página que não exibe o vídeo.
Definições de tipos de dados estruturados
A definição completa de VideoObject
e LearningResource
está disponível em
VideoObject
e
LearningResource
do site schema.org (links em inglês).
É necessário incluir as propriedades obrigatórias para que o conteúdo seja qualificado para a pesquisa aprimorada de vídeos educacionais. Você também pode incluir as propriedades recomendadas para adicionar mais informações sobre o conteúdo e oferecer uma melhor experiência do usuário.
Vídeo educacional [VideoObject
, LearningResource
]
A marcação de vídeos educacionais serve para aumentar a visibilidade do conteúdo educacional deles. Ela pode ter informações sobre os vários conceitos e habilidades ensinados no vídeo.
Use o tipo [VideoObject, LearningResource]
para vídeos educacionais.
Além das
propriedades VideoObject
obrigatórias e recomendadas,
adicione também o seguinte para vídeos educacionais:
Propriedades obrigatórias | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
educationalAlignment
|
É o código padrão, a classe ou o exame oficial associados ao conteúdo. Use essa
propriedade somente se o conteúdo estiver alinhado com um padrão ou exame específico. Caso contrário, use
apenas
Embora seja possível incluir vários valores de Exemplos: "educationalAlignment": { "@type": "AlignmentObject", "educationalFramework": "Common Core", "targetName": "CCSS.MATH.CONTENT.7.SP.B.4", "targetUrl": "https://www.corestandards.org/Math/Content/7/SP/B/4/" } "educationalAlignment": { "@type": "AlignmentObject", "educationalFramework": "NCERT", "targetUrl": "https://ncert.nic.in/" } |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
educationalLevel |
É o grau de escolaridade indicado do vídeo. Defina o nível educacional desejado como um valor genérico ou específico para cada país. Valores específicos para países:
Cada país tem um sistema acadêmico próprio. Defina
Exemplo: "educationalLevel": "10th Grade (AR)" Valores genéricos:
Somente um dos valores abaixo pode ser especificado como
"educationalLevel": "Beginner" |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
learningResourceType |
É o tipo de conteúdo do vídeo com base no objetivo dele. Essa propriedade pode ser usada no nível do vídeo (se ele tiver só um tipo de conteúdo) ou do clipe (se o ele tiver mais de um). A lista abaixo mostra alguns exemplos de valores aceitáveis. Crie um novo valor caso seu vídeo não se enquadre nos da lista, já que planejamos incluir novos valores compatíveis. Se o valor não estiver na lista abaixo, as informações educacionais não vão ser usadas nos recursos de pesquisa.
"learningResourceType": "Problem walkthrough" |
Propriedades recomendadas | |
---|---|
educationalAlignment.educationalFramework
|
É o nome do padrão oficial associado ao conteúdo. "educationalFramework": "Common Core" |
educationalAlignment.targetName |
É o código ou nó padrão (por exemplo, CCSS.MATH.CONTENT.7.SP.B.4, AP physics A, CCSS.MATH). "targetName": "CCSS.MATH.CONTENT.7.SP.B.4" |
educationalAlignment.targetUrl |
É o URL que leva à descrição do padrão. "targetUrl": "https://www.corestandards.org/Math/Content/8/EE/A/2/" |
hasPart |
É a lista de clipes do vídeo. Cada clipe precisa focar em um assunto ou problema específico.
As propriedades obrigatórias e recomendadas para o objeto educacional Veja um exemplo de clipe tutorial para solucionar um problema: { "@type": ["Clip","LearningResource"], "learningResourceType": "Problem Walkthrough", "name": "Example 1", "text": "Consider a weight suspended from five wires as shown in Figure. Find the tension in one wire.", "startOffset": 201, "url": "https://www.example.com/example?t=201" } Veja um exemplo de clipe que traz a visão geral de um conceito: { "@type": ["Clip","LearningResource"], "learningResourceType": "Concept Overview", "name": "ABC Law", "startOffset": 501, "url": "https://www.example.com/example?t=501" } |
text |
É o texto da pergunta sendo respondida no vídeo. Essa propriedade precisa incluir a pergunta completa, não apenas o título.
Caso seu vídeo resolva mais de um problema, será possível usar a mesma propriedade somente no
nível de "text": "Consider a weight suspended from two wires as shown in Figure. Find the tension in each wire." |
Clipes educacionais [Clip e LearningResource]
Os clipes educacionais podem ser especificados como parte da propriedade hasPart
em vídeos
desse tipo. Veja abaixo uma lista de propriedades recomendadas para clipes.
Marque os clipes educacionais com o tipo [Clip, LearningResource]
. Além
das
propriedades Clip
obrigatórias e recomendadas,
adicione o seguinte aos clipes educacionais:
Propriedades recomendadas | |
---|---|
learningResourceType |
É o tipo de conteúdo do clipe com base no objetivo dele. Se o clipe
dá um passo a passo para resolver um problema, o valor pode ser definido como
A lista abaixo mostra alguns exemplos de valores aceitáveis. Crie um novo valor caso seu clipe não se enquadre nos da lista, já que planejamos incluir novos valores compatíveis. Se o valor não estiver na lista abaixo, as informações não vão ser usadas nos recursos de pesquisa. Valores aceitáveis:
"learningResourceType": "Problem walkthrough" |
Vídeos tutoriais para solucionar problemas [VideoObject
, LearningResource
]
Esses conteúdos são um subtipo de vídeo educacional que dão um passo a passo de como resolver problemas.
Use o tipo [VideoObject, LearningResource]
no caso de vídeos tutoriais para solucionar problemas.
Além das propriedades
VideoObject
obrigatórias e recomendadas, adicione o seguinte aos
vídeos tutoriais para solucionar problemas.
Propriedades obrigatórias | |
---|---|
learningResourceType |
É o tipo de conteúdo do vídeo com base no objetivo dele. No caso de vídeos tutoriais para solucionar problemas, precisa ser definido como "Tutorial para solucionar um problema". "learningResourceType": "Problem walkthrough" |
Propriedades recomendadas | |
---|---|
hasPart |
É a lista de clipes do vídeo. Cada clipe precisar focar em um problema específico.
As propriedades obrigatórias e recomendadas para o objeto educacional Veja um exemplo de clipe com tutorial para solucionar um problema: [ { "@type": ["Clip","LearningResource"], "learningResourceType": "Problem Walkthrough", "name": "Example 1", "text": "Consider a weight suspended from five wires as shown in Figure. Find the tension in one wire.", "startOffset": 201, "url": "https://www.example.com/example?t=201" }, { "@type": ["Clip","LearningResource"], "learningResourceType": "Problem Walkthrough", "name": "Example 2", "text": "Consider two weights suspended from five wires as shown in Figure. Find the tension in all wires.", "startOffset": 501, "url": "https://www.example.com/example?t=501" } ] |
text |
É o texto da pergunta sendo respondida no vídeo.
Caso seu vídeo resolva mais de um problema, use a mesma propriedade no
nível de "text": "Consider a weight suspended from two wires as shown in Figure. Find the tension in each wire." |
Clipes tutoriais para solucionar problemas [Clip e LearningResource]
Esse conteúdo pode ser especificado como parte da propriedade hasPart
em
vídeos educacionais. Os clipes tutoriais são um subtipo de clipe educacional que dão um passo a passo para solucionar
problemas. Confira abaixo uma lista de propriedades obrigatórias no caso de clipes
tutoriais para solucionar problemas.
Use o tipo [Clip, LearningResource]
para clipes educacionais. Além das
propriedades
Clip
obrigatórias e recomendadas, adicione o seguinte a clipes tutoriais para solucionar problemas.
Propriedades obrigatórias | |
---|---|
learningResourceType |
Se o clipe dá um passo a passo para resolver um problema, o valor precisa ser definido como
"learningResourceType": "Problem walkthrough" |
Propriedades recomendadas | |
---|---|
text |
É o texto da pergunta a ser respondida no clipe. "text": "Consider a weight suspended from two wires as shown in Figure. Find the tension in each wire." |
Monitorar pesquisas aprimoradas com o Search Console
O Search Console é uma ferramenta que ajuda você a monitorar o desempenho das suas páginas na Pesquisa Google. Não é preciso se inscrever na plataforma para ser incluído nos resultados da Pesquisa Google, mas isso pode ajudar você a entender e melhorar como vemos seu site. Recomendamos verificar o Search Console nos seguintes casos:
- Depois de implantar os dados estruturados pela primeira vez
- Depois de lançar novos modelos ou atualizar o código
- Análise periódica do tráfego
Depois de implantar os dados estruturados pela primeira vez
Depois que o Google indexar as páginas, procure problemas com o relatório de status da pesquisa aprimorada relevante. Em condições ideais, vai haver um aumento de itens válidos e nenhum aumento de itens inválidos. Se você encontrar problemas nos dados estruturados, faça o seguinte:
- Corrija os itens inválidos.
- Inspecione um URL ativo para verificar se o problema persiste.
- Solicite a validação com o relatório de status.
Depois de lançar novos modelos ou atualizar o código
Ao fazer mudanças significativas no site, monitore aumentos nos itens inválidos de dados estruturados.- Caso você perceba um aumento nos itens inválidos, talvez tenha lançado um novo modelo que não funcione ou o site esteja interagindo com o modelo existente de uma maneira nova e incorreta.
- Caso você veja uma diminuição nos itens válidos (não correspondidos por um aumento nos itens inválidos), talvez não esteja mais incorporando os dados estruturados às páginas. Use a Ferramenta de inspeção de URL para saber o que está causando o problema.
Análise periódica do tráfego
Analise o tráfego da Pesquisa Google com o Relatório de desempenho. Os dados vão mostrar com que frequência sua página aparece como aprimorada na Pesquisa, com que frequência os usuários clicam nela e qual é a posição média dela nos resultados. Também é possível extrair automaticamente esses resultados com a API Search Console.Solução de problemas
Se você tiver problemas para implementar ou depurar dados estruturados, veja alguns recursos que podem ajudar.
- Se você usa um sistema de gerenciamento de conteúdo (CMS) ou se alguém está cuidando do seu site, peça ajuda para o prestador de serviço. Não se esqueça de encaminhar todas as mensagens do Search Console com os detalhes do problema.
- O Google não garante que os recursos que consomem dados estruturados vão ser exibidos nos resultados da pesquisa. Para ver uma lista de motivos comuns por que o Google pode não exibir seu conteúdo na pesquisa aprimorada, consulte as diretrizes gerais de dados estruturados.
- Pode haver um erro nos dados estruturados. Confira a lista de erros de dados estruturados e o Relatório de dados estruturados que não podem ser analisados.
- Se você recebeu uma ação manual de dados estruturados relacionada à sua página, esses dados serão ignorados, embora a página ainda possa aparecer nos resultados da Pesquisa Google. Para corrigir problemas de dados estruturados, use o Relatório de ações manuais.
- Consulte as diretrizes novamente para identificar se o conteúdo não está em conformidade com elas. O problema pode ser causado por conteúdo com spam ou uso de marcação com spam. No entanto, talvez o problema não seja de sintaxe e, por isso, o teste de pesquisa aprimorada não poderá identificá-lo.
- Resolva problemas relacionados à ausência e à queda no total de pesquisas aprimoradas.
- Aguarde algum tempo antes de voltar a rastrear e reindexar. Pode levar vários dias depois da publicação de uma página para que o Google a localize e rastreie. Para perguntas gerais sobre rastreamento e indexação, consulte as Perguntas frequentes sobre rastreamento e indexação da Pesquisa Google.
- Poste uma pergunta no fórum da Central da Pesquisa Google
O conteúdo não corresponde aos dados estruturados
error O que causou o problema: uma página inclui um conteúdo que não corresponde aos dados
estruturados dela. Por exemplo, o título de um vídeo na página não corresponde ao valor listado para
a propriedade name
. Também é possível que haja conteúdo com spam, como títulos e
descrições indutores de cliques, ou que a marcação não
represente o vídeo de fato. Você pode ter recebido a
seguinte mensagem do Search Console: "Violação da política de dados estruturados. O conteúdo das páginas é diferente
dos dados estruturados".
done Corrigir o problema
- Confira se os dados estruturados estão de acordo com o conteúdo na página.
- Use a Ferramenta de inspeção de URL para garantir que o conteúdo apareça na página renderizada (que é como o Google a vê).
- Depois de resolver o problema, envie seu site para reconsideração.