Datos estructurados de preguntas y respuestas (QAPage)

Ilustración de un resultado enriquecido de preguntas y respuestas

Las páginas de preguntas son páginas web que contienen datos en formato de preguntas seguidas de sus respuestas. Para el contenido que representa una pregunta y sus respuestas, puedes marcar los datos con los tipos de schema.org QAPage, Question y Answer.

Las páginas que incluyen el lenguaje de marcado correcto pueden aparecer como resultados enriquecidos en la página de resultados de búsqueda. Este tratamiento enriquecido ayuda a que tu sitio llegue a los usuarios indicados cuando usan la Búsqueda. Por ejemplo, es posible que veas un resultado enriquecido para la consulta del usuario "¿Cómo quitar un cable atascado en un puerto USB?" si se marcó la página con respuestas a esa pregunta.

Además de habilitar tu contenido para el tratamiento de resultados enriquecidos, marcar tu página de preguntas y respuestas ayuda a Google a generar un mejor fragmento para tu página. El contenido de las respuestas podría aparecer como resultado básico si no se muestra el enriquecido.

如何添加结构化数据

结构化数据是一种提供网页相关信息并对网页内容进行分类的标准化格式。如果您不熟悉结构化数据,可以详细了解结构化数据的运作方式

下面概述了如何构建、测试和发布结构化数据。如需获得向网页添加结构化数据的分步指南,请查看结构化数据 Codelab

  1. 添加必要属性。根据您使用的格式,了解在网页上的什么位置插入结构化数据
  2. 遵循指南
  3. 使用富媒体搜索结果测试验证您的代码,并修复所有严重错误。此外,您还可以考虑修正该工具中可能会标记的任何非严重问题,因为这些这样有助于提升结构化数据的质量(不过,要使内容能够显示为富媒体搜索结果,并非必须这么做)。
  4. 部署一些包含您的结构化数据的网页,然后使用网址检查工具测试 Google 看到的网页样貌。请确保您的网页可供 Google 访问,不会因 robots.txt 文件、noindex 标记或登录要求而被屏蔽。如果网页看起来没有问题,您可以请求 Google 重新抓取您的网址
  5. 为了让 Google 随时了解日后发生的更改,我们建议您提交站点地图Search Console Sitemap API 可以帮助您自动执行此操作。

Ejemplos

El siguiente ejemplo de marcado incluye las definiciones de tipo QAPage, Question y Answer en 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>
Microdatos

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

Lineamientos

A fin de que tu página de preguntas y respuestas sea apta para este tratamiento enriquecido, debes seguir estos lineamientos:

