Datos estructurados de preguntas (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. En el contenido que representa una pregunta y sus respuestas, puedes etiquetar tus datos con los tipos de schema.org QAPage, Question y Answer.

Las páginas etiquetadas correctamente pueden mostrar un resultado enriquecido en la página de resultados de búsqueda. De este modo, tu sitio web puede llegar más fácilmente a los usuarios adecuados de la Búsqueda. Por ejemplo, es posible que veas un resultado enriquecido para la consulta de usuario "¿Cómo quito un cable atascado en un puerto USB?" si la página se ha marcado con respuestas a esa pregunta.

Además de habilitar tu contenido para que pueda aparecer como resultado enriquecido, etiquetar tu página de preguntas ayuda a Google a generar un mejor fragmento de tu página. El contenido de las respuestas puede mostrarse en el resultado básico si no aparece el resultado enriquecido.

Cómo añadir datos estructurados

Los datos estructurados son un formato estandarizado con el que se puede proporcionar información sobre una página y clasificar su contenido. Consulta cómo funcionan los datos estructurados si aún no te has familiarizado con ellos.

A continuación se explica a grandes rasgos cómo crear, probar y publicar datos estructurados.

  1. Añade las propiedades obligatorias. Consulta más información sobre dónde insertar datos estructurados en una página en función del formato que estés utilizando.
  2. Sigue las directrices.
  3. Valida tu código con la prueba de resultados enriquecidos y corrige los errores críticos. Te recomendamos que también corrijas 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. Crea varias páginas que incluyan tus datos estructurados y comprueba cómo las ve Google con la herramienta de inspección de URLs. Asegúrate de que Google pueda acceder a tu página y de que no esté bloqueada por un archivo robots.txt, por la etiqueta noindex ni por requisitos de inicio de sesión. Si la página se ve bien, puedes solicitar que Google vuelva a rastrear tus URLs.
  5. Para que Google siempre tenga la versión actualizada de tus páginas, te recomendamos que envíes un sitemap. Puedes automatizar este envío con la API Sitemap de Search Console.

Ejemplos

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

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

Directrices

Para que tu página de preguntas sea apta para este tratamiento enriquecido, debes seguir las siguientes directrices:

Directrices de contenido

  • Usa la etiqueta QAPage solo si tu página tiene información en formato de preguntas seguidas de sus respuestas.
  • Los usuarios deben poder enviar respuestas a esa pregunta. No utilices la etiqueta QAPage para contenido que solo tenga una respuesta para una pregunta concreta sin que los usuarios puedan añadir respuestas alternativas; es mejor que uses FAQPage. A continuación, se muestran algunos ejemplos:

    Casos prácticos que son válidos:

    • Páginas de foros donde los usuarios pueden enviar varias respuestas a una misma pregunta
    • Páginas de asistencia de un producto donde los usuarios pueden enviar varias respuestas a una misma pregunta

    Casos prácticos que no son válidos:

    • Páginas de preguntas frecuentes creadas por el sitio web donde los usuarios no pueden enviar más respuestas
    • Páginas de productos donde los usuarios pueden enviar varias preguntas y respuestas en una sola página
    • Una guía práctica que da respuesta a una pregunta
    • Una entrada de blog que da respuesta a una pregunta
    • Un ensayo que da respuesta a una pregunta
  • No apliques la etiqueta QAPage a todas las páginas de un sitio o foro si no todo el contenido es apto. Por ejemplo, un foro puede tener muchas preguntas publicadas, y en cada una de ellas se podría incluir la etiqueta. Sin embargo, si también tiene páginas que no son preguntas, no podría incluirse en ellas.
  • No utilices la etiqueta QAPage para páginas de preguntas frecuentes o donde haya varias preguntas por página. La etiqueta QAPage es para páginas centradas en una sola pregunta y en sus respuestas.
  • No utilices la etiqueta QAPage con fines publicitarios.
  • Comprueba que en cada elemento Question se incluye el texto completo de la pregunta y que en cada elemento Answer se incluye el texto completo de la respuesta.
  • La etiqueta Answer se usa con las respuestas a la pregunta, no con comentarios sobre la pregunta o sobre otras respuestas. Usa la propiedad comment y el tipo Comment para este tipo de contenido.
  • El contenido de preguntas y respuestas no se puede mostrar como un resultado enriquecido si incluye alguno de estos tipos de contenido: obsceno, soez, sexualmente explícito, gráficamente violento, que promocione actividades peligrosas o ilegales, o lenguaje de odio o acoso.
  • Las páginas de preguntas en las que el objetivo es proporcionar una respuesta correcta a preguntas educativas enviadas por usuarios, pueden ser aptas para un carrusel de preguntas. Es habitual que en estas páginas solo haya una respuesta válida proporcionada o seleccionada por un experto interno, en vez de por los usuarios.
    Ejemplo: Una página educativa donde un usuario ha enviado una pregunta y los expertos han seleccionado la mejor respuesta.

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 para que tu contenido pueda mostrarse como un resultado enriquecido. Si quieres, puedes especificar también las propiedades recomendadas para proporcionar más información sobre tus datos estructurados, lo que quizá ofrezca una mejor experiencia de usuario.

Puedes validar y previsualizar tus datos estructurados con la prueba de resultados enriquecidos de Google.

QAPage

El tipo QAPage indica que la página está centrada en una pregunta específica y en sus respuestas. Solo usaremos datos estructurados de Question de páginas que tengan la etiqueta QAPage. Solo debe haber una definición del tipo QAPage por página.

Puedes consultar la definición completa de QAPage en https://schema.org/QAPage.

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

Propiedades obligatorias

mainEntity

Question

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

Question

En el tipo Question se define la pregunta a la que se responde en esa página e incluye las respuestas, si las hay, a esa pregunta. Se espera exactamente un tipo Question en la página, anidado en la propiedad mainEntity de schema.org/QAPage. Solo debe haber una definición del tipo Question por página.

Puedes consultar la definición completa de Question en https://schema.org/Question. Las propiedades que admite Google son las siguientes:

Propiedades obligatorias

answerCount

Integer

Indica el número total de respuestas a la pregunta. Por ejemplo, si hay 15 respuestas, pero solo las primeras 10 están marcadas debido a la paginación, este valor sería 15. También puede ser 0 para preguntas sin respuestas.

Puede ser acceptedAnswer o suggestedAnswer Answer

Para ser apta para el resultado enriquecido, una pregunta debe tener al menos una respuesta, ya sea una acceptedAnswer o una suggestedAnswer. Sin embargo, las preguntas pueden no tener respuestas cuando se acaban de publicar. Si son preguntas sin respuesta, pon 0 en la propiedad answerCount. Las preguntas sin respuesta no pueden incluirse en resultados enriquecidos.

acceptedAnswer

Answer

Indica una respuesta principal a la pregunta. Por cada pregunta, puede haber varias o ninguna. Debe representar respuestas que se aceptan de alguna manera en tu sitio. Por ejemplo, respuestas aceptadas como respuesta principal por quien plantea la pregunta, por un moderador o por un sistema de votación. No se deben usar otras formas de ordenar respuestas, como en función de su antigüedad, para identificar respuestas principales.

suggestedAnswer

Answer

Indica una respuesta posible, pero no aceptada como respuesta principal (acceptedAnswer). Por cada pregunta, puede haber varias o ninguna.

name

Text

Indica el texto completo de la forma corta de una pregunta. Por ejemplo: "¿A cuántas cucharaditas corresponde una taza?".

Propiedades recomendadas

author

Person o Organization

Información sobre el autor de la pregunta. Para ayudar a Google a identificar mejor a los autores en distintas funciones, te recomendamos que sigas las prácticas recomendadas para etiquetar autores.

Incluye todas las propiedades que sean relevantes para el autor con las propiedades admitidas de los datos estructurados de artículos y páginas de perfil.

author.url

URL

Indica el enlace a una página web que identifica de forma exclusiva al autor de la pregunta, probablemente una página de perfil del sitio web de preguntas. Te recomendamos que marques esa página con datos estructurados de página de perfil.

comment

Comment

Un comentario relacionado con la pregunta, si está presente. Lo ideal es que el contenido no sea una respuesta, sino una aclaración o un debate sobre la pregunta.

dateModified

DateTime

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

datePublished

DateTime

Indica la fecha y la hora de publicación de la pregunta en formato ISO 8601.

image

ImageObject o URL

Cualquier imagen insertada en la pregunta, si procede.

text

Text

Indica el texto completo de la forma larga de una pregunta. Por ejemplo: "Estoy cocinando y necesito saber a cuántas cucharaditas corresponde una taza. ¿A cuántas cucharaditas corresponde una taza?"

upvoteCount

Integer

Indica el número total de votos que ha recibido esta pregunta. Si la página admite votos a favor y en contra, fija el valor de upvoteCount como único valor agregado que represente tanto los votos positivos como los negativos. Por ejemplo, si hay 5 votos a favor y 2 en contra, el valor total de upvoteCount será 3. Si hay 5 votos a favor y no se admiten votos en contra, el valor de upvoteCount será 5.

video

VideoObject

Cualquier vídeo insertado en la pregunta, si procede.

Answer

En el tipo Answer se definen las respuestas sugeridas y aceptadas al objeto Question de esta página. En Question, pon Answers como valores de las propiedades suggestedAnswer y acceptedAnswer.

En la siguiente tabla se describen las propiedades del tipo Answer que se utilizan en una Question.

Puedes consultar la definición completa de Answer en https://schema.org/Answer.

Propiedades obligatorias

text

Text

Indica el texto completo de la respuesta. Si solo se marca una parte, 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 identificar mejor a los autores en distintas funciones, te recomendamos que sigas las prácticas recomendadas para etiquetar autores.

Incluye todas las propiedades que sean relevantes para el autor con las propiedades admitidas de los datos estructurados de artículos y páginas de perfil.

author.url

URL

Indica el enlace a una página web que identifica de forma exclusiva al autor de la respuesta. Suele ser una página de perfil del sitio web de preguntas. Te recomendamos que marques esa página con datos estructurados de página de perfil.

comment

Comment

Un comentario relativo a la respuesta, que suele ser una aclaración o un debate sobre la respuesta, si corresponde.

dateModified

DateTime

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

datePublished

DateTime

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

image

ImageObject o URL

Cualquier imagen insertada en la pregunta, si procede.

upvoteCount

Integer

Número total de votos que ha recibido esta respuesta, si corresponde. Si la página admite votos a favor y en contra, fija el valor de upvoteCount como único valor agregado que represente tanto los votos positivos como los negativos. Por ejemplo, si hay 5 votos a favor y 2 en contra, el valor total de upvoteCount será 3. Si hay 5 votos a favor y no se admiten votos en contra, el valor de upvoteCount será 5.

url

URL

Indica una URL que enlaza directamente con esta respuesta. Por ejemplo: https://www.examplesite.com/question#answer1

video

VideoObject o URL

Cualquier vídeo insertado en la respuesta, si procede.

Comment

El tipo Comment se puede usar de forma opcional para describir aclaraciones o debates sobre la pregunta o la respuesta que no sean ni preguntas ni respuestas. Define Comments dentro de Question o Answer como valores de la propiedad comment.

Puedes consultar la definición completa de Comment en https://schema.org/Comment.

Propiedades obligatorias

text

Text

Especifica el texto completo del comentario. Si solo se etiqueta una parte, es posible que Google no pueda determinar cuál es el mejor texto que mostrar.

Propiedades recomendadas

author

Person o Organization

Información sobre el autor del comentario. Para ayudar a Google a identificar mejor a los autores en distintas funciones, te recomendamos que sigas las prácticas recomendadas para etiquetar autores.

Incluye todas las propiedades que sean relevantes para el autor con las propiedades admitidas de los datos estructurados de artículos y páginas de perfil.

author.url

URL

Indica el enlace a una página web que identifica de forma exclusiva al autor del comentario, probablemente una página de perfil del sitio web de preguntas. Te recomendamos que marques esa página con datos estructurados de página de perfil.

comment

Comment

Un comentario anidado en una conversación que responde al comentario, si procede.

dateModified

DateTime

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

datePublished

DateTime

Indica la fecha y la hora en las que se escribió el comentario en formato ISO 8601.

image

ImageObject o URL

Cualquier imagen insertada en el comentario, si procede.

video

VideoObject o URL

Cualquier vídeo insertado en el comentario, si procede.

Monitorizar resultados enriquecidos con Search Console

Search Console es una herramienta que te ayuda a monitorizar el rendimiento de tus páginas en la Búsqueda de Google. No hace falta que te registres en Search Console para que tu sitio web aparezca en los resultados de la Búsqueda de Google, pero, si lo haces, sabrás cómo lo ve Google y qué puedes hacer para mejorarlo. Te recomendamos que consultes Search Console en los siguientes casos:

  1. Después de implementar datos estructurados por primera vez
  2. Después de publicar plantillas nuevas o modificar el código
  3. Al hacer el análisis periódico del tráfico

Después de implementar datos estructurados por primera vez

Una vez que Google haya indexado tus páginas, puedes comprobar si hay algún problema en el informe de estado de resultados enriquecidos correspondiente. Lo ideal es que haya un aumento en el número de elementos válidos y que no lo haya en el número de elementos no válidos. Si detectas problemas en tus datos estructurados, haz lo siguiente:

  1. Corrige los elementos no válidos.
  2. Inspecciona la URL en tiempo real para ver si el problema continúa.
  3. Solicita que se valide la corrección desde el informe de estado.

Después de publicar plantillas nuevas o modificar el código

Cuando hagas cambios significativos en tu sitio web, observa si se incrementa la cantidad de elementos no válidos de datos estructurados.
  • Si notas que hay más elementos no válidos, quizá sea porque has implementado una plantilla que no funciona, o puede que tu sitio esté interactuando con la plantilla que utilizas de un modo diferente que no es adecuado.
  • Si notas que hay menos elementos válidos, pero no hay un incremento de elementos no válidos, es posible que hayas dejado de insertar datos estructurados en tus páginas. Para saber cuál es la causa del problema, utiliza la herramienta de inspección de URLs.

Al hacer el análisis periódico del tráfico

Consulta el informe de rendimiento para analizar el tráfico de tus páginas en la Búsqueda de Google. En él, verás con qué frecuencia aparece tu página como resultado enriquecido en la Búsqueda, cada cuánto hacen clic en ella los usuarios y cuál es la posición media que ocupa tu sitio web en los resultados de búsqueda. También puedes obtener automáticamente estos resultados con la API de Search Console.

Solucionar problemas

Si tienes problemas para implementar o depurar datos estructurados, a continuación se incluyen algunos recursos que pueden serte útiles.