Datos estructurados de preguntas (QAPage)

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. A continuación se muestra un ejemplo de un resultado que puede aparecer como respuesta a la consulta de usuario "¿Cómo puedo extraer un cable atascado en un puerto USB?" si se ha etiquetado la página para responder esa pregunta:

Un ejemplo de lo que aparece en los resultados de búsqueda con una tarjeta de preguntas y respuestas

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. Si necesitas una guía detallada para añadir datos estructurados a una página web, consulta el codelab de 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:

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>

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. No etiquetes los comentarios sin respuesta como Answer.
  • 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

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.

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

upvoteCount

Integer

Indica el número total de votos que ha recibido esta respuesta. 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

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.