Verifica dei dati strutturati JSON-LD
Basta incollare il sorgente HTML o il JSON-LD per convalidare i dati strutturati come FAQPage, BreadcrumbList e Article. Elenca le proprietà obbligatorie mancanti o superflue e gli errori che sfuggono più facilmente nei risultati arricchiti di Google: utile per una verifica prima della pubblicazione.
Consigli
- Nella proprietà acceptedAnswer di FAQPage inserite sempre una stringa diretta nella proprietà text: con un oggetto o un vettore i risultati arricchiti di Google non la riconoscono.
- I valori di position in BreadcrumbList devono formare una successione che comincia da 1: numeri mancanti o ripetuti impediscono il riconoscimento della sequenza di navigazione.
- Per la proprietà headline di Article il riferimento pratico è di circa 110 caratteri: superandoli, il testo può risultare troncato nei risultati di ricerca.
- Anche incollando l'intero sorgente HTML, lo strumento estrae automaticamente il solo contenuto dei blocchi <script type="application/ld+json">: potete comunque incollare la sola parte JSON.
- Collocando più insiemi di dati strutturati in una stessa pagina, conviene scriverli in marcatori <script> distinti: la manutenzione risulta più agevole.
Domande frequenti
A proposito — perché JSON-LD ha soppiantato Microdata e RDFa
JSON-LD, cioè JSON per i dati collegati, nacque nella prima metà degli anni Dieci da un gruppo di lavoro del consorzio del web come formato per i dati collegati. A differenza delle notazioni precedenti, che incorporavano i dati strutturati negli attributi degli elementi HTML, JSON-LD si scrive come JSON autonomo dentro un marcatore <script>: se ne possono quindi aggiungere e togliere senza toccare minimamente la disposizione della pagina. Google lo indica come formato raccomandato dal 2015 circa e oggi anche la documentazione sui risultati arricchiti presuppone questa notazione.
Anche la sezione delle domande frequenti di questo sito funziona così: basta scrivere nella pagina le domande e le risposte una a una perché il JSON-LD in formato FAQPage venga generato internamente. Non occorre battere due volte, per le persone e per i motori di ricerca, lo stesso contenuto: correggendone uno l'altro segue da sé, e si evita così ogni discrepanza fra ciò che si vede e lo schema dichiarato.
Anche quando il JSON è sintatticamente ineccepibile, se mancano le proprietà obbligatorie di Schema.org o quelle raccomandate da Google, i risultati arricchiti — le domande frequenti mostrate nei risultati di ricerca, la sequenza di navigazione — possono non comparire. Le proprietà profondamente annidate come acceptedAnswer.text sono l'esempio tipico di ciò che si sbaglia più facilmente. Una verifica meccanica prima della pubblicazione permette di scoprire i difetti assai prima di accorgersene nella relazione sui miglioramenti di Search Console.