Dados estruturados de Perguntas e respostas (QAPage)

Ilustração de um resultado da pesquisa aprimorada de perguntas e respostas

As páginas de perguntas e respostas são páginas da Web que contêm informações no formato de uma pergunta seguida por suas respostas. Para um conteúdo que representa uma pergunta e as respectivas respostas, você pode marcar os dados com os tipos do schema.org (em inglês) QAPage, Question e Answer.

As páginas marcadas corretamente se qualificam para ter uma pesquisa aprimorada exibida na página de resultados da pesquisa. Esse tratamento avançado ajuda seu site a alcançar os usuários certos na Pesquisa. Por exemplo, talvez você veja uma pesquisa aprimorada para a consulta de usuário "Como faço para remover um cabo que está preso em uma porta USB?" se a página tiver sido marcada com respostas para essa pergunta.

Além de ativar o conteúdo para o recurso de pesquisa aprimorada, a marcação da sua página de perguntas e respostas ajuda o Google a gerar um snippet melhor para ela. O conteúdo das respostas poderá ser exibido no resultado básico se a pesquisa aprimorada não for mostrada.

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.

Exemplos

O exemplo de marcação a seguir inclui as definições de tipo QAPage, Question e Answer em JSON-LD:

JSON-LD

<html>
  <head>
    <title>How many ounces are there in a pound?</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "QAPage",
      "mainEntity": {
        "@type": "Question",
        "name": "How many ounces are there in a pound?",
        "text": "I have taken up a new interest in baking and keep running across directions in ounces and pounds. I have to translate between them and was wondering how many ounces are in a pound?",
        "answerCount": 3,
        "upvoteCount": 26,
        "datePublished": "2024-02-14T15:34-05:00",
        "author": {
          "@type": "Person",
          "name": "Mary Stone",
          "url": "https://example.com/profiles/mary-stone"
        },
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "1 pound (lb) is equal to 16 ounces (oz).",
          "image": "https://example.com/images/conversion-chart.jpg",
          "upvoteCount": 1337,
          "url": "https://example.com/question1#acceptedAnswer",
          "datePublished": "2024-02-14T16:34-05:00",
          "author": {
            "@type": "Person",
            "name": "Julius Fernandez",
            "url": "https://example.com/profiles/julius-fernandez"
          }
        },
        "suggestedAnswer": [
          {
            "@type": "Answer",
            "text": "Are you looking for ounces or fluid ounces? If you are looking for fluid ounces there are 15.34 fluid ounces in a pound of water.",
            "upvoteCount": 42,
            "url": "https://example.com/question1#suggestedAnswer1",
            "datePublished": "2024-02-14T15:39-05:00",
            "author": {
              "@type": "Person",
              "name": "Kara Weber",
              "url": "https://example.com/profiles/kara-weber"
            },
            "comment": {
              "@type": "Comment",
              "text": "I'm looking for ounces, not fluid ounces.",
              "datePublished": "2024-02-14T15:40-05:00",
              "author": {
                "@type": "Person",
                "name": "Mary Stone",
                "url": "https://example.com/profiles/mary-stone"
              }
            }
          }, {
            "@type": "Answer",
            "text": " I can't remember exactly, but I think 18 ounces in a lb. You might want to double check that.",
            "upvoteCount": 0,
            "url": "https://example.com/question1#suggestedAnswer2",
            "datePublished": "2024-02-14T16:02-05:00",
            "author": {
              "@type": "Person",
              "name": "Joe Cobb",
              "url": "https://example.com/profiles/joe-cobb"
            }
          }
        ]
      }
    }
    </script>
  </head>
  <body>
  </body>
</html>
Microdados

<html>
<body itemscope itemtype="https://schema.org/QAPage">
<div itemprop="mainEntity" itemscope itemtype="https://schema.org/Question">
   <h2 itemprop="name">How many ounces are there in a pound?</h2>
   <div itemprop="upvoteCount">52</div>
   <div itemprop="text">I have taken up a new interest in baking and keep running across directions in ounces and pounds. I have to translate between them and was wondering how many ounces are in a pound?</div>
