Datos estructurados de problemas prácticos (Quiz)

Para ayudar a que alumnos, profesores y padres encuentren tu material educativo y de aprendizaje en línea más fácilmente, puedes usar datos estructurados para marcar los problemas de práctica. En esta guía, se explica cómo implementar este esquema en tu página web. Agregar datos estructurados hace que tus problemas de práctica sean aptos para aparecer en una experiencia del usuario especial en los resultados de la Búsqueda de Google.

Resultado enriquecido de problemas prácticos en la Búsqueda de Google

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.

Disponibilidad de funciones

La función de problema de práctica está disponible en inglés en todas las regiones donde se brinda la Búsqueda de Google. Esta función solo está disponible para temas de matemáticas y ciencias, para tipos de preguntas de opción múltiple y de casilla de verificación, y tanto en computadoras de escritorio como en dispositivos móviles.

Ejemplos

Cuestionario con una sola pregunta

A continuación, te mostramos un ejemplo de un cuestionario que solo tiene una pregunta asociada. Solo hay una respuesta correcta. 

<html>
  <head>
    <title>Quiz about fractions</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org/",
      "@type": "Quiz",
      "name": "Quiz about fractions",
      "hasPart": {
        "@type": "Question",
        "typicalAgeRange": "7-12",
        "educationalAlignment": [
          {
            "@type": "AlignmentObject",
            "alignmentType": "educationalSubject",
            "targetName": "Mathematics"
          },
          {
            "@type": "AlignmentObject",
            "alignmentType": "educationalSubject",
            "targetName": "Algebra"
          },
          {
            "@type": "AlignmentObject",
            "alignmentType": "educationalLevel",
            "targetName": "Grade 5 » Number and Operations—Fractions » Apply and extend previous understandings of multiplication and division. » 3",
            "educationalFramework": "Common Core",
            "targetUrl": "https://www.corestandards.org/Math/Content/5/NF/B/3/"
          }
        ],
        "about": {
          "@type": "Thing",
          "name": "Fractions"
        },
        "educationalLevel": "intermediate",
        "eduQuestionType": "Multiple choice",
        "learningResourceType": "Practice problem",
        "assesses": "Multiplying fractions by whole numbers",
        "name": "Choose the model",
        "comment": {
          "@type": "Comment",
          "text": "This is a hint about the question."
        },
        "encodingFormat": "text/markdown",
        "text": "Which model represents the product $$2 * \\frac{2}{3}$$?",
        "suggestedAnswer": [
          {
            "@type": "Answer",
            "position": 0,
            "encodingFormat": "text/html",
            "text": "<img src=\"www.test.com/practice-problems-fractions/…image2.png\" alt=\"Answer 2\" />",
            "comment": {
              "@type": "Comment",
              "text": "This is a hint about the answer."
            }
          }
        ],
        "acceptedAnswer": {
          "@type": "Answer",
          "position": 1,
          "encodingFormat": "text/html",
          "text": "<img src=\"www.test.com/practice-problems-fractions/…image1.png\" alt=\"Answer 1\" />",
          "comment": {
            "@type": "Comment",
            "text": "This is a hint about the answer."
          },
          "answerExplanation": {
            "@type": "Comment",
            "text": "This is a full explanation on how this answer was achieved."
          }
        }
      }
    }
    </script>
  </head>
  <body>
  </body>
</html>

Cuestionario con solo una pregunta y respuestas con casillas de verificación

A continuación, te mostramos un ejemplo de un cuestionario que solo tiene una pregunta asociada. Hay varias respuestas correctas. 

