Nozioni di base sui dati strutturati JSON-LD

Lo structured data è un JSON leggibile dalle macchine che descrive l'argomento della pagina: un articolo, una ricetta, un prodotto o un evento. I motori di ricerca lo utilizzano per generare risultati avanzati (valutazioni a stelle, schede di ricette, breadcrumb) invece di semplici link blu.

Il formato preferito da Google è JSON-LD: un unico blocco <script type="application/ld+json"> nell'head o nel body, contenente uno o più oggetti schema.org. È separato dall'HTML visibile, perciò aggiungerlo o aggiornarlo non richiede di riscrivere il template.

Ogni oggetto JSON-LD richiede @context (quasi sempre "https://schema.org") e @type (la classe schema.org: Article, Recipe, Product, FAQPage). @context indica ai parser il vocabolario da cui provengono i nomi delle proprietà.

Per Article, fornisca headline, image (URL o array), datePublished, dateModified, author (un oggetto Person o Organization) e publisher (Organization con logo). Questi sono i campi minimi necessari affinché Google prenda in considerazione la pagina per il carosello delle notizie principali.

Le pagine di prodotto dichiarano @type Product con name, image, description, brand, sku e un sotto-oggetto offers contenente price, priceCurrency e availability. Insieme ad aggregateRating, questi dati consentono a Google di mostrare direttamente nel risultato di ricerca le valutazioni a stelle e gli estratti dei prezzi.

BreadcrumbList descrive la gerarchia di navigazione. Ogni itemListElement è un ListItem con position, name e item (l'URL). Quando è presente, Google sostituisce la riga dell'URL nello snippet con il percorso breadcrumb con etichette, ottenendo più clic.

Gli schemi FAQPage e HowTo sbloccavano in precedenza i widget dei risultati avanzati nella SERP. Da allora Google ha limitato i risultati avanzati FAQ ad alcune categorie di siti (gov, edu), ma il markup resta utile per gli assistenti vocali e altri utilizzatori: lo mantenga sulle vere pagine FAQ.

Google penalizza il markup che non corrisponde a ciò che gli utenti vedono. Non dichiari una valutazione di 5 stelle che non compare nella pagina; non indichi un prezzo di 9,99 $ che l'utente non vede. I dati strutturati devono descrivere accuratamente il contenuto visualizzato.

Il Rich Results Test di Google (search.google.com/test/rich-results) analizza qualsiasi URL o codice incollato, elenca i tipi di schema rilevati e segnala le proprietà obbligatorie mancanti. Lo esegua prima di distribuire qualsiasi modifica ai dati strutturati.

Può dichiarare diversi blocchi JSON-LD nella stessa pagina (ad esempio Article + BreadcrumbList + Organization) oppure combinarli in un singolo array @graph. Entrambe le forme sono valide; scelga quella più semplice da gestire nei template della pipeline di build.

JSON-LD risiede in un tag script separato dal contenuto visibile. Per aggiornarlo, rigeneri il blocco JSON: non inserisca mai dati strutturati esclusivamente tramite JavaScript lato client, perché Googlebot non esegue sempre JavaScript in modo affidabile prima dell'indicizzazione.

Quali due proprietà di primo livello deve includere ogni oggetto JSON-LD per essere dati strutturati validi?

JSON-LD dichiara i dati strutturati in un singolo blocco script application/ld+json, con @context e @type che identificano ogni oggetto. Gli schemi più comuni (Article, Product, BreadcrumbList) sbloccano risultati di ricerca avanzati quando il markup riflette accuratamente la pagina visibile. Convalidi i dati con il Rich Results Test prima della distribuzione.