Données structurées de problème pratique (Quiz)

Pour aider les élèves, les enseignants et les parents à trouver plus facilement vos supports de formation et d'apprentissage en ligne, vous pouvez baliser les problèmes pratiques avec des données structurées. Ce guide vous explique comment procéder sur votre page Web. L'ajout de données structurées permet à vos problèmes pratiques d'apparaître dans une interface utilisateur spéciale au sein des résultats de recherche Google.

Résultat enrichi représentant des problèmes pratiques dans la recherche Google

Comment ajouter des données structurées

Ces données structurées représentent un format normalisé permettant de fournir des informations sur une page et de classer son contenu. En savoir plus sur le fonctionnement des données structurées

Voici, dans les grandes lignes, comment créer, tester et publier des données structurées. Pour consulter un guide détaillé sur l'ajout de données structurées à une page Web, accédez à cet atelier de programmation.

  1. Ajoutez les propriétés obligatoires. En fonction du format que vous utilisez, découvrez où insérer des données structurées sur la page.
  2. Suivez les consignes.
  3. Validez votre code à l'aide de l'outil de test des résultats enrichis et corrigez les erreurs critiques, le cas échéant. Envisagez également de résoudre les problèmes non critiques que l'outil a pu signaler, car cela peut contribuer à améliorer la qualité de vos données structurées. Toutefois, ce n'est pas nécessaire pour pouvoir bénéficier des résultats enrichis.
  4. Déployez quelques pages où figurent vos données structurées et utilisez l'outil d'inspection d'URL pour découvrir comment Google voit la page. Assurez-vous que Google peut accéder à votre page et qu'elle n'est pas bloquée par un fichier robots.txt, la balise noindex ni par des identifiants de connexion. Si tout semble être en ordre, vous pouvez demander à Google d'explorer de nouveau vos URL.
  5. Pour informer Google des modifications futures de vos pages, nous vous recommandons de nous envoyer un sitemap. Vous pouvez automatiser cette opération à l'aide de l'API Sitemap de la Search Console.

Disponibilité de cette fonctionnalité

L'affichage des problèmes pratiques sous forme de résultats enrichis est disponible en anglais dans toutes les régions dans lesquelles la recherche Google est disponible. Cette fonctionnalité n'est proposée que pour les sujets mathématiques et scientifiques, pour les questionnaires à choix multiples ou à réponse unique, sur ordinateur et sur mobile.

Exemples

Questionnaire à une seule question

Voici un exemple de questionnaire qui ne contient qu'une seule question. Seule une réponse est correcte.

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

Questionnaire avec une seule question et plusieurs réponses à cocher

Voici un exemple de questionnaire qui ne contient qu'une seule question. Plusieurs réponses sont correctes.

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

Questionnaire à plusieurs questions

Voici un exemple de questionnaire comportant plusieurs paires de questions/réponses.

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

Consignes

Pour que les problèmes pratiques proposés par votre site puissent s'afficher en tant que résultats enrichis dans la recherche Google, vous devez respecter les consignes suivantes.

Consignes techniques

  • Placez les données structurées sur la page contenant les informations les plus détaillées. N'ajoutez pas de données structurées aux pages qui ne proposent aucun problème pratique.
  • Ajoutez une propriété Quiz pour chaque problème pratique que vous souhaitez présenter. Les données structurées doivent apparaître sur la même page que le problème pratique avec lequel l'internaute peut interagir sur votre page Web.
  • Votre page Web doit inclure toutes les propriétés de données structurées obligatoires.
  • Vous devez baliser au moins deux problèmes pratiques par concept (par exemple, deux exercices liés au concept "équation quadratique"). Concentrez-vous sur le balisage des concepts et des problèmes pratiques que vous souhaitez voir apparaître sous forme de résultats enrichis. Ils peuvent se trouver sur des pages distinctes.
  • Les exercices proposés sur votre site doivent être accessibles aux utilisateurs. Autrement dit, ils ne doivent pas uniquement se trouver dans un fichier de données ou dans un fichier PDF.
  • Assurez-vous que les paramètres de chargement de votre hôte autorisent les explorations fréquentes.
  • Si plusieurs versions du même problème pratique sont hébergées sur votre site sous différentes URL, utilisez des URL canoniques sur chaque version de la page.
  • Règles à respecter concernant les problèmes pratiques 100 % textuels :
    • La question ne doit pas comporter plus de 320 caractères.
    • Chaque réponse du questionnaire à choix multiples ne doit pas comporter plus de 70 caractères.
  • Règles concernant les problèmes pratiques composés de texte et d'une image :
    • La question ne doit pas comporter plus de 160 caractères.
    • La hauteur maximale de l'image doit être de 200 pixels.
  • Accessibilité : nous n'autorisons pas les problèmes pratiques dont l'accès est soumis à un paywall ou nécessite des identifiants de connexion. Lorsque les utilisateurs accèdent à votre site via la fonctionnalité Google, le contenu de l'exercice doit être disponible sans restriction. Vous pouvez toutefois proposer tout contenu supplémentaire via un paywall ou des identifiants de connexion.
  • Déclarations trompeuses : nous n'autorisons pas les problèmes pratiques visant à tromper les utilisateurs ou à les induire en erreur. Cela inclut le balisage inapproprié des sujets qui n'ont aucun lien avec la question.

