Dati strutturati per esercitazioni (Quiz)

Per aiutare studenti, insegnanti e genitori a trovare più facilmente materiale didattico e di apprendimento online, puoi utilizzare i dati strutturati per eseguire il markup delle esercitazioni. La presente guida spiega come implementare questo schema nella tua pagina web. L'aggiunta dei dati strutturati rende le esercitazioni idonee a essere mostrate in un'esperienza utente speciale nei risultati della Ricerca Google.

Risultato avanzato delle esercitazioni nella Ricerca Google

Come aggiungere dati strutturati

I dati strutturati sono un formato standardizzato per fornire informazioni su una pagina e classificarne i contenuti. Se non li hai mai utilizzati, scopri di più su come funzionano i dati strutturati.

Ecco una panoramica su come creare, testare e rilasciare i dati strutturati. Per una guida passo per passo su come aggiungere dati strutturati a una pagina web, consulta il codelab sui dati strutturati.

  1. Aggiungi le proprietà obbligatorie. In base al formato che utilizzi, scopri dove inserire i dati strutturati nella pagina.
  2. Segui le linee guida.
  3. Convalida il codice utilizzando lo strumento di Test dei risultati avanzati e correggi eventuali errori critici. Prendi in considerazione anche la possibilità di correggere eventuali problemi non critici che potrebbero essere segnalati nello strumento, in quanto possono contribuire a migliorare la qualità dei tuoi dati strutturati (tuttavia, questo non è necessario per l'idoneità per i risultati avanzati).
  4. Implementa alcune pagine che includono dati strutturati e utilizza lo strumento Controllo URL per verificare come Google vede la pagina. Assicurati che la pagina sia accessibile per Google e che non venga bloccata da file robots.txt, tag noindex o requisiti di accesso. Se la pagina non presenta problemi, puoi chiedere a Google di ripetere la scansione degli URL.
  5. Per tenere Google informata delle future modifiche, ti consigliamo di inviare una Sitemap. Puoi automatizzare questa operazione con l'API Search Console Sitemap.

Disponibilità della funzionalità

La funzionalità relativa alle esercitazioni è disponibile in inglese in tutte le aree geografiche in cui è disponibile la Ricerca Google. La funzionalità è disponibile solo per argomenti di matematica e scienza, per tipologie di domande a scelta multipla e con casella di controllo e su computer e dispositivi mobili.

Esempi

Quiz con una sola domanda

Di seguito è riportato un esempio di quiz a cui è associata una sola domanda con un'unica risposta corretta. 

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

Quiz con una sola domanda e risposte con casella di controllo

Di seguito è riportato un esempio di quiz a cui è associata una sola domanda con più risposte corrette. 

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

Quiz con più domande

Di seguito è riportato un esempio di quiz con più coppie di domanda e risposta. 

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

Linee guida

Devi rispettare queste linee guida affinché i tuoi contenuti siano idonei a comparire nell'esperienza utente dedicata alle esercitazioni di Google:

Linee guida tecniche

  • Inserisci i dati strutturati nella pagina foglia più dettagliata possibile. Non aggiungere dati strutturati a pagine senza esercitazioni.
  • Aggiungi una proprietà Quiz per ogni esercitazione che vuoi mettere in primo piano. I dati strutturati devono essere visualizzati nella stessa pagina dell'esercitazione con cui un utente può interagire sulla tua pagina web.
  • La pagina web deve includere tutte le proprietà dei dati strutturati obbligatorie.
  • Devi eseguire il markup di almeno due esercitazioni per argomento (ad esempio, due esercitazioni per il concetto "equazioni di secondo grado"). Concentrati sul markup dei concetti e dei problemi che vuoi siano idonei a comparire nel risultato avanzato delle esercitazioni. Possono trovarsi su pagine separate.
  • Le esercitazioni sul tuo sito devono essere accessibili agli utenti, ovvero non trovarsi solo in un file di dati o in un PDF.
  • Assicurati che Googlebot possa eseguire la scansione del tuo sito in modo efficiente.
  • Se hai più copie della stessa esercitazione pubblicate sul tuo sito con URL distinti, utilizza gli URL canonici in ciascuna copia della pagina.
  • Per le esercitazioni con solo testo:
    • La domanda deve avere una lunghezza massima di 320 caratteri.
    • Le risposte a scelta multipla devono avere una lunghezza massima di 70 caratteri per risposta.
  • Per le esercitazioni con testo e un'immagine:
    • La domanda deve avere una lunghezza massima di 160 caratteri.
    • L'altezza massima dell'immagine deve essere di 200 px.
  • Accessibilità: non sono consentite esercitazioni per cui sia necessario l'accesso o che siano protette da paywall. Quando gli utenti passano dalla funzionalità su Google al tuo sito, devono poter accedere ai contenuti dell'esercitazione. I contenuti aggiuntivi possono essere protetti da credenziali di accesso o paywall.
  • Rappresentazione ingannevole: non sono consentite esercitazioni il cui scopo sia ingannare o raggirare gli utenti, ad esempio non è consentito eseguire un markup non corretto di argomenti che non sono associati alla domanda.

Linee guida relative ai contenuti

Abbiamo creato queste linee guida relative ai contenuti delle esercitazioni per garantire che i nostri utenti possano accedere a risorse di apprendimento pertinenti. Se rileviamo contenuti che violano queste norme, adotteremo le misure adeguate, ad esempio un'azione manuale e la rimozione delle tue pagine dall'esperienza dedicata alle esercitazioni su Google.

Linguaggio volgare e offensivo

Non sono consentite esercitazioni che contengono un linguaggio osceno, volgare o offensivo.

Pubblicità celate dietro un'esercitazione

Non sono consentiti contenuti promozionali celati dietro a esercitazioni, come quelli pubblicati da terze parti (ad esempio, programmi di affiliazione).

Nel caso in cui Google riceva un reclamo relativo a contenuti di un'esercitazione in potenziale violazione della legge, tali contenuti verranno gestiti in conformità con le norme relative alla Ricerca.

Qualità

  • Sei responsabile dell'accuratezza e della qualità delle esercitazioni disponibili tramite questa funzionalità. Se una determinata porzione di dati viene ritenuta non accurata in base alle nostre procedure di verifica della qualità, le esercitazioni potrebbero essere rimosse dalla funzionalità, in tutto o in parte, finché non risolverai i problemi, a seconda della gravità. Viene valutata l'accuratezza di quanto segue:
    • Pertinenza del concetto di cui viene eseguito il markup rispetto alla domanda posta
    • Formattazione e accuratezza della domanda, dell'opzione di risposta, del suggerimento e della spiegazione della risposta
    • Ordine corretto delle risposte (ad esempio, non mettere "Nessuna delle risposte precedenti" come prima opzione)
    • Qualità e accuratezza dell'immagine o della formula in relazione alla domanda
    • Visualizzazione dei simboli matematici e implementazione dei delimitatori

Eseguire il markup degli standard didattici

Gli standard di apprendimento sono gli obiettivi di apprendimento che delineano ciò che gli studenti dovrebbero conoscere e saper fare per ogni livello scolastico. Gli standard di apprendimento hanno molteplici usi, ad esempio rimandare a contenuti o costituire una parte di un percorso didattico. L'applicazione del markup agli standard (nei campi educationalAlignment e hasPart.educationalAlignment) associati ai materiali di apprendimento online consente a Google di organizzare e mostrare le informazioni più utili alle persone che potrebbero cercare contenuti didattici nella Ricerca in base a questi standard. Di seguito una panoramica generale dello schema.

Ecco alcuni esempi di standard:

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

Definizioni dei tipi di dati strutturati

Affinché i tuoi contenuti siano idonei per essere visualizzati come risultato avanzato, devi includere le proprietà obbligatorie. Puoi anche includere le proprietà consigliate per aggiungere ulteriori informazioni ai dati strutturati, fornendo un'esperienza utente migliore.

Quiz

Un Quiz è un raggruppamento di esercitazioni (una o più) che generalmente si riferiscono allo stesso concetto o argomento.

La definizione completa di Quiz è disponibile su schema.org.

Proprietà obbligatorie
about Thing

Informazioni nidificate relative al concetto alla base di Quiz. Se esiste una proprietà hasPart.about per la domanda, questa proprietà non è obbligatoria. 

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

Informazioni nidificate relative al concetto alla base di Quiz. Se esiste una proprietà hasPart.about.name per la domanda, questa proprietà non è obbligatoria. Sono consentite più voci di questa proprietà. 

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

Informazioni nidificate relative all'esercitazione specifica del quiz. Utilizza una proprietà hasPart per rappresentare una singola esercitazione.

Per includere più esercitazioni per un singolo quiz, ripeti questa proprietà. 

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

La risposta corretta alla domanda. Se ci sono più risposte corrette per una singola domanda, ripeti questa proprietà. 

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

Il tipo di esercitazione. Questa proprietà è fondamentale affinché la Ricerca Google possa visualizzare e verificare le risposte corrette e quelle errate. Per ogni domanda, Google mostrerà un minimo di due risposte e un massimo di sei.

Utilizza uno dei valori supportati:

  • Multiple choice: c'è solo una risposta corretta. Le alternative vengono mostrate come una serie di pulsanti di opzione e l'utente può selezionarne solo una.
  • Checkbox: è presente più di una risposta corretta. Le alternative vengono mostrate come una serie di caselle di controllo e l'utente può selezionare tutte le risposte pertinenti.
{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "eduQuestionType": "Multiple choice"
  }
}
hasPart.learningResourceType Text