<html>
  <head>
    <title>Quiz about laws of Physics</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org/",
      "@type": "Quiz",
      "name": "Quiz about laws of physics",
      "about": {
        "@type": "Thing",
        "name": "Laws of Physics And Applications"
      },
      "educationalLevel": "intermediate",
      "assesses": "Laws of physics",
      "hasPart": {
        "@type": "Question",
        "eduQuestionType": "Checkbox",
        "learningResourceType": "Practice problem",
        "name": "Laws of Physics And Applications",
        "typicalAgeRange": "12-15",
        "text": "Identify laws of Physics. (Select all valid answers)",
        "suggestedAnswer": [
          {
            "@type": "Answer",
            "position": 0,
            "text": "Nevada's Law",
            "comment": {
              "@type": "Comment",
              "text": "This is a hint"
            }
          },
          {
            "@type": "Answer",
            "position": 2,
            "text": "EUA law",
            "comment": {
              "@type": "Comment",
              "text": "This is a hint"
            }
          }
        ],
        "acceptedAnswer": [
          {
            "@type": "Answer",
            "position": 1,
            "text": "Newton's law",
            "comment": {
              "@type": "Comment",
              "text": "This is a hint"
            },
            "answerExplanation": {
              "@type": "Comment",
              "text": "This is a full explanation on how this answer was achieved."
            }
          },
          {
            "@type": "Answer",
            "position": 3,
            "text": "Ohm's law",
            "comment": {
              "@type": "Comment",
              "text": "This is a hint"
            },
            "answerExplanation": {
              "@type": "Comment",
              "text": "This is a full explanation on how this answer was achieved."
            }
          }
        ]
      }
    }
    </script>
  </head>
  <body>
  </body>
</html>

Cuestionario con varias preguntas

A continuación, te mostramos un ejemplo de un cuestionario que incluye varios pares de preguntas y respuestas. 

<html>
  <head>
    <title>Quiz about displacement, velocity and time</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org/",
      "@type": "Quiz",
      "typicalAgeRange": "7-12",
      "educationalLevel": "intermediate",
      "assesses": "Velocity and speed",
      "educationalAlignment": [
        {
          "@type": "AlignmentObject",
          "alignmentType": "educationalSubject",
          "targetName": "Science"
        },
        {
          "@type": "AlignmentObject",
          "alignmentType": "educationalSubject",
          "targetName": "Physics"
        }
      ],
      "name": "Quiz about displacement, velocity and time",
      "about": {
        "@type": "Thing",
        "name": "Displacement, velocity, and time"
      },
      "hasPart": [
        {
          "@type": "Question",
          "eduQuestionType": "Multiple choice",
          "learningResourceType": "Practice problem",
          "name": "Average velocity and average speed from graphs",
          "text": "A bug crawls on a wall. What is the average velocity of the bug between the times $$t = 1s$$ and $$t = 10s$$?",
          "comment": {
            "@type": "Comment",
            "text": "This is a hint about the question."
          },
          "encodingFormat": "text/markdown",
          "suggestedAnswer": [
            {
              "@type": "Answer",
              "position": 0,
              "encodingFormat": "text/markdown",
              "text": "$$0.5 \\frac{m}{s}$$",
              "comment": {
                "@type": "Comment",
                "text": "This is a hint"
              }
            },
            {
              "@type": "Answer",
              "position": 1,
              "encodingFormat": "text/markdown",
              "text": "$$-0.5 \\frac{m}{s}$$",
              "comment": {
                "@type": "Comment",
                "text": "This is a hint"
              }
            },
            {
              "@type": "Answer",
              "position": 3,
              "encodingFormat": "text/markdown",
              "text": "$$1.5 \\frac{m}{s}$$",
              "comment": {
                "@type": "Comment",
                "text": "This is a hint"
              }
            }
          ],
          "acceptedAnswer": {
            "@type": "Answer",
            "position": 2,
            "encodingFormat": "text/markdown",
            "text": "$$0 \\frac{m}{s}$$",
            "comment": {
              "@type": "Comment",
              "text": "This is a hint"
            }
          }
        },
        {
          "@type": "Question",
          "eduQuestionType": "Multiple choice",
          "learningResourceType": "Practice problem",
          "name": "Average velocity and average speed from graphs",
          "text": "A swimmer motion is shown on the following graph of position x vs. time t. What is the average speed?",
          "encodingFormat": "text/markdown",
          "comment": {
            "@type": "Comment",
            "text": "This is a hint about the question."
          },
          "suggestedAnswer": [
            {
              "@type": "Answer",
              "position": 0,
              "text": "1",
              "encodingFormat": "text/html",
              "comment": {
                "@type": "Comment",
                "text": "This is a hint"
              }
            },
            {
              "@type": "Answer",
              "position": 2,
              "text": "3",
              "encodingFormat": "text/html",
              "comment": {
                "@type": "Comment",
                "text": "This is a hint"
              }
            },
            {
              "@type": "Answer",
              "position": 3,
              "text": "4",
              "encodingFormat": "text/html",
              "comment": {
                "@type": "Comment",
                "text": "This is a hint"
              }
            }
          ],
          "acceptedAnswer": {
            "@type": "Answer",
            "position": 1,
            "text": "2",
            "encodingFormat": "text/html",
            "comment": {
              "@type": "Comment",
              "text": "This is a hint"
            },
            "answerExplanation": {
              "@type": "Comment",
              "text": "This is a full explanation on how this answer was achieved."
            }
          }
        }
      ]
    }
    </script>
  </head>
  <body>
  </body>
