Datos estructurados de ejercicios para practicar (Quiz)

Para que alumnos, profesores y padres pueden encontrar tu material educativo online más fácilmente, puedes marcar con datos estructurados los ejercicios para practicar. En esta guía se explica cómo puedes implementar este esquema de marcado en tus páginas web. Si marcas con datos estructurados los ejercicios para practicar que tienes en tu sitio, estos pueden aparecer en secciones especiales de los resultados de la Búsqueda de Google.

Resultado enriquecido de ejercicios para practicar en la Búsqueda de Google

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.

Disponibilidad de la función

La función de ejercicios para practicar está disponible en inglés en todas las regiones en las que se puede usar la Búsqueda de Google. En esta función, solo pueden aparecer preguntas con varias opciones sobre temas matemáticos o científicos. La función está disponible en ordenadores y dispositivos móviles.

Ejemplos

Cuestionario con una sola pregunta

En el ejemplo que aparece a continuación, puedes ver un cuestionario que solo tiene asociada una pregunta. 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 una sola pregunta y varias respuestas válidas

En el ejemplo que aparece a continuación, puedes ver un cuestionario que solo tiene asociada una pregunta. 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

En el ejemplo que aparece a continuación, puedes ver un cuestionario que tiene varias 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>

Directrices

Para que tu contenido pueda aparecer en la función de ejercicios para practicar de Google, debes seguir estas directrices:

Directrices técnicas

  • Incluye datos estructurados en la página más específica que contenga la información más detallada. No añadas datos estructurados a páginas que no incluyan ningún ejercicio para practicar.
  • Añade una propiedad Quiz a cada ejercicio para practicar que quieras que destaque en los resultados de búsqueda. Los datos estructurados deben estar en la misma página que el ejercicio con el que pueden interactuar los usuarios.
  • Tu página web debe incluir todas las propiedades obligatorias de datos estructurados.
  • Tienes que marcar un mínimo de dos ejercicios por tema (por ejemplo, dos ejercicios sobre el concepto "ecuaciones de segundo grado"). Céntrate en marcar los conceptos y los ejercicios que quieras que aparezcan como resultado enriquecido de ejercicios para practicar. Pueden estar en páginas distintas.
  • Los usuarios tienen que poder acceder a los ejercicios para practicar que hay en tu sitio; es decir, no pueden estar solo en un archivo de datos o PDF.
  • Asegúrate de que la configuración de carga de tu host permita rastreos frecuentes.
  • Si tienes varias copias del mismo ejercicio alojadas en diferentes URLs de tu sitio, utiliza URLs canónicas en cada copia de la página.
  • En los ejercicios para practicar que solo contienen texto:
    • La pregunta puede tener hasta 320 caracteres.
    • Cada respuesta puede tener un máximo de 70 caracteres.
  • En los ejercicios para practicar que incluyen texto y una imagen:
    • La pregunta puede tener hasta 160 caracteres.
    • La imagen puede tener un máximo de 200 píxeles.
  • Accesibilidad: no se permite marcar ejercicios para practicar que solo sean accesibles después de iniciar sesión o estén detrás de un muro de pago. Cuando los usuarios hagan clic en la función en Google para ir hasta tu sitio, tienen que poder acceder al ejercicio en cuestión. Puedes tener otro contenido al que solo se pueda acceder después de iniciar sesión o pagar.
  • Información engañosa: no se permite marcar ejercicios para practicar que pretendan engañar o confundir a los usuarios. Por ejemplo, no se deben marcar temas que no estén asociados a la pregunta.

Directrices de contenido

Hemos creado estas directrices de contenido sobre ejercicios para practicar porque queremos que nuestros usuarios tengan acceso a recursos educativos interesantes. Si detectamos contenido que infringe estas políticas, tomaremos las medidas pertinentes. Por ejemplo, podemos aplicar acciones manuales o impedir que tus páginas aparezcan en la función de ejercicios para practicar de Google.

Palabras malsonantes y lenguaje vulgar

No se permite marcar ejercicios para practicar que contengan lenguaje obsceno, soez u ofensivo.

Anuncios que se hacen pasar por ejercicios para practicar

No se permite marcar contenido promocional que se haga pasar por un ejercicio para practicar, como contenido que haya publicado un tercero (por ejemplo, programas de afiliados).