Il tipo di questa risorsa di apprendimento. Utilizza questo valore fisso: Practice problem. 

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

Tutte le altre risposte corrette o errate per la domanda. Per specificare più risposte, ripeti questa proprietà e le relative proprietà nidificate. 

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

Il contenuto della risposta. Puoi utilizzare Markdown o HTML. Scopri come codificare le esercitazioni in HTML o Markdown. 

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

Il contenuto della domanda. Puoi utilizzare Markdown o HTML. Scopri come codificare le esercitazioni in HTML o Markdown. 

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

L'allineamento del quiz rispetto a un quadro didattico stabilito. Questa proprietà può essere ripetuta per allineare il quiz a un'area di studio o dominio, nonché all'anno scolastico o allo standard didattico di riferimento. Puoi aggiungere allineamenti didattici direttamente alla proprietà Quiz o più specificamente in Question. 

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

Una categoria di allineamento tra la risorsa di apprendimento e il nodo del quadro didattico per il quiz. La Ricerca Google utilizza lo standard LRMI.

Ripeti alignmentType per specificare sia l'area di studio che l'anno scolastico o lo standard didattico di riferimento.

  • Per specificare l'area di studio o il dominio del quiz, imposta alignmentType su educationalSubject.
  • Per specificare l'anno scolastico o lo standard didattico di riferimento del quiz, imposta alignmentType su educationalLevel.