</html>

Lineamientos

Si quieres ser apto para aparecer en la experiencia de problemas de práctica de Google, debes seguir estos lineamientos:

Lineamientos técnicos

  • Incluye los datos estructurados en la página secundaria más detallada posible. No agregues datos estructurados a páginas sin problemas de práctica.
  • Agrega una propiedad Quiz por cada problema de práctica que quieras destacar. Los datos estructurados deben aparecer en la misma página que el problema de práctica con el que un usuario puede interactuar en tu página web.
  • Tu página web debe contener todas las propiedades obligatorias de datos estructurados.
  • Debes agregar lenguaje de marcado a dos problemas de práctica por concepto, como mínimo (por ejemplo, dos problemas de práctica para el concepto "ecuaciones cuadráticas"). Enfócate en agregar lenguaje de marcado a los conceptos y problemas que desees que sean aptos para aparecer en el resultado enriquecido de los problemas de práctica. Pueden estar en diferentes páginas.
  • Los usuarios deben poder acceder a los problemas de práctica de tu sitio, es decir, no solo deben estar en un archivo de datos o PDF.
  • Asegúrate de que Googlebot pueda rastrear tu sitio de manera eficiente.
  • Si tienes varias copias del mismo problema de práctica en tu sitio alojadas con distintas URL, usa URL canónicas en cada copia de la página.
  • En el caso de los problemas de práctica de solo texto:
    • La pregunta debe tener 320 caracteres como máximo.
    • Las respuestas de opción múltiple deben tener un máximo de 70 caracteres por respuesta.
  • Para problemas de práctica con texto y una imagen:
    • La pregunta no puede superar los 160 caracteres.
    • La altura máxima de la imagen debe ser de 200 px.
  • Accesibilidad: No permitimos problemas de práctica que estén ocultos tras un acceso o un muro de pago. Una vez que los usuarios naveguen desde la función en Google hasta tu sitio, deben poder acceder al contenido de problemas de práctica. El contenido adicional puede estar detrás de un acceso o un muro de pago.
  • Tergiversación: No permitimos problemas de práctica destinados a engañar o confundir a los usuarios. Esto incluye agregar lenguaje de marcado de forma imprecisa a temas que no están asociados con la pregunta.

Lineamientos de contenido

Creamos estos lineamientos de contenido sobre problemas de práctica para garantizar que nuestros usuarios estén conectados con recursos de aprendizaje relevantes. Si detectamos contenido que infringe estas políticas, actuaremos según corresponda, lo que podría implicar la toma de acciones manuales y quitar las páginas para que no aparezcan en la experiencia de problemas de práctica en Google.

Lenguaje obsceno o inapropiado

No permitimos problemas de práctica que contengan lenguaje obsceno, ofensivo o vulgar.

Anuncios ocultos como problema de práctica

No permitimos contenido promocional que aparente ser problemas de práctica, como los publicados por un tercero (por ejemplo, programas de afiliados).

Si Google recibe un reclamo en el que se indique que el contenido de un problema práctico podría ser contrario a la ley, dicho contenido se tratará según lo establecido en las políticas de Búsqueda.

Calidad

  • Eres responsable de la exactitud y la calidad de los problemas de práctica que se muestran mediante esta función. Si, según nuestros procesos de revisión de calidad, se determina que cierta cantidad de datos no es precisa, es posible que se quiten todos tus problemas o solo un subconjunto de ellos hasta que se resuelvan los errores, según la gravedad. Esto se aplica a la exactitud de lo siguiente:
    • El concepto al que se agregó lenguaje de marcado en relación con la pregunta
    • El formato y la rigurosidad de las preguntas, las opciones de respuesta, las sugerencias y la explicación de las respuestas
    • Orden correcto de las respuestas (por ejemplo, no muestres "Ninguna de las opciones anteriores" como primera opción)
    • Calidad y precisión de la imagen o la fórmula en relación con la pregunta
    • Renderización de símbolos y expresiones matemáticas e implementación de delimitadores