Lineamientos de contenido

  • Usa el lenguaje de marcado de QAPage únicamente si tu página incluye datos en formato de preguntas seguidas de sus respuestas.
  • Los usuarios deben poder enviar respuestas para la pregunta. No uses QAPage en contenido que solo tenga una respuesta para una determinada pregunta sin ninguna opción que permita a los usuarios agregar respuestas alternativas; en su lugar, usa FAQPage. Estos son algunos ejemplos:

    Casos de uso válidos:

    • Una página de foro en la que los usuarios pueden enviar respuestas para una sola pregunta
    • Una página de ayuda de un producto en la que los usuarios pueden enviar respuestas para una sola pregunta

    Casos de uso no válidos:

    • Una página de preguntas frecuentes escrita por el sitio sin ninguna opción que permita a los usuarios enviar respuestas alternativas
    • Una página de producto en la que los usuarios pueden enviar varias preguntas y respuestas en una sola página
    • Una guía práctica que responde una pregunta
    • Una entrada de blog que responde una pregunta
    • Un ensayo que responde una pregunta
  • No implementes el lenguaje de marcado de QAPage en todas las páginas de un sitio o foro si no es apto todo el contenido. Por ejemplo, un foro puede tener muchas preguntas publicadas, que son aptas de manera individual para el lenguaje de marcado. Sin embargo, si el foro también tiene páginas que no contienen preguntas, estas no serán aptas.
  • No uses QAPage para páginas de preguntas frecuentes o aquellas en las que hay varias preguntas por página. El lenguaje de marcado de QAPage es para páginas en las que el punto de interés es una sola pregunta con sus respectivas respuestas.
  • No uses el lenguaje de marcado de QAPage con fines publicitarios.
  • Asegúrate de que cada elemento Question incluya el texto completo de la pregunta y de que cada elemento Answer incluya el texto completo de la respuesta.
  • Utiliza el lenguaje de marcado de Answer únicamente para respuestas a una pregunta, no para comentarios sobre la pregunta ni sobre otras respuestas. En su lugar, usa la propiedad comment y el tipo Comment para este tipo de contenido.
  • Puede suceder que el contenido de las preguntas y respuestas no se muestre como resultado enriquecido si incluye alguno de los siguientes tipos de contenido: obscenidades, vulgaridades, material sexual explícito, material gráfico violento, promoción de actividades peligrosas o ilegales, o bien lenguaje intimidatorio o que incita al odio.
  • Es posible que las páginas de preguntas y respuestas relacionadas con la educación en ciencia, tecnología, ingeniería y matemáticas (STEM), cuyo enfoque principal es brindar una respuesta correcta a una pregunta de tarea enviada por el usuario, sean aptas para una experiencia de carrusel de preguntas y respuestas. También pueden tener una sola respuesta seleccionada o provista por un experto interno (en lugar de un usuario).
    Por ejemplo: Una página de educación en la que un usuario envió una sola pregunta y los expertos seleccionan la respuesta principal.

Definiciones de tipos de datos estructurados

En esta sección se describen los tipos de datos estructurados relacionados con QAPage.

Debes incluir las propiedades obligatorias a fin de que tu contenido sea apto para aparecer como resultado enriquecido. También puedes incluir las propiedades recomendadas para agregar más información a tus datos estructurados. Esto podría brindar una mejor experiencia al usuario.

Puedes usar la Prueba de resultados enriquecidos de Google para validar tus datos estructurados y obtener una vista previa de ellos.

QAPage

El tipo QAPage indica que la página está enfocada en una pregunta específica y sus respuestas. Solo utilizaremos datos estructurados de Question de páginas con lenguaje de marcado de QAPage. Solo debe haber una definición de tipo QAPage por página.

La definición completa de QAPage está disponible en https://schema.org/QAPage.

En la siguiente tabla, se describen las propiedades del tipo QAPage que se usan en la Búsqueda de Google.

Propiedades obligatorias

mainEntity

Question

El valor Question de esta página debería estar anidado en la propiedad mainEntity del elemento QAPage.

Question

El tipo Question define la pregunta que responde esta página y también incluye las respuestas a esa pregunta, si las hubiera. Se espera que haya un solo tipo Question en la página, anidado en la propiedad mainEntity de schema.org/QAPage. Solo debe haber una definición de tipo Question por página.

La definición completa de Question está disponible en https://schema.org/Question. Las propiedades compatibles con Google son las siguientes:

Propiedades obligatorias

answerCount

Integer

Es la cantidad total de respuestas a la pregunta. Por ejemplo, si hay 15 respuestas, aunque solo las primeras 10 incluyan lenguaje de marcado debido a la paginación, este valor será 15. Asimismo, podría ser 0 para las preguntas sin respuestas.

Ya sea acceptedAnswer o suggestedAnswer Answer

A fin de ser apta para el resultado enriquecido, una pregunta debe tener al menos una respuesta, ya sea acceptedAnswer o suggestedAnswer. Sin embargo, es posible que las preguntas no tengan respuestas la primera vez que se publiquen. En ese caso, establece la propiedad answerCount en 0. Las preguntas sin respuestas no son aptas para el resultado enriquecido.

acceptedAnswer

Answer