È possibile inserire più oggetti nel caso in cui esistano altri domini e sottodomini. Per specificare dei concetti, utilizza invece la proprietà about.

Ecco come specificare sia educationalSubject che educationalLevel. 

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

Per fare riferimento agli standard, ad esempio "Common Core", utilizza le proprietà educationalAlignment.educationalFramework e 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

Il quadro didattico a cui è allineato il quiz, ad esempio "Common Core". Per scoprire di più sul motivo per cui questa proprietà è importante, consulta la sezione Eseguire il markup degli standard didattici. Sono consentite più voci di questa proprietà.

educationalAlignment.targetName Text

Il nome di un nodo di un quadro didattico stabilito, ad esempio: "Terza media: espressioni ed equazioni". 

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

L'URL del quadro didattico specifico, ad esempio, l'URL per lo standard Common Core relativo alla matematica per la terza media. 

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

Il livello di difficoltà del quiz. Ecco alcuni valori di esempio che possono essere utilizzati:

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

Informazioni nidificate relative al concetto alla base della domanda. Se la proprietà about non è stata specificata per Quiz, hasPart.about è obbligatoria. Sono consentite più voci di questa proprietà. 

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

Il titolo del concetto alla base della domanda. Se la proprietà about.name non è stata specificata per Quiz, hasPart.about.name è obbligatoria. 

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

Una spiegazione completa su come ottenere il risultato descritto in questa risposta. Questa proprietà di solito viene utilizzata solo per le risposte corrette. Utilizza la proprietà hasPart.suggestedAnswer.comment.text all'interno del contenuto della spiegazione. 

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

Il contenuto della spiegazione per la risposta suggerita. Per cambiare il formato dei contenuti (HTML o Markdown), utilizza encodingFormat. Scopri come codificare le esercitazioni in 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

Un suggerimento sulla risposta che potrebbe essere utilizzato per capire perché è corretta. Utilizza la proprietà hasPart.acceptedAnswer.comment.text all'interno per il contenuto del suggerimento. 

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

Il contenuto del suggerimento per la risposta suggerita. Per cambiare il formato dei contenuti (HTML o Markdown), utilizza encodingFormat. Scopri come codificare le esercitazioni in 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 posizione di questa risposta quando viene mostrata all'utente. 

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

Le competenze necessarie per risolvere il problema. Compilare questa proprietà può migliorare la rilevabilità. 

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