Cómo agregar lenguaje de marcado a estándares educativos

Los estándares de aprendizaje son los objetivos de aprendizaje que los estudiantes deberían conocer y ser capaces de lograr en cada nivel. Los estándares de aprendizaje tienen múltiples usos; por ejemplo, pueden vincular al contenido o constituir un componente de una progresión de aprendizaje. El agregado de lenguaje de marcado a los estándares (que se encuentran en los campos educationalAlignment y hasPart.educationalAlignment) asociados al material de aprendizaje en línea ayuda a Google a organizar y destacar la información de la forma más útil para las personas que pueden buscar contenido de aprendizaje en función de estos estándares. A continuación, presentamos una descripción general del esquema:

Estos son algunos ejemplos de estándares:

  • Estándares estatales académicos fundamentales
  • Conocimientos y destrezas esenciales en Texas (TEKS)
  • Estándares de aprendizaje en Virginia (SOL)
  • Estándares de rendimiento BC
  • Programas de estudio de Alberta
  • Plan de estudios australiano (ACARA)
  • Plan de estudios victoriano (F-10)
  • Plan de estudios nacional del Reino Unido

Definiciones de tipos de datos estructurados

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 mejorar la experiencia del usuario.

Quiz

Un Quiz es una agrupación de problemas de práctica (uno o más), que generalmente se relacionan con el mismo concepto o tema.

Puedes ver la definición completa de Quiz en schema.org.

Propiedades obligatorias
about Thing

Información anidada sobre el concepto subyacente relacionado con Quiz. Si hay una propiedad hasPart.about para la pregunta, esta propiedad no es obligatoria. 

{
  "@type": "Quiz",
  "about": {
    "@type": "Thing"
  }
}
about.name Text

Información anidada sobre el concepto subyacente relacionado con Quiz. Si hay una propiedad hasPart.about.name para la pregunta, esta propiedad no es obligatoria. Se permiten varias entradas de esta propiedad. 

{
  "@type": "Quiz",
  "about": {
    "@type": "Thing",
    "name": "Fractions"
  }
}
hasPart Question

Información anidada sobre el problema de práctica específico del cuestionario. Usa una propiedad hasPart para representar un único problema de práctica.

Si quieres incluir varios problemas de práctica en un mismo cuestionario, repite esta propiedad. 

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question"
  }
}
hasPart.acceptedAnswer Answer

La respuesta correcta de la pregunta Si hay varias respuestas correctas para una sola pregunta, repite esta propiedad. 

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "acceptedAnswer": {
      "@type": "Answer"
    }
  }
}
hasPart.eduQuestionType Text

El tipo de problema de práctica Es fundamental para que la Búsqueda de Google procese y revise las respuestas correctas e incorrectas. Para cada pregunta, Google mostrará un mínimo de dos respuestas y un máximo de seis respuestas.

Usa uno de los valores admitidos:

  • Multiple choice: Solo hay una respuesta correcta. Las opciones se muestran como una colección de botones de selección y el usuario solo puede seleccionar uno.
  • Checkbox: Hay más de una respuesta correcta. Las opciones se muestran como una colección de casillas de verificación, y el usuario puede marcar todas las que correspondan.
{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "eduQuestionType": "Multiple choice"
  }
}
hasPart.learningResourceType Text

El tipo de este recurso de aprendizaje Usa este valor fijo: Practice problem 

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "learningResourceType": "Practice problem"
  }
}
hasPart.suggestedAnswer Answer

Todas las demás respuestas correctas o incorrectas a la pregunta. Para especificar varias respuestas, repite esta propiedad, junto con sus propiedades anidadas.

hasPart.suggestedAnswer.text Text

El contenido de la respuesta Puedes usar Markdown o HTML. Obtén información para codificar problemas de práctica en HTML o Markdown. 

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "suggestedAnswer": {
      "@type": "Answer",
      "text": "$$x = 1$$"
    }
  }
}
hasPart.text Text