Es la respuesta principal de la pregunta. Puede no haber ninguna, o bien una o más por pregunta. Debe representar las respuestas aceptadas de alguna manera en tu sitio. Por ejemplo, aceptada como respuesta principal por parte de quien hace la pregunta o de un moderador, o por medio de un sistema de votación. Se debe evitar el uso de otras formas de ordenar respuestas, como "más recientes", para identificar respuestas principales.

suggestedAnswer

Answer

Es una respuesta posible, pero no la aceptada como principal (acceptedAnswer). Puede no haber ninguna, o bien una o más por pregunta.

name

Text

Es el texto completo de la pregunta abreviada. Por ejemplo, "¿A cuántas cucharadas equivale una taza?".

Propiedades recomendadas

author

Person o Organization

Información sobre el autor de la pregunta. Para ayudar a Google a comprender mejor a los autores en varias funciones, sugerimos seguir las prácticas recomendadas de lenguaje de marcado de autor.

Incluye todas las propiedades que sean relevantes para el autor con las propiedades compatibles de los datos estructurados de artículo y página de perfil como guía.

comment

Comment

Un comentario relacionado con la pregunta, si está presente. Idealmente, este contenido no es una respuesta, sino que suele ser una aclaración o un debate sobre la pregunta.

dateModified

DateTime

Indica la fecha y hora en que se editó la respuesta, si corresponde, en formato ISO 8601.

datePublished

DateTime

Corresponde a la fecha y hora en que se publicó la pregunta en formato ISO 8601.

image

ImageObject o URL

Cualquier imagen intercalada en la pregunta, si corresponde.

text

Text

Es el texto completo de la pregunta. Por ejemplo, "Estoy cocinando y necesito saber a cuántas cucharadas equivale una taza. ¿A cuántas cucharadas equivale 1 taza?".

upvoteCount

Integer

Es la cantidad total de votos que recibió esta pregunta. Si la página admite votos a favor y en contra, define el valor de upvoteCount como un solo valor agregado que represente tanto los positivos como los negativos. Por ejemplo, si hay 5 votos a favor y 2 en contra, el valor agregado que se debe usar para upvoteCount es 3. Si hay 5 a favor y no se admiten votos en contra, entonces el valor de upvoteCount es 5.

video

VideoObject

Todos los videos intercalados en la pregunta, si corresponde.

Answer

El tipo Answer define las respuestas sugeridas y aceptadas para el Question de esta página. Define Answers dentro de Question como valores de las propiedades suggestedAnswer y acceptedAnswer.

En la siguiente tabla, se describen las propiedades del tipo Answer que se utiliza en un objeto Question.

La definición completa de Answer está disponible en https://schema.org/Answer.

Propiedades obligatorias

text

Text

Es el texto completo de la respuesta. Si solo una parte incluye lenguaje de marcado, es posible que no se muestre tu contenido y que Google no pueda determinar cuál es el mejor texto para mostrar.

Propiedades recomendadas

author

Person o Organization

Información sobre el autor de la respuesta. Para ayudar a Google a comprender mejor a los autores en varias funciones, sugerimos seguir las prácticas recomendadas de lenguaje de marcado de autor.

Incluye todas las propiedades que sean relevantes para el autor con las propiedades compatibles de los datos estructurados de artículo y página de perfil como guía.

comment

Comment

Un comentario relacionado con la respuesta, generalmente una aclaración o un debate sobre la respuesta, si corresponde.

dateModified

DateTime

Corresponde a la fecha y hora en que se editó la respuesta en formato ISO 8601, si corresponde.

datePublished

DateTime

La fecha y hora en que se respondió la pregunta en formato ISO 8601.

image

ImageObject o URL

Cualquier imagen intercalada en la pregunta, si corresponde.

upvoteCount

Integer

Es la cantidad total de votos que recibió esta respuesta, si corresponde. Si la página admite votos a favor y en contra, define el valor de upvoteCount como un solo valor agregado que represente tanto los positivos como los negativos. Por ejemplo, si hay 5 votos a favor y 2 en contra, el valor agregado que se debe usar para upvoteCount es 3. Si hay 5 a favor y no se admiten votos en contra, entonces el valor de upvoteCount es 5.