Si Google recibe una reclamación de que el contenido de un ejercicio puede infringir la ley, el contenido se tratará de acuerdo con las políticas de la Búsqueda.

Calidad

  • Eres responsable de que los ejercicios para practicar que muestras mediante esta función sean de calidad y presenten información precisa. Si durante nuestros procesos de revisión de calidad detectamos que parte de tus datos no son precisos, en función de la gravedad podremos retirar algunos o todos tus ejercicios para practicar hasta que resuelvas los problemas. En particular, valoramos lo siguiente:
    • Si el concepto marcado está lo suficientemente relacionado con la pregunta que se hace
    • Si las preguntas, las posibles respuestas, las pistas y la explicación de las respuestas son precisas y tienen el formato adecuado
    • Si las respuestas siguen un orden correcto (por ejemplo, consideramos que es incorrecto que la primera opción sea "Ninguna de las anteriores")
    • Si las imágenes o las fórmulas son de calidad y tienen relación con la pregunta
    • Si los símbolos matemáticos se renderizan correctamente y si se han implementado correctamente los delimitadores necesarios

Marcar estándares educativos

Los estándares educativos representan los conocimientos y las habilidades que deberían tener los alumnos en cada curso. Tienen varios usos; por ejemplo, sirven para enlazar contenido o elaborar planes de estudio. Si marcas los estándares asociados a tu material educativo online, Google puede organizar y mostrar tu información de la manera más útil posible a los usuarios que busquen contenido educativo en Google según esos estándares. Puedes incluir esta información en los campos educationalAlignment y hasPart.educationalAlignment. Más abajo puedes consultar una descripción general del esquema.

Estos son algunos estándares:

  • Common Core State Standards
  • Texas Essential Knowledge and Skills (TEKS)
  • Virginia Standards of Learning (SOL)
  • BC Performance Standards
  • Alberta Programs of Studies
  • The Australian Curriculum (ACARA)
  • The Victorian Curriculum (F-10)
  • UK National Curriculum

Definiciones de tipos de datos estructurados

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 añadir más información a tus datos estructurados, lo que quizá mejore la experiencia de los usuarios.

Quiz

Un elemento Quiz representa un grupo de uno o varios ejercicios para practicar, que suelen tratar sobre el mismo concepto o tema.

Encontrarás la definición completa de Quiz en schema.org.

Propiedades obligatorias
about Thing

Indica información anidada sobre el concepto del que trata Quiz. Si en una pregunta hay una propiedad hasPart.about, no hace falta incluir esta.

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

Indica información anidada sobre el concepto del que trata Quiz. Si en una pregunta hay una propiedad hasPart.about.name, no hace falta incluir esta. Se pueden añadir varias entradas de esta propiedad.

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

Indica información anidada sobre un determinado ejercicio para practicar del cuestionario. Usa una propiedad hasPart para representar un solo ejercicio para practicar.

Si quieres incluir varios ejercicios para practicar en un único cuestionario, añade esta propiedad varias veces.

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

Indica la respuesta correcta a la pregunta. Si una pregunta tiene varias respuestas correctas, añade esta propiedad varias veces.

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

Indica el tipo de ejercicio para practicar. Esta propiedad es fundamental para que la Búsqueda de Google renderice correctamente las respuestas y compruebe cuáles son correctas y cuáles no. En todas las preguntas, Google muestra un mínimo de dos respuestas y un máximo de seis.

Utiliza uno de los valores admitidos:

  • Multiple choice: solo hay una respuesta correcta. Las respuestas aparecen como botones de selección. Los usuarios solo pueden seleccionar una.
  • Checkbox: hay varias respuestas correctas. Las respuestas se muestran como casillas. Los usuarios pueden marcar todas las que correspondan.
{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "eduQuestionType": "Multiple choice"
  }
}
hasPart.learningResourceType Text

Indica el tipo de este recurso de aprendizaje. Utiliza el valor fijo: Practice problem.

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

Indica el resto de las respuestas correctas o incorrectas a la pregunta. Para especificar varias respuestas, repite esta propiedad junto con sus propiedades anidadas.

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "suggestedAnswer": {
      "@type": "Answer",
    }
  }
}
hasPart.suggestedAnswer.text Text

Indica el contenido de la respuesta. Puedes usar Markdown o HTML. Consulta cómo codificar ejercicios para practicar en HTML o Markdown.

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

Indica el contenido de la pregunta. Puedes usar Markdown o HTML. Consulta cómo codificar ejercicios para practicar en HTML o Markdown.

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

Indica a qué marco educativo consolidado se adhiere el cuestionario. Esta propiedad se puede repetir para asociar el cuestionario a un campo de estudio o dominio determinados, y al curso o estándar educativo al que pertenece. Puedes indicar esta información directamente en el elemento Quiz, o puedes especificarla en el elemento Question.

{
  "@type": "Quiz",
  "educationalAlignment": []
}
educationalAlignment.alignmentType Text

Indica el tipo de asociación entre el recurso educativo y el nodo del marco educativo del cuestionario. La Búsqueda de Google utiliza el estándar LRMI.

Si quieres indicar tanto el campo de estudio como el curso o el estándar educativo al que pertenece, repite la propiedad alignmentType.

  • Para especificar el campo de estudio o el dominio del cuestionario, da a alignmentType el valor educationalSubject.
  • Para indicar el curso o el estándar educativo del cuestionario, da a educationalLevel el valor alignmentType.

Si hay otros dominios o subdominios, puedes insertar varios objetos. Para especificar conceptos, usa la propiedad about.

A continuación puedes ver 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 estándares como Common Core, utiliza 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

Indica el marco educativo del cuestionario. Por ejemplo, "Common Core". Para saber por qué es importante incluir esta propiedad, consulta el apartado Marcar estándares educativos. Se pueden añadir varias entradas de esta propiedad.

educationalAlignment.targetName Text

Indica el nombre de un nodo de un marco educativo consolidado. Por ejemplo, "2.º de ESO: Expresiones y ecuaciones".

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

Indica la URL del marco educativo en cuestión. Por ejemplo, la URL del estándar Common Core sobre las matemáticas de 2.º de ESO.

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

Indica el nivel de dificultad del cuestionario. Estos son algunos valores que se pueden utilizar:

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

Indica información anidada sobre el concepto del que trata la pregunta. Si no se ha incluido la propiedad about en el elemento Quiz, es obligatorio añadir hasPart.about. Se pueden añadir varias entradas de esta propiedad.

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

Indica el título del concepto subyacente del que trata la pregunta. Si no se ha incluido la propiedad about.name en el elemento Quiz, es obligatorio añadir hasPart.about.name.

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

Indica la explicación completa sobre cómo conseguir el resultado que se muestra en esta respuesta. Normalmente, esta propiedad solo se usa en las respuestas correctas. Añade la propiedad hasPart.suggestedAnswer.comment.text dentro de esta para incluir el contenido de la explicación.

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "acceptedAnswer": {
      "@type": "Answer",
      "answerExplanation": {
        "@type": "Comment"
       }
    }
  }
}
hasPart.acceptedAnswer.answerExplanation.text Text

Indica el contenido de la explicación de la respuesta sugerida. Para cambiar el formato del contenido (HTML o Markdown), utiliza encodingFormat. Consulta cómo codificar ejercicios para practicar 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

Proporciona una pista o recomendación sobre la respuesta que puede ayudar a los usuarios a saber por qué es correcta. Incluye la propiedad hasPart.acceptedAnswer.comment.text en ella para añadir el contenido de la pista.

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "acceptedAnswer": {
      "@type": "Answer",
      "comment": {
        "@type": "Comment"
      }
    }
  }
}
hasPart.acceptedAnswer.comment.text Text

Indica el contenido de la pista o recomendación de la respuesta sugerida. Para cambiar el formato del contenido (HTML o Markdown), utiliza encodingFormat. Consulta cómo codificar ejercicios para practicar 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

Indica la posición de esta respuesta cuando se muestra a los usuarios.

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

Indica los conocimientos necesarios para resolver el problema. Si utilizas esta propiedad, puede que aumente la descubribilidad de tu contenido.

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

Indica una pista o recomendación sobre la pregunta que puede servir para responderla. Añade la propiedad hasPart.comment.text dentro de esta para incluir el contenido de la pista.

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "comment": {
      "@type": "Comment"
    }
  }
}
hasPart.comment.text Text

