Dados estruturados de vídeos educacionais (LearningResource, VideoObject, Clip)

Exemplo de pesquisa aprimorada de um vídeo educacional

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 Como os ícones de informações podem aparecer acima de um vídeo educativo depois que o usuário toca nele

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>

Clipes tutoriais para solucionar vários problemas

Veja um exemplo de página da Web com clipes tutoriais para solucionar vários problemas. 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.

  1. Adicione as propriedades obrigatórias. Com base no formato que você está usando, saiba onde inserir dados estruturados na página.
  2. Siga as diretrizes.
  3. 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.
  4. 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.
  5. 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 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

AlignmentObject

É 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 educationalLevel. Se incluir a propriedade educationalAlignment, adicione as seguintes propriedades (conforme aplicável):

Embora seja possível incluir vários valores de educationalAlignment, não é garantido que todos eles sejam usados para recursos de vídeo de aprendizado. Se vários valores forem incluídos e o recurso puder usar apenas um valor educationalAlignment, ele vai usar o primeiro valor informado.

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

Text

É 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 educationalLevel como um dos valores de nível compatíveis com base no país aplicável para o vídeo.

  • View all
  • Algeria
  • Argentina
  • Australia
  • Austria
  • Azerbaijan
  • Bahrain
  • Bangladesh
  • Belarus
  • Belgium
  • Bolivia
  • Bosnia and Herzegovina
  • Brazil
  • Bulgaria
  • Canada
  • Chile
  • Colombia
  • Costa Rica
  • Croatia
  • Cyprus
  • Czechia
  • Denmark
  • Dominican Republic
  • Ecuador
  • Egypt
  • El Salvador
  • England
  • Estonia
  • Finland
  • France
  • Georgia
  • Germany
  • Ghana
  • Greece
  • Guatemala
  • Honduras
  • Hong Kong
  • Hungary
  • Iceland
  • India
  • Indonesia
  • Iraq
  • Ireland
  • Israel
  • Italy
  • Jamaica
  • Japan
  • Jordan
  • Kazakhstan
  • Kenya
  • Kuwait
  • Latvia
  • Lebanon
  • Libya
  • Liechtenstein
  • Lithuania
  • Luxembourg
  • Malaysia
  • Malta
  • Mexico
  • Montenegro
  • Morocco
  • Nepal
  • Netherlands
  • New Zealand
  • Nicaragua
  • Nigeria
  • North Macedonia
  • Northern Ireland
  • Norway
  • Oman
  • Pakistan
  • Panama
  • Papua New Guinea
  • Paraguay
  • Peru
  • Philippines
  • Poland
  • Portugal
  • Puerto Rico
  • Qatar
  • Romania
  • Russia
  • Saudi Arabia
  • Scotland
  • Senegal
  • Serbia
  • Singapore
  • Slovakia
  • Slovenia
  • South Africa
  • South Korea
  • Spain
  • Sri Lanka
  • Sweden
  • Switzerland
  • Taiwan
  • Tanzania
  • Thailand
  • Tunisia
  • Türkiye
  • Uganda
  • Ukraine
  • United Arab Emirates
  • United States
  • Venezuela
  • Vietnam
  • Wales
  • Yemen
  • Zimbabwe

Country Supported values
Algeria
  • Lower Secondary School (DZ)
  • Grade 8 (DZ)
  • Grade 9 (DZ)
  • Upper Secondary School (DZ)
  • Grade 10 (DZ)
  • Grade 11 (DZ)
  • Grade 12 (DZ)
  • Higher Education (DZ)

Exemplo:

"educationalLevel": "10th Grade (AR)"

Valores genéricos:

Somente um dos valores abaixo pode ser especificado como educationalLevel.

  • Beginner: nenhum conhecimento prévio é necessário para entender o conteúdo
  • Intermediate: talvez seja necessário algum conhecimento para entender o conteúdo
  • Advanced: o conteúdo é de nível avançado e para quem já têm conhecimento sobre o assunto
"educationalLevel": "Beginner"
learningResourceType

Text

É 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 a seguir 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 não serão usadas nos recursos de pesquisa.

    • Concept overview: o vídeo explica um assunto ou conceito.
    • Problem walkthrough: o vídeo mostra o método ou as etapas para resolver um problema acadêmico, como de matemática ou ciências.
    • Real life example: o vídeo mostra como um conceito é aplicado ou usado na vida real.
    • Activity: o vídeo mostra ou aplica uma atividade de aprendizagem, como jogos de improviso, mapas de conceitos, revisões por pares ou criações de debates.
    • Experiment: o vídeo mostra um experimento.
    • Lecture: o vídeo mostra uma aula, palestra ou webinar.
    • How-to: o vídeo apresenta um método ou etapas para fazer algo. Para vídeos que resolvem problemas processuais de ciência, tecnologia, engenharia e matemática (STEM), use o tipo Problem walkthrough.
    • Tips: o vídeo dá dicas e sugestões.
    "learningResourceType": "Problem walkthrough"
Propriedades recomendadas
educationalAlignment.educationalFramework

Text

É o nome do padrão oficial associado ao conteúdo.

"educationalFramework": "Common Core"
educationalAlignment.targetName

Text

É 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

Url

É o URL que leva à descrição do padrão.

"targetUrl": "https://www.corestandards.org/Math/Content/8/EE/A/2/"
hasPart

Clip

É 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 Clip são listadas em uma tabela separada.

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

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 Clip.

"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

Text

É 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 "Problem walkthrough". Se o clipe explica algum conceito, o valor pode ser definido como "Concept overview".

A lista a seguir 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 poderão não ser usadas nos recursos de pesquisa.

Valores aceitáveis:

  • Concept overview: o clipe explica um assunto ou conceito.
  • Problem walkthrough: o clipe mostra o método ou as etapas para resolver um problema acadêmico, como de matemática ou ciências.
  • Real life application: o clipe mostra como um conceito é aplicado ou usado na vida real.
  • Activity: o clipe mostra ou aplica uma atividade de aprendizagem, como jogos de improviso, mapas de conceitos, revisões por pares ou criações de debates.
  • Science experiment: o clipe mostra um experimento científico.
  • Lecture: o clipe mostra uma aula, palestra ou webinar.
  • How-to: o clipe apresenta um método ou etapas para fazer algo. Para clipes que resolvem problemas processuais de ciência, tecnologia, engenharia e matemática (STEM), use o tipo Problem walkthrough.
  • Tips: o clipe dá dicas e sugestões.
"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

Text

É 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

Clip

É 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 Clip são listadas em uma tabela separada.

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

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 Clip.

"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

Text

Se o clipe dá um passo a passo para resolver um problema, o valor precisa ser definido como "Problem walkthrough".

"learningResourceType": "Problem walkthrough"
Propriedades recomendadas
text

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:

  1. Depois de implantar os dados estruturados pela primeira vez
  2. Depois de lançar novos modelos ou atualizar o código
  3. 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:

  1. Corrija os itens inválidos.
  2. Inspecione um URL ativo para verificar se o problema persiste.
  3. 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.

O conteúdo não corresponde aos dados estruturados

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".

Corrigir o problema

  1. Confira se os dados estruturados estão de acordo com o conteúdo na página.
  2. 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ê).
  3. Depois de resolver o problema, envie seu site para reconsideração.