Consignes relatives au contenu

Nous avons créé des consignes spécifiques au contenu des problèmes pratiques afin de nous assurer que nos utilisateurs sont exposés à des ressources d'apprentissage pertinentes. Si nous constatons que du contenu enfreint ces règles, nous prendrons les mesures appropriées, par exemple en soumettant une action manuelle et en empêchant l'affichage des pages concernées sous forme de résultats enrichis sur Google.

Grossièretés et langage vulgaire

Nous n'autorisons pas les problèmes pratiques contenant des propos obscènes, grossiers ou choquants.

Annonces déguisées en problèmes pratiques

Nous n'autorisons pas les contenus promotionnels déguisés en problèmes pratiques, tels que ceux publiés par un tiers (programmes d'affiliation, par exemple).

Si nous recevons une réclamation selon laquelle le contenu d'un problème pratique est susceptible d'enfreindre la loi, le contenu concerné sera traité conformément aux Règles de la recherche Google.

Qualité

  • Vous êtes responsable de l'exactitude et de la qualité des problèmes pratiques proposés via cette fonctionnalité. S'il ressort de nos contrôles qualité que certaines de vos données sont inexactes, une partie ou la totalité de vos exercices peut cesser d'apparaître sous forme de résultats enrichis tant que vous n'aurez pas résolu les problèmes en fonction de leur gravité. Assurez-vous donc que les éléments suivants sont exacts :
    • Balisage du concept en fonction de la question posée
    • Mise en forme et précision de la question, des réponses possibles, des indices éventuels et de l'explication fournie
    • Ordre des réponses correct (par exemple, la mention "Aucune des réponses ci-dessus" ne doit pas apparaître comme première option)
    • Qualité et précision de l'image ou de la formule par rapport à la question
    • Implémentation du rendu des symboles mathématiques et des délimiteurs

Baliser les normes pédagogiques

Les normes pédagogiques sont les objectifs d'apprentissage que les élèves doivent atteindre à chaque niveau. Leur utilité est multiple. Elles permettent notamment de renvoyer les étudiants vers le contenu approprié, tout comme elles peuvent s'intégrer dans un parcours de formation. Le balisage des normes (disponible dans les champs educationalAlignment et hasPart.educationalAlignment) associées aux supports d'apprentissage en ligne permet à Google d'organiser et de présenter les d'informations les plus utiles aux internautes qui recherchent des contenus pédagogiques conformes à ces normes. Voici une vue d'ensemble du schéma :

Voici quelques exemples de normes :

  • Common Core State Standards
  • TEKS (Texas Essential Knowledge and Skills)
  • Virginia Standards of Learning (SOL)
  • BC Performance Standards
  • Alberta Programs of Studies
  • ACARA (cursus australien)
  • F-10 (cursus victorien)
  • Cursus national du Royaume-Uni

Définitions des types de données structurées

Vous devez inclure les propriétés obligatoires pour que votre contenu puisse être affiché sous forme de résultat enrichi. Vous pouvez également inclure les propriétés recommandées pour ajouter d'autres informations à vos données structurées et ainsi offrir une meilleure expérience utilisateur.

Quiz

Une propriété Quiz désigne un groupe de problèmes pratiques qui concernent généralement le même concept ou le même sujet.

La définition complète de la propriété Quiz est disponible sur schema.org.

Propriétés obligatoires
about Thing

Informations imbriquées concernant le concept sous-jacent de la propriété Quiz. Cette propriété n'est pas obligatoire si la question comporte une propriété hasPart.about.

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

Informations imbriquées concernant le concept sous-jacent de la propriété Quiz. Cette propriété n'est pas obligatoire si la question comporte une propriété hasPart.about.name. Vous pouvez ajouter cette propriété plusieurs fois.

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

Informations imbriquées concernant le problème pratique spécifique dont fait l'objet le questionnaire. Utilisez une propriété hasPart pour représenter un problème pratique unique.

Pour inclure plusieurs problèmes pratiques au niveau d'un même questionnaire, utilisez cette propriété plusieurs fois.

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

Réponse correcte à la question. S'il existe plusieurs réponses correctes pour une seule question, utilisez cette propriété plusieurs fois.

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