Un suggerimento sulla domanda che può essere utilizzato per individuare la risposta. Utilizza la proprietà hasPart.comment.text all'interno per il contenuto del suggerimento. 

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

Il contenuto del suggerimento per la domanda. Per cambiare il formato dei contenuti (HTML o Markdown), utilizza encodingFormat. Scopri come codificare le esercitazioni in HTML o Markdown. 

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

L'allineamento della domanda a un quadro didattico stabilito. Questa proprietà sostituisce gli allineamenti didattici aggiunti nell'oggetto Quiz. 

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

Una categoria di allineamento tra la risorsa di apprendimento e il nodo del quadro didattico per la domanda. La Ricerca Google utilizza lo standard LRMI.

Ripeti alignmentType per specificare sia l'area di studio che l'anno scolastico o lo standard didattico di riferimento.

  • Per specificare l'area di studio o il dominio della domanda, imposta alignmentType su educationalSubject.
  • Per specificare l'anno scolastico o lo standard didattico di riferimento della domanda, imposta alignmentType su educationalLevel.

È possibile inserire più oggetti nel caso in cui esistano altri domini e sottodomini. Per specificare dei concetti, utilizza invece la proprietà hasPart.about.

Ecco come specificare sia educationalSubject che educationalLevel. 

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

Per fare riferimento agli standard, ad esempio "Common Core", utilizza le proprietà hasPart.educationalAlignment.educationalFramework e 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

Il quadro a cui è allineata la domanda, ad esempio "Common Core". Per scoprire di più sul motivo per cui questa proprietà è importante, consulta la sezione Eseguire il markup degli standard didattici. Sono consentite più voci di questa proprietà.

hasPart.educationalAlignment.targetName Text

Il nome di un nodo di un quadro didattico stabilito, ad esempio: "Terza media: espressioni ed equazioni". 

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

L'URL del quadro didattico specifico che si applica alla domanda. ad esempio, l'URL per lo standard Common Core relativamente alla matematica per la terza media.

hasPart.educationalLevel Text

Il livello di difficoltà della domanda, sotto forma di testo. Ecco alcuni valori di esempio che possono essere utilizzati:

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

Una descrizione generale della domanda. Non includere l'intero contenuto della domanda; utilizza invece hasPart.text. 

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

Un suggerimento sulla risposta che potrebbe essere utilizzato per capire perché è corretta o errata. Utilizza la proprietà hasPart.suggestedAnswer.comment.text all'interno per il contenuto del suggerimento. 

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

Il contenuto del suggerimento per la risposta suggerita. Per cambiare il formato dei contenuti (HTML o Markdown), utilizza encodingFormat. Scopri come codificare le esercitazioni in 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

Il formato MIME utilizzato per codificare la proprietà di testo. Se encodingFormat non è specificato, il valore predefinito è text/html. Usa uno dei seguenti valori:

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

Scopri come codificare le esercitazioni in HTML o Markdown.

hasPart.suggestedAnswer.position Integer

La posizione di questa risposta quando viene mostrata all'utente. 

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

La fascia di età tipica a cui è destinata la domanda. Ad esempio: 7-12 o 18- 

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

Il titolo del quiz. 

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

La fascia di età tipica a cui è destinato il quiz. Ad esempio: 7-12 o 18- 

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

Codificare le esercitazioni in HTML o Markdown

La Ricerca Google supporta Markdown (versione CommonMark) e HTML per la codifica di Question, Answer e Comment. L'insieme di costrutti è limitato a:

  • Intestazioni
  • Interruzioni di riga
  • Elenchi (ordinati e non ordinati)
  • Paragrafi
  • Grassetto
  • Corsivo
  • Immagini
  • Formule in LaTex

CSS o JavaScript vengono ignorati. Google non mostrerà le domande che contengono tag HTML non supportati.

Come specificare il formato

Per specificare il formato di codifica utilizzato, usa la proprietà encodingFormat e imposta il valore su "text/html" per HTML o su "text/markdown" per Markdown.

Di seguito è riportato un esempio di domanda impostata sul 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"
  ..
  ..
}

Se encodingFormat non è specificato, viene usato il valore "text/html".

Formule

Per specificare una formula, utilizza il formato LaTex. Devi utilizzare il simbolo del doppio dollaro ($$) to embed formulas. For example: 

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


    
  
Risoluzione dei problemi

  

    Se hai difficoltà con l'implementazione o il debug dei dati strutturati, ecco alcune risorse che potrebbero esserti utili.