El contenido de la pregunta Puedes usar Markdown o HTML. Obtén información para codificar problemas de práctica en HTML o Markdown. 

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "text": "Which diagram represents the product $$3 *\frac{2}{3}$$?"
  }
}
Propiedades recomendadas
educationalAlignment AlignmentObject

La alineación del cuestionario con un marco educativo establecido Esta propiedad se puede repetir para alinear el cuestionario con un campo de estudio o dominio y la calificación objetivo o el estándar educativo. Puedes agregar alineaciones educativas directamente en el elemento Quiz o de forma más específica en Question.

educationalAlignment.alignmentType Text

Una categoría de alineación entre el recurso de aprendizaje y el nodo del marco de trabajo para el cuestionario La Búsqueda de Google usa el estándar LRMI.

Repite el elemento alignmentType para especificar el campo de estudio y el grado objetivo o el estándar educativo.

  • Para especificar el campo de estudio o el dominio del cuestionario, establece alignmentType en educationalSubject.
  • Para especificar la calificación objetivo o el estándar educativo del cuestionario, establece alignmentType en educationalLevel.

Se pueden insertar varios objetos en caso de que existan otros dominios y subdominios. Para especificar conceptos, usa la propiedad about en su lugar.

A continuación, se detalla cómo especificar educationalSubject y educationalLevel. 

{
  "@type": "Quiz",
  "educationalAlignment": [
    {
      "@type": "AlignmentObject",
      "alignmentType": "educationalSubject",
      "targetName": "Mathematics"
    },
    {
      "@type": "AlignmentObject",
      "alignmentType": "educationalLevel",
      "targetName": "Fifth grade"
    }
  ]
}

Para hacer referencia a los estándares, como por ejemplo los "Estándares estatales académicos fundamentales", usa las propiedades educationalAlignment.educationalFramework y educationalAlignment.targetUrl . 

{
  "@type": "Quiz",
  "educationalAlignment: [
  {
    "@type": "AlignmentObject",
    "alignmentType": "educationalLevel",
    "educationalFramework": "Common Core",
    "targetName": "Grade 8: Expressions and Equations",
    "targetUrl": "https://www.corestandards.org/Math/Content/8/EE/A/2/"
    }
  ]
}
educationalAlignment.educationalFramework Text

El marco de trabajo con el que se alinea el cuestionario. Por ejemplo, "Estándares estatales académicos fundamentales" Para obtener más información sobre por qué esta propiedad es importante, consulta Cómo marcar estándares educativos. Se permiten varias entradas de esta propiedad.

educationalAlignment.targetName Text

El nombre de un nodo de un marco de trabajo educativo establecido. Por ejemplo: "8º grado: Expresiones y ecuaciones". 

{
  "@type": "Quiz",
  "educationalAlignment: [
  {
    "@type": "AlignmentObject",
    "targetName": "Grade 8: Expressions and Equations"
    }
  ]
}
educationalAlignment.targetUrl URL

La URL del marco de trabajo educativo específico. Por ejemplo, la URL del estándar básico de matemáticas de 8º grado. 

{
  "@type": "Quiz",
  "educationalAlignment: [
  {
    "@type": "AlignmentObject",
    "targetUrl": "https://www.corestandards.org/Math/Content/8/EE/A/2/"
    }
  ]
}
educationalLevel Text

El nivel de dificultad del cuestionario. Los siguientes son algunos valores de ejemplo que se pueden usar:

  • beginner
  • intermediate
  • advanced
{
  "@type": "Quiz",
  "educationalLevel": "beginner"
}
hasPart.about Thing

Información anidada sobre el concepto subyacente relacionado con la pregunta. Si no se especifica la propiedad about para Quiz, se requiere hasPart.about. Se permiten varias entradas de esta propiedad.

hasPart.about.name Text

Título del concepto subyacente relacionado con la pregunta. Si no se especifica la propiedad about.name para Quiz, se requiere hasPart.about.name. 

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "about": {
      "@type": "Thing",
      "name": "Fractions"
    }
  }
}
hasPart.acceptedAnswer.answerExplanation Comment

Una explicación completa sobre cómo lograr el resultado representado en esta respuesta. Por lo general, se usa solo para respuestas correctas. Usa la propiedad hasPart.suggestedAnswer.comment.text dentro del contenido de la explicación.

hasPart.acceptedAnswer.answerExplanation.text Text