url

URL

Es una URL que vincula directamente a esta respuesta. Por ejemplo: https://www.examplesite.com/question#answer1

video

VideoObject o URL

Todos los videos intercalados en la respuesta, si corresponde.

Comment

De manera opcional, se puede usar el tipo Comment para describir aclaraciones o discusiones sobre la pregunta o la respuesta que no son pregunta ni respuesta. Define Comments dentro de Question o Answer, como valores para la propiedad comment.

La definición completa de Comment está disponible en https://schema.org/Comment.

Propiedades obligatorias

text

Text

El texto completo del comentario. Si solo se incluye lenguaje de marcado en una parte, es posible que Google no pueda determinar el mejor texto para mostrar.

Propiedades recomendadas

author

Person o Organization

Información sobre el autor del comentario. Para ayudar a Google a comprender mejor a los autores en varias funciones, sugerimos seguir las prácticas recomendadas de lenguaje de marcado de autor.

Incluye todas las propiedades que sean relevantes para el autor con las propiedades compatibles de los datos estructurados de artículo y página de perfil como guía.

comment

Comment

Corresponde a un comentario anidado que responde al comentario (si corresponde).

dateModified

DateTime

Indica la fecha y hora en que se editó el comentario en formato ISO 8601, si corresponde.

datePublished

DateTime

Corresponde a la fecha y hora en que se escribió el comentario en formato ISO 8601.

image

ImageObject o URL

Cualquier imagen intercalada en el comentario, si corresponde.

video

VideoObject o URL

Todos los videos intercalados en el comentario, si corresponde.

Cómo supervisar resultados enriquecidos con Search Console

Search Console es una herramienta que te ayuda a supervisar el rendimiento de tus páginas en la Búsqueda de Google. Si bien no es necesario que te registres en Search Console para que se incluya tu contenido en los resultados de la Búsqueda de Google, puede ayudarte a comprender y mejorar la forma en que Google ve tu sitio. Te recomendamos que revises Search Console en los siguientes casos:

  1. Después de implementar datos estructurados por primera vez
  2. Después de lanzar plantillas nuevas o actualizar código
  3. Para analizar tráfico periódicamente

Después de implementar datos estructurados por primera vez

Después de que Google haya indexado tus páginas, busca problemas con el informe de estado de resultados enriquecidos relevante. Lo ideal es que haya un aumento de los elementos válidos y no de los elementos no válidos. Si encuentras problemas en los datos estructurados, haz lo siguiente:

  1. Corrige los elementos no válidos.
  2. Inspecciona una URL publicada para verificar si persiste el problema.
  3. Solicita una validación desde el informe de estado.

Después de lanzar plantillas nuevas o actualizar código

Cuando realices cambios significativos en tu sitio web, supervisa los aumentos en los elementos no válidos de datos estructurados.
  • Si notas un aumento en la cantidad de elementos no válidos, tal vez se deba a que implementaste una plantilla que no funciona o a que tu sitio interactúa con la plantilla actual de una forma diferente e incorrecta.
  • Si notas una disminución de los elementos válidos (que no coincide con un aumento en la cantidad de elementos no válidos), es posible que ya no estés incorporando datos estructurados en tus páginas. Usa la Herramienta de inspección de URLs para saber cuál es la causa del problema.

Cómo analizar el tráfico periódicamente

Analiza el tráfico de la Búsqueda de Google con el Informe de rendimiento. Los datos te mostrarán con qué frecuencia tu página aparece como resultado enriquecido en la Búsqueda, con qué frecuencia los usuarios hacen clic en ella y cuál es la posición promedio en la que apareces en los resultados de la búsqueda. También puedes extraer esos resultados automáticamente con la API de Search Console.

Solución de problemas

Si tienes problemas para implementar o depurar datos estructurados, te brindamos algunos recursos que podrían resultarte útiles.