<div>
    <div><span itemprop="answerCount">3</span> answers</div>
    <div><span itemprop="upvoteCount">26</span> votes</div>
    <div itemprop="acceptedAnswer" itemscope itemtype="https://schema.org/Answer">
       <div itemprop="upvoteCount">1337</div>
       <div itemprop="text">
       1 pound (lb) is equal to 16 ounces (oz).
       </div>
      <a itemprop="url" href="https://example.com/question1#acceptedAnswer">Answer Link</a>
      </div>
    <div itemprop="suggestedAnswer" itemscope itemtype="https://schema.org/Answer">
       <div itemprop="upvoteCount">42</div>
       <div itemprop="text">
       Are you looking for ounces or fluid ounces? If you are looking for fluid ounces there are 15.34 fluid ounces in a pound of water.
       </div>
       <a itemprop="url" href="https://example.com/question1#suggestedAnswer1">Answer Link</a>
     </div>
     <div itemprop="suggestedAnswer" itemscope itemtype="https://schema.org/Answer">
       <div itemprop="upvoteCount">0</div>
       <div itemprop="text">
       I can't remember exactly, but I think 18 ounces in a lb. You might want to double check that.
       </div>
       <a itemprop="url" href="https://example.com/question1#suggestedAnswer2">Answer Link</a>
    </div>
</div>
</div>
</body>
</html>

Diretrizes

Para que sua página de perguntas e respostas se qualifique para o tratamento aprimorado, é preciso seguir estas diretrizes:

Diretrizes de conteúdo

  • Só use a marcação QAPage se a página tiver informações em um formato de perguntas e respostas, ou seja, uma pergunta seguida pelas respostas.
  • Os usuários precisam conseguir enviar respostas para a pergunta. Não use a marcação QAPage para conteúdo que tenha somente uma resposta para uma determinada pergunta sem que os usuários possam adicionar respostas alternativas. Em vez disso, use FAQPage. Veja alguns exemplos:

    :

    • Uma página de fórum em que os usuários possam enviar respostas para uma única pergunta
    • Uma página de suporte de produto em que os usuários possam enviar respostas para uma única pergunta

    :

    • Uma página de Perguntas frequentes escrita pelo próprio site e que não permita o envio de respostas alternativas pelos usuários
    • Uma página de produto em que os usuários possam enviar várias perguntas e respostas em uma única página
    • Um guia com instruções que respondem a uma pergunta
    • Uma postagem do blog que responde a uma pergunta
    • Um texto que responde a uma pergunta
  • Não aplique a marcação QAPage a todas as páginas de um site ou fórum se nem todo o conteúdo estiver qualificado. Por exemplo, um fórum pode ter várias perguntas postadas que se qualificam individualmente para essa marcação. No entanto, se o fórum também tiver páginas que não são perguntas, essas páginas não estarão qualificadas.
  • Não use a marcação QAPage para páginas de perguntas frequentes ou que tenham várias perguntas por página. A marcação QAPage é usada para páginas que tenham como foco uma única pergunta e as respectivas respostas.
  • Não use a marcação QAPage para fins publicitários.
  • Cada Question precisa incluir todo o texto da pergunta, e cada Answer, todo o texto da resposta.
  • A marcação Answer é usada para respostas a uma pergunta, não para comentários sobre a pergunta ou sobre outras respostas. Em vez disso, use a propriedade comment e o tipo Comment para esse tipo de conteúdo.
  • O conteúdo de perguntas e respostas talvez não seja exibido como uma pesquisa aprimorada se contiver qualquer um dos seguintes tipos de conteúdo: obsceno, profano, sexualmente explícito, com violência explícita, que promova atividades perigosas ou ilegais ou discursos de ódio ou assédio.
  • As páginas de perguntas e respostas educativas, em que o foco é oferecer uma resposta correta a uma pergunta de dever de casa enviada pelos usuários podem se qualificar para uma experiência de carrossel. Essas páginas só podem ter uma única resposta fornecida ou selecionada por especialistas internos, não por usuários.
    Exemplo: uma página educativa em que um usuário envia uma pergunta e a melhor resposta é selecionada por especialistas.

Definições de tipos de dados estruturados