El contenido de la explicación de la respuesta sugerida. Para cambiar el formato del contenido (HTML o Markdown), usa encodingFormat. Obtén información para codificar problemas de práctica en HTML o Markdown. 

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "suggestedAnswer": {
      "@type": "Answer",
      "answerExplanation": {
        "@type": "Comment",
        "text": "*In order to get to this result..*",
        "encodingFormat": "text/markdown"
       }
    }
  }
}
hasPart.acceptedAnswer.comment Comment

Sugerencia o pista sobre la respuesta que se puede usar para comprender por qué es correcta. Usa la propiedad hasPart.acceptedAnswer.comment.text dentro del contenido de la sugerencia.

hasPart.acceptedAnswer.comment.text Text

El contenido de la sugerencia de la respuesta sugerida. Para cambiar el formato del contenido (HTML o Markdown), usa encodingFormat. Obtén información para codificar problemas de práctica en HTML o Markdown. 

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "acceptedAnswer": {
      "@type": "Answer",
      "comment": {
        "@type": "Comment",
        "text": "<p>This is a hint</p>"
      }
    }
  }
}
hasPart.acceptedAnswer.position Integer

La posición de esta respuesta cuando se muestra al usuario. 

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "acceptedAnswer": {
      "@type": "Answer",
      "position": 2
    }
  }
}
hasPart.assesses DefinedTerm o Text

Las habilidades necesarias para resolver el problema. Si completas esto, puedes mejorar la visibilidad. 

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "assesses": "Multiplying fractions by whole numbers"
  }
}
hasPart.comment Comment

Sugerencia o pista sobre la pregunta que se podría usar para resolverla. Usa la propiedad hasPart.comment.text dentro del contenido de la sugerencia.

hasPart.comment.text Text

El contenido de la sugerencia o pista para la pregunta. Para cambiar el formato del contenido (HTML o Markdown), usa encodingFormat. Obtén información para codificar problemas de práctica en HTML o Markdown. 

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "comment": {
      "@type": "Comment",
      "text": "<p>This is a hint</p>"
    }
  }
}
hasPart.educationalAlignment AlignmentObject

La alineación de la pregunta con respecto a un marco educativo establecido. Esta propiedad anula las alineaciones educativas que se agregaron en el objeto Quiz.

hasPart.educationalAlignment.alignmentType Text

Una categoría de alineación entre el recurso de aprendizaje y el nodo del marco para la pregunta. La Búsqueda de Google usa el estándar LRMI.

Repite el elemento alignmentType para especificar el campo de estudio y el grado objetivo o el estándar educativo.

  • Para especificar el campo de estudio o el dominio de la pregunta, establece alignmentType en educationalSubject.
  • Para especificar la calificación objetivo o el estándar educativo de la pregunta, establece alignmentType en educationalLevel.

Se pueden insertar varios objetos en caso de que existan otros dominios y subdominios. Para especificar conceptos, usa la propiedad hasPart.about en su lugar.

A continuación, se detalla cómo especificar educationalSubject y educationalLevel. 

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "educationalAlignment": [
      {
      "@type": "AlignmentObject",
      "alignmentType": "educationalSubject",
      "targetName": "Mathematics"
      },
      {
      "@type": "AlignmentObject",
      "alignmentType": "educationalLevel",
      "targetName": "Fifth grade"
      }
    ]
  }
}

Para hacer referencia a los estándares, como por ejemplo los "Estándares estatales académicos fundamentales", usa las propiedades hasPart.educationalAlignment.educationalFramework y hasPart.educationalAlignment.targetUrl. 

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "educationalAlignment: [
      {
      "@type": "AlignmentObject",
      "alignmentType": "educationalLevel",
      "educationalFramework": "Common Core",
      "targetName": "Grade 8: Expressions and Equations",
      "targetUrl": "https://www.corestandards.org/Math/Content/8/EE/A/2/"
      }
    ]
  }
}
hasPart.educationalAlignment.educationalFramework Text

El marco con el que se alinea la pregunta. Por ejemplo, "Estándares estatales académicos fundamentales" Para obtener más información sobre por qué esta propiedad es importante, consulta Cómo marcar estándares educativos. Se permiten varias entradas de esta propiedad.

hasPart.educationalAlignment.targetName Text