Indica el contenido de la pista o recomendación de la pregunta. Para cambiar el formato del contenido (HTML o Markdown), utiliza encodingFormat. Consulta cómo codificar ejercicios para practicar en HTML o Markdown.


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

Indica a qué marco educativo consolidado se adhiere el cuestionario. Si se ha indicado algún marco educativo en el objeto Quiz, esta propiedad lo sobrescribe.

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "educationalAlignment": []
}
hasPart.educationalAlignment.alignmentType Text

Indica el tipo de asociación entre el recurso educativo y el nodo del marco educativo de la pregunta. La Búsqueda de Google utiliza el estándar LRMI.

Si quieres indicar tanto el campo de estudio como el curso o el estándar educativo al que pertenece, repite la propiedad alignmentType.

  • Para especificar el campo de estudio o el dominio de la pregunta, da a alignmentType el valor educationalSubject.
  • Para indicar el curso o el estándar educativo de la pregunta, da a educationalLevel el valor alignmentType.

Si hay otros dominios o subdominios, puedes insertar varios objetos. Para especificar conceptos, usa la propiedad hasPart.about.

A continuación puedes ver 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 estándares como Common Core, utiliza 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

Indica el marco educativo de la pregunta. Por ejemplo, "Common Core". Para saber por qué es importante incluir esta propiedad, consulta el apartado Marcar estándares educativos. Se pueden añadir varias entradas de esta propiedad.

hasPart.educationalAlignment.targetName Text

Indica el nombre de un nodo de un marco educativo consolidado. Por ejemplo, "2.º de ESO: Expresiones y ecuaciones".

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

Indica la URL del marco educativo específico de la pregunta. Por ejemplo, la URL de un estándar sobre las matemáticas de 2.º de ESO.

hasPart.educationalLevel Text

Indica textualmente el nivel de dificultad de la pregunta. Estos son algunos valores que se pueden utilizar:

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

Proporciona una descripción general de la pregunta. No incluyas la pregunta completa; mejor usa hasPart.text.

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

Proporciona una pista o recomendación sobre la respuesta que puede ayudar a los usuarios a saber por qué es correcta o incorrecta. Incluye la propiedad hasPart.suggestedAnswer.comment.text en ella para añadir el contenido de la pista.

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "suggestedAnswer": {
      "@type": "Answer",
      "comment": {
        "@type": "Comment"
      }
    }
  }
}
hasPart.suggestedAnswer.comment.text Text

Indica el contenido de la pista o recomendación de la respuesta sugerida. Para cambiar el formato del contenido (HTML o Markdown), utiliza encodingFormat. Consulta cómo codificar ejercicios para practicar 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

Indica el formato MIME con el que se ha codificado la propiedad de texto. Si no se incluye la propiedad encodingFormat, de forma predeterminada se usa text/html. Se debe utilizar uno de los valores indicados a continuación:

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

Consulta cómo codificar ejercicios para practicar en HTML o Markdown.

hasPart.suggestedAnswer.position Integer

Indica la posición en la que aparecerá esta respuesta cuando se muestre a los usuarios.

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

Indica el intervalo de edad habitual al que está destinada la pregunta. Por ejemplo, 7-12 o 18-.

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

Indica el título del cuestionario.

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

Es el intervalo de edad habitual al que está destinado el cuestionario. Por ejemplo, 7-12 o 18-.

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

Codificar ejercicios para practicar en HTML o Markdown

La Búsqueda de Google admite los formatos Markdown (tipo CommonMark) y HTML al codificar Question, Answer y Comment. Solo permitimos utilizar los siguientes elementos:

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

Se ignoran tanto el código CSS como el código JavaScript. Google no mostrará preguntas que contengan etiquetas HTML no admitidas.

Cómo indicar el formato usado

Para indicar el formato de codificación que utilizas, incluye la propiedad encodingFormat y dale el valor "text/html" (HTML) o "text/markdown" (Markdown).

A continuación, se muestra un ejemplo de una pregunta configurada con 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 incluye la propiedad encodingFormat, de forma predeterminada se usa "text/html".

Fórmulas

Para mostrar fórmulas, utiliza LaTeX. Tienes que usar dos símbolos del dólar ($$) para insertar fórmulas. Por ejemplo:

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

Solucionar problemas

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