Esta seção descreve os tipos de dados estruturados relacionados a QAPage.

É necessário incluir as propriedades obrigatórias para que seu conteúdo seja qualificado para exibição como uma pesquisa aprimorada. Também é possível incluir as propriedades recomendadas para adicionar mais informações aos seus dados estruturados, o que pode proporcionar uma melhor experiência do usuário.

É possível usar o teste de pesquisa aprimorada do Google para validar e visualizar os dados estruturados.

QAPage

O tipo QAPage indica que o foco da página é uma pergunta específica e as respostas. Usaremos somente dados estruturados Question de páginas com marcação QAPage. Só pode haver uma definição de tipo QAPage por página.

A definição completa de QAPage está disponível em https://schema.org/QAPage (em inglês).

A tabela a seguir descreve as propriedades do tipo QAPage que são usadas pela Pesquisa Google.

Propriedades obrigatórias

mainEntity

Question

A opção Question para a página precisa ser aninhada sob a propriedade mainEntity do item QAPage.

Question

O tipo Question define a pergunta que a página responde e inclui as respostas a essa pergunta, se houver. Espera-se que haja exatamente um tipo Question na página, aninhado sob a propriedade mainEntity de schema.org/QAPage. Só pode haver uma definição de tipo Question por página.

A definição completa de Question está disponível em https://schema.org/Question. Veja as propriedades aceitas pelo Google:

Propriedades obrigatórias

answerCount

 Integer

É o número total de respostas para a pergunta. Por exemplo, se houver 15 respostas, mas somente as 10 primeiras forem marcadas devido à paginação, esse valor será 15. Ele também pode ser 0 para perguntas sem resposta.

acceptedAnswer ou suggestedAnswer Answer

Para se qualificar para a pesquisa aprimorada, uma pergunta precisa ter pelo menos uma resposta, seja acceptedAnswer ou suggestedAnswer. No entanto, as perguntas podem não ter respostas ao serem publicadas pela primeira vez. Para perguntas sem respostas, defina a propriedade answerCount como 0. Perguntas sem respostas não estão qualificadas para a pesquisa aprimorada.

acceptedAnswer

 Answer

É a resposta principal para a pergunta. Pode haver várias ou nenhuma delas por pergunta. Ela precisa representar as respostas aceitas de alguma forma no site. Por exemplo, aceitas como uma resposta principal por um autor de pergunta, moderador ou sistema de votação. Outras formas de classificação de respostas, como pela mais recente, não podem ser usadas para identificar as principais respostas.

suggestedAnswer

 Answer

É uma resposta possível, mas não aceita como resposta principal (acceptedAnswer). Pode haver várias ou nenhuma delas por pergunta.

name

 Text

É o texto completo da forma abreviada da pergunta. Por exemplo, "Quantas colheres de chá equivalem a uma xícara?"
Propriedades recomendadas

author

 Person ou Organization

Informações sobre o autor da pergunta. Para ajudar o Google a entender melhor a autoria dos vários recursos, recomendamos seguir as práticas recomendadas de marcação de autores.

Inclua o máximo de propriedades coerentes do autor, usando as propriedades compatíveis dos dados estruturados do artigo e da página de perfil como guia.

author.url

URL

É um link para uma página da Web que identifica exclusivamente o autor da pergunta, provavelmente uma página de perfil do site de perguntas e respostas. Recomendamos marcar essa página usando dados estruturados da página de perfil.

comment

Comment

Um comentário referente à pergunta, se houver. O ideal é que esse conteúdo não seja uma resposta: geralmente é um esclarecimento ou discussão sobre a questão.
dateModified

DateTime

É a data e a hora em que a resposta foi editada, se aplicável, no formato ISO 8601.
datePublished

DateTime

A data e a hora em que a pergunta foi postada no formato ISO 8601.
image

ImageObject ou URL

Imagens inline na pergunta, se aplicável.

text

 Text

É o texto completo da forma longa da pergunta. Por exemplo, "Estou cozinhando e preciso saber quantas colheres de chá são iguais a uma xícara. Quantas colheres de chá equivalem a uma xícara?".

upvoteCount

 Integer