El nombre de un nodo de un marco de trabajo educativo establecido. Por ejemplo: "8º grado: Expresiones y ecuaciones". 

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "educationalAlignment: [
      {
      "@type": "AlignmentObject",
      "alignmentType": "educationalLevel",
      "targetName": "Grade 8: Expressions and Equations"
      }
    ]
  }
}
hasPart.educationalAlignment.targetUrl URL

La URL del marco educativo específico que se aplica a la pregunta Por ejemplo, la URL del estándar común principal de matemática de 8º grado

hasPart.educationalLevel Text

El nivel de dificultad de la pregunta, en forma de texto. Los siguientes son algunos valores de ejemplo que se pueden usar:

  • beginner
  • intermediate
  • advanced
{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "educationalLevel": "beginner"
  }
}
hasPart.name Text

Una descripción general de la pregunta. No incluyas todo el contenido de la pregunta. Usa hasPart.text en su lugar. 

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "name": "Question about fractions"
  }
}
hasPart.suggestedAnswer.comment Comment

Sugerencia o pista sobre la respuesta que se puede usar para comprender por qué es correcta o incorrecta. Usa la propiedad hasPart.suggestedAnswer.comment.text dentro del contenido de la sugerencia.

hasPart.suggestedAnswer.comment.text Text

El contenido de la sugerencia de la respuesta sugerida. Para cambiar el formato del contenido (HTML o Markdown), usa encodingFormat. Obtén información para codificar problemas de práctica en HTML o Markdown. 

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "suggestedAnswer": {
      "@type": "Answer",
      "comment": {
        "@type": "Comment",
        "text": "<p>This is a hint</p>"
      }
    }
  }
}
hasPart.suggestedAnswer.encodingFormat Text

Formato MIME utilizado para codificar la propiedad de texto. Si no se especifica encodingFormat, el valor predeterminado es text/html. Usa uno de los siguientes valores:

  • text/markdown
  • text/html
{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "suggestedAnswer": {
      "@type": "Answer",
      "encodingFormat": "text/html"
    }
  }
}

Obtén información para codificar problemas de práctica en HTML o Markdown.

hasPart.suggestedAnswer.position Integer

Es la posición de esta respuesta cuando se muestra al usuario. 

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "suggestedAnswer": {
      "@type": "Answer",
      "position": "0"
    }
  }
}
hasPart.typicalAgeRange Text

Indica el rango de edades al que se orienta la pregunta. Por ejemplo, 7-12 o 18-. 

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "typicalAgeRange": "7-12"
  }
}
name Text

Corresponde al título del cuestionario. 

{
  "@type": "Quiz",
  "name": "Negative exponents review"
}
typicalAgeRange Text

El rango típico de edades a las que está destinado el cuestionario. Por ejemplo, 7-12 o 18-. 

{
  "@type": "Quiz",
  "typicalAgeRange": "7-12"
}

Codificación de problemas de práctica en HTML o Markdown.

La Búsqueda de Google admite Markdown (tipo CommonMark) y HTML cuando se codifica Question, Answer y Comment. Restringimos el conjunto de construcciones a lo siguiente:

  • Encabezados
  • Saltos de línea
  • Listas (ordenadas y sin ordenar)
  • Párrafos
  • Negrita
  • Cursiva
  • Imágenes
  • Fórmulas en LaTex

Se ignora CSS o JavaScript. Google no mostrará preguntas que contengan etiquetas HTML no admitidas.

Cómo especificar el formato

Para especificar qué formato de codificación estás usando, usa la propiedad encodingFormat y establece el valor en "text/html" para HTML o "text/markdown" para Markdown.

Este es un ejemplo de una pregunta configurada en el formato Markdown: 

{
  "@type": "Question",
  "name": "Average velocity and average speed from graphs",
  "text": "What is the average velocity [..] between the times $$t = 4s$$ and $$t = 10s$$?",
  "encodingFormat": "text/markdown"
  ..
  ..
}

Si no se especifica encodingFormat, se supone que el valor es "text/html".

Fórmulas

Si quieres especificar una fórmula, usa el formato LaTex. Debes usar el signo de dólar doble ($$) to embed formulas. For example: 

"<p>Please solve: $$2x^2 = 18$$</p>"
    



  
Solución de problemas

  

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