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.

Cómo agregar datos estructurados

Los datos estructurados son un formato estandarizado para proporcionar información sobre una página y clasificar su contenido. Si aún no estás familiarizado con los datos estructurados, obtén más información sobre su funcionamiento.

A continuación, presentamos una descripción general para aprender a compilar, probar y actualizar datos estructurados.

  1. Agrega las propiedades obligatorias. Según el formato que uses, obtén información sobre las ubicaciones donde puedes insertar datos estructurados en la página.
  2. Sigue los lineamientos.
  3. Valida tu código con la Prueba de resultados enriquecidos y corrige cualquier error crítico. Procura también corregir los problemas no críticos que puedan marcarse en la herramienta, ya que pueden ayudar a mejorar la calidad de los datos estructurados (sin embargo, esto no es necesario para que se muestren los resultados enriquecidos).
  4. Implementa algunas páginas que incluyan tus datos estructurados y utiliza la Herramienta de inspección de URLs para probar el modo en el que Google ve la página. Asegúrate de que Google pueda acceder a la página y que no esté bloqueada por un archivo robots.txt, una etiqueta noindex ni requisitos de acceso. Si la página se ve bien, puedes pedirle a Google que vuelva a rastrear tus URLs.
  5. Para mantener informado a Google sobre los cambios futuros, te recomendamos que envíes un mapa del sitio. Puedes automatizar este proceso con la API de Search Console Sitemap.

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

author.url

URL

Un vínculo a una página web que identifica de forma única al autor de la pregunta, muy probablemente un perfil del sitio web de preguntas y respuestas. Te recomendamos que agregues lenguaje de marcado a esa página con datos estructurados de páginas de perfil.

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.

author.url

URL

Un vínculo a una página web que identifica de forma exclusiva al autor de la respuesta, que probablemente sea una página de perfil del sitio web de preguntas y respuestas. Te recomendamos que agregues lenguaje de marcado a esa página con datos estructurados de páginas de perfil.

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.

author.url

URL

Un vínculo a una página web que identifica de forma única al autor del comentario, muy probablemente un perfil del sitio web de preguntas y respuestas. Te recomendamos que agregues lenguaje de marcado a esa página con datos estructurados de páginas de perfil.

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.