É o número total de votos que a pergunta recebeu. Se a página for compatível com votos positivos e votos negativos, defina o valor upvoteCount como um único valor agregado que represente esses dois tipos de votos. Por exemplo, se houver 5 votos positivos e 2 votos negativos, o valor agregado usado para upvoteCount será 3. Se houver 5 votos positivos e não houver compatibilidade com votos negativos, o valor de upvoteCount será 5.
video

VideoObject

Vídeos inline na pergunta, se aplicável.

Answer

O tipo Answer define as respostas sugeridas e aceitas para Question nesta página. Defina Answers dentro de Question como valores das propriedades suggestedAnswer e acceptedAnswer.

A tabela a seguir descreve as propriedades do tipo Answer usadas em Question.

A definição completa de Answer está disponível em https://schema.org/Answer (em inglês).

Propriedades obrigatórias

text

 Text

É o texto completo da resposta. Se somente uma parte estiver marcada, talvez seu conteúdo não seja exibido, e o Google não poderá determinar o melhor texto a ser mostrado.
Propriedades recomendadas

author

 Person ou Organization

Informações sobre o autor da resposta. Para ajudar o Google a entender melhor a autoria dos vários recursos, recomendamos seguir as práticas recomendadas de marcação de autores.

Inclua o máximo de propriedades coerentes do autor, usando as propriedades compatíveis dos dados estruturados do artigo e da página de perfil como guia.

author.url

URL

Um link para uma página da Web que identifica exclusivamente o autor da resposta, provavelmente um perfil do site de perguntas e respostas. Recomendamos marcar essa página usando dados estruturados da página de perfil.

comment

Comment

Um comentário sobre a resposta, geralmente um esclarecimento ou discussão sobre ela, se aplicável.
dateModified

DateTime

É a data e a hora em que a postagem foi editada no formato ISO 8601, se aplicável.
datePublished

DateTime

A data e a hora em que a pergunta foi respondida, no formato ISO 8601.
image

ImageObject ou URL

Imagens inline na pergunta, se aplicável.

upvoteCount

 Integer

O número total de votos que a resposta recebeu, se aplicável. Se a página for compatível com votos positivos e votos negativos, defina o valor upvoteCount como um único valor agregado que represente esses dois tipos de votos. Por exemplo, se houver 5 votos positivos e 2 votos negativos, o valor agregado usado para upvoteCount será 3. Se houver 5 votos positivos e não houver compatibilidade com votos negativos, o valor de upvoteCount será 5.

url

 URL

É um URL vinculado diretamente à resposta. Exemplo: https://www.examplesite.com/question#answer1
video

VideoObject ou URL

Vídeos inline na resposta, se aplicável.

Comment

O tipo Comment pode ser usado para descrever esclarecimentos ou discussões sobre a pergunta ou resposta que não são perguntas nem respostas. Definir Comments dentro de Question ou Answer, como valores para a propriedade comment.

A definição completa de Comment está disponível em https://schema.org/Comment (em inglês).

Propriedades obrigatórias

text

 Text

O texto completo do comentário. Se apenas uma parte estiver marcada, talvez o Google não consiga determinar o melhor texto a ser exibido.
Propriedades recomendadas

author

 Person ou Organization

Informações sobre o autor do comentário. Para ajudar o Google a entender melhor a autoria dos vários recursos, recomendamos seguir as práticas recomendadas de marcação de autores.

Inclua o máximo de propriedades coerentes do autor, usando as propriedades compatíveis dos dados estruturados do artigo e da página de perfil como guia.

author.url

URL

É um link para uma página da Web que identifica exclusivamente o autor do comentário, provavelmente uma página de perfil do site de perguntas e respostas. Recomendamos marcar essa página usando dados estruturados da página de perfil.

comment

Comment

Um comentário aninhado em sequência respondendo ao comentário, se aplicável.
dateModified

DateTime

É a data e a hora em que o comentário foi editado no formato ISO 8601, se aplicável.
datePublished

DateTime

A data e a hora em que o comentário foi escrito, no formato ISO 8601.
image

ImageObject ou URL

Imagens inline no comentário, se aplicável.
video

VideoObject ou URL

Vídeos inline no comentário, se aplicável.

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.