Che cos'è JSON-LD?

JSON-LD (JavaScript Object Notation for Linked Data) è il formato che i motori di ricerca raccomandano per i dati strutturati. Una pagina aggiunge un blocco <script type="application/ld+json"> che descrive l'argomento della pagina, ad esempio un prodotto con il relativo prezzo, un articolo con il relativo autore o un'organizzazione con il relativo logo, utilizzando tipi e proprietà del vocabolario schema.org. Google, Bing e altri motori di ricerca leggono questi blocchi per mostrare risultati avanzati come valutazioni a stelle, prezzi, breadcrumb e schede di ricette.

Gli errori in JSON-LD non producono messaggi visibili. La pagina continua a essere caricata, ma una virgola mancante, un tipo scritto in modo errato o un campo obbligatorio mancante fanno sì che i motori di ricerca ignorino il markup o che la pagina perda il relativo risultato avanzato.

Descrizione dello strumento

Questo strumento recupera l'HTML di una pagina sul server, individua ogni blocco script JSON-LD e controlla ciascuno di essi in due fasi. Prima verifica il JSON-LD in sé: che il JSON venga analizzato correttamente, che ogni elemento abbia un @context che faccia riferimento a schema.org e un @type, e che le parole chiave come @type e @id siano scritte e strutturate correttamente. Poi verifica il contenuto rispetto al vocabolario schema.org e alle regole di Google per i risultati avanzati, segnalando tipi sconosciuti, proprietà non pertinenti a un tipo e campi obbligatori o consigliati mancanti o con un formato errato.

Funzionalità

  • Individua ogni blocco JSON-LD in una pagina online, all'interno di <head> o <body>
  • Segnala gli errori di sintassi JSON con il messaggio del parser
  • Controlla @context, @type, @id, @graph e la corretta ortografia delle parole chiave
  • Segnala i tipi schema.org e le proprietà sconosciuti che un tipo non supporta
  • Controlla i campi obbligatori e consigliati da Google per prodotti, offerte, recensioni, valutazioni, ricette, annunci di lavoro, video, breadcrumb e altro
  • Elenca ogni elemento di dati strutturati con il relativo tipo e nome
  • Mostra ogni blocco come JSON formattato

Come funziona

La pagina viene scaricata senza seguire i reindirizzamenti e vengono letti al massimo i primi 3 MB. Ogni blocco JSON-LD viene analizzato separatamente e gli elementi all'interno di un @graph vengono controllati come elementi distinti. I controlli schema.org utilizzano una copia del vocabolario completo di schema.org, mentre i controlli dei risultati avanzati di Google utilizzano il validatore di dati strutturati open source di Adobe.

Suggerimenti

  • Gli errori indicano che è probabile che i motori di ricerca ignorino l'elemento o che questo non ottenga un risultato avanzato, quindi correggili prima. Gli avvisi riguardano solitamente campi consigliati e la loro aggiunta può migliorare l'aspetto del risultato.
  • Le parole chiave JSON-LD distinguono tra maiuscole e minuscole: @type funziona, mentre @Type no.
  • Usa URL assoluti per url, image e logo e date ISO 8601 come 2026-09-25 o 2026-09-25T10:00:00+02:00.
  • Lo strumento legge l'HTML restituito dal server. Il JSON-LD aggiunto successivamente da JavaScript nel browser non verrà individuato.