Type de problème pratique. Cette information est essentielle pour que la recherche Google affiche et vérifie les réponses correctes et incorrectes. Pour chaque question, Google affiche au minimum deux réponses et au maximum six réponses.

Utilisez l'une des valeurs acceptées :

  • Multiple choice : une seule réponse est correcte. Les choix sont affichés sous la forme d'une liste de cases d'option permettant à l'utilisateur de ne sélectionner qu'une réponse.
  • Checkbox : plusieurs réponses sont correctes. Les options s'affichent sous la forme d'une liste de cases que l'utilisateur peut cocher à son gré pour indiquer toutes les réponses applicables.
{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "eduQuestionType": "Multiple choice"
  }
}
hasPart.learningResourceType Text

Type de cette ressource pédagogique. Utilisez cette valeur fixe : Practice problem.

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

Toutes les autres réponses correctes ou incorrectes à la question. Pour spécifier plusieurs réponses, répétez cette propriété, ainsi que ses propriétés imbriquées.

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

Contenu de la réponse. Vous pouvez utiliser le format Markdown ou HTML. Découvrez comment encoder les problèmes pratiques au format HTML ou Markdown.

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

Contenu de la question. Vous pouvez utiliser le format Markdown ou HTML. Découvrez comment encoder les problèmes pratiques au format HTML ou Markdown.

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "text": "Which diagram represents the product $$3 *\frac{2}{3}$$?"
  }
}
Propriétés recommandées
educationalAlignment AlignmentObject

Adéquation du questionnaire par rapport à un programme pédagogique établi. Cette propriété peut être utilisée plusieurs fois pour associer le questionnaire à un domaine ou à un champ d'études, ainsi qu'à un niveau scolaire ou à une norme pédagogique. Vous pouvez ajouter des équivalents pédagogiques directement au niveau de la propriété Quiz ou plus spécifiquement dans Question.

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

Catégorie d'équivalence entre la ressource pédagogique et le chapitre du programme correspondant au questionnaire. La recherche Google utilise la norme LRMI.

Utilisez la propriété alignmentType plusieurs fois pour indiquer le champ d'études, ainsi que le niveau scolaire ou la norme pédagogique.

  • Pour spécifier le domaine ou le champ d'études du questionnaire, définissez alignmentType sur educationalSubject.
  • Pour indiquer le niveau scolaire ou la norme pédagogique associé au questionnaire, définissez alignmentType sur educationalLevel.

S'il existe d'autres domaines et sous-domaines, vous pouvez ajouter plusieurs objets. Pour identifier des concepts, utilisez plutôt la propriété about.

Voici comment spécifier educationalSubject et educationalLevel.

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

Pour faire référence à des normes, telles que la norme américaine "Common Core", utilisez les propriétés educationalAlignment.educationalFramework et 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

Programme auquel le questionnaire est associé ("Common Core", par exemple). Pour en savoir plus sur l'utilité de cette propriété, consultez la section Balisage des normes pédagogiques. Vous pouvez ajouter cette propriété plusieurs fois.

educationalAlignment.targetName Text

Nom d'un chapitre d'un programme pédagogique établi. Exemple : "4e : Expressions et équations".

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

URL du programme pédagogique spécifique (par exemple, l'URL de la norme américaine "Common Core" pour les élèves de quatrième).

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

Niveau de difficulté du questionnaire. Voici quelques exemples de valeurs que vous pouvez utiliser :

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

Informations imbriquées concernant le concept sous-jacent de la question. Si la propriété about n'est pas spécifiée pour l'élément Quiz, hasPart.about est obligatoire. Vous pouvez ajouter cette propriété plusieurs fois.

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

Titre du concept sous-jacent de la question. Si la propriété about.name n'est pas spécifiée pour l'élément Quiz, hasPart.about.name est obligatoire.

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

Explication complète des étapes à suivre pour obtenir le résultat représenté dans cette réponse. Cette propriété n'est généralement utilisée que pour les réponses correctes. Utilisez la propriété hasPart.suggestedAnswer.comment.text au sein de cet élément pour le contenu de l'explication.

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

Contenu de l'explication pour la réponse suggérée. Pour modifier le format du contenu (HTML ou Markdown), utilisez encodingFormat. Découvrez comment encoder les problèmes pratiques au format HTML ou 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

Suggestion ou indice permettant de clarifier pourquoi la réponse est correcte. Utilisez la propriété hasPart.acceptedAnswer.comment.text au sein de cet élément pour le contenu de l'indice.

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

Contenu de l'indice ou de la suggestion pour la réponse concernée. Pour modifier le format du contenu (HTML ou Markdown), utilisez encodingFormat. Découvrez comment encoder les problèmes pratiques au format HTML ou Markdown.


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

Position de cette réponse lorsqu'elle est présentée à l'utilisateur.

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

Compétences requises pour résoudre le problème. La spécification de cette valeur contribue à améliorer la visibilité de votre page.

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

Indice ou suggestion visant à aider l'utilisateur à trouver la réponse à la question. Utilisez la propriété hasPart.comment.text au sein de cet élément pour le contenu de l'indice.

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

Contenu de l'indice ou de la suggestion correspondant à la question. Pour modifier le format du contenu (HTML ou Markdown), utilisez encodingFormat. Découvrez comment encoder les problèmes pratiques au format HTML ou Markdown.


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

Adéquation de la question par rapport à un programme pédagogique établi. Cette propriété remplace les équivalences pédagogiques qui ont été ajoutées au niveau de l'objet Quiz.

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

Catégorie d'équivalence entre la ressource pédagogique et le chapitre du programme correspondant à la question. La recherche Google utilise la norme LRMI.

Utilisez la propriété alignmentType plusieurs fois pour indiquer le champ d'études, ainsi que le niveau scolaire ou la norme pédagogique.

  • Pour spécifier le domaine ou le champ d'études de la question, définissez alignmentType sur educationalSubject.
  • Pour indiquer le niveau scolaire ou la norme pédagogique associé à la question, définissez alignmentType sur educationalLevel.

S'il existe d'autres domaines et sous-domaines, vous pouvez ajouter plusieurs objets. Pour identifier des concepts, utilisez plutôt la propriété hasPart.about.

Voici comment spécifier educationalSubject et educationalLevel.

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

Pour faire référence à des normes, telles que la norme américaine "Common Core", utilisez les propriétés hasPart.educationalAlignment.educationalFramework et 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

Programme auquel la question est associée ("Common Core", par exemple). Pour en savoir plus sur l'utilité de cette propriété, consultez la section Balisage des normes pédagogiques. Vous pouvez ajouter cette propriété plusieurs fois.

hasPart.educationalAlignment.targetName Text

Nom d'un chapitre d'un programme pédagogique établi. Exemple : "4e : Expressions et équations".

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

URL du programme pédagogique spécifique qui s'applique à la question (par exemple, l'URL de la norme américaine "Common Core" pour les élèves de quatrième).

hasPart.educationalLevel Text

Niveau de difficulté de la question, au format texte. Voici quelques exemples de valeurs que vous pouvez utiliser :

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

Brève description de la question. N'incluez pas le contenu complet de la question. Utilisez hasPart.text à la place.

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

Suggestion ou indice permettant de clarifier pourquoi la réponse est correcte ou fausse. Utilisez la propriété hasPart.suggestedAnswer.comment.text au sein de cet élément pour le contenu de l'indice.

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

Contenu de l'indice ou de la suggestion pour la réponse concernée. Pour modifier le format du contenu (HTML ou Markdown), utilisez encodingFormat. Découvrez comment encoder les problèmes pratiques au format HTML ou Markdown.


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

Format MIME utilisé pour encoder la propriété de texte. Si aucun élément encodingFormat n'est spécifié, la valeur par défaut est text/html. Utilisez l'une des valeurs suivantes :

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

Découvrez comment encoder les problèmes pratiques au format HTML ou Markdown.

hasPart.suggestedAnswer.position Integer

Position de cette réponse lorsqu'elle est présentée à l'utilisateur.

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

Tranches d'âge habituelles auxquelles la question est destinée (par exemple, 7-12 ou 18-).

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

Titre du questionnaire.

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

Tranches d'âge habituelles auxquelles le questionnaire est destiné (par exemple, 7-12 ou 18-).

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

Encodage des problèmes pratiques au format HTML ou Markdown

La recherche Google accepte le format Markdown (CommonMark) et HTML lors de l'encodage Question, Answer et Comment. Nous limitons l'ensemble des composants aux éléments suivants :

  • En-têtes
  • Sauts de ligne
  • Listes (triées et non triées)
  • Paragraphes
  • Gras
  • Italique
  • Images
  • Formules en LaTex

CSS ou JavaScript sont ignorés. Google n'affichera pas les questions contenant des balises HTML non compatibles.

Comment spécifier le format

Pour spécifier le format d'encodage que vous utilisez, choisissez la propriété encodingFormat et définissez la valeur "text/html" pour HTML ou "text/markdown" pour Markdown.

Voici un exemple de question définie au format 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 aucun élément encodingFormat n'est spécifié, la valeur "text/html" est déduite.

Formules

Pour spécifier une formule, utilisez le format LaTex. Vous devez utiliser le signe du dollar deux fois de suite ($$) pour intégrer des formules. Exemple :

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

Dépannage

Si vous ne parvenez pas à mettre en œuvre ou à déboguer des données structurées, voici quelques ressources susceptibles de vous aider.