JSON-LD

JSON-LD vive in un tag script con type application/ld+json, di solito nell’head o nel body della pagina. Poiché resta separato dal markup renderizzato, non intreccia attributi nel tuo HTML come fanno i microdata e RDFa, ed è per questo che Google lo consiglia e che è il formato più semplice da aggiungere, controllare e rimuovere senza alterare il layout. Ogni blocco è un oggetto autonomo con un @context che punta al vocabolario schema.org e un @type che nomina l’entità, così una macchina può leggere la pagina come dato anziché dedurre il significato dal testo.

Un singolo blocco può descrivere un prodotto, un articolo, un’organizzazione, un percorso di breadcrumb o le valutazioni aggregate delle recensioni, e più blocchi possono coesistere su una stessa pagina. Il formato è semplice JSON, quindi è facile da generare per un template e da leggere per un validatore, e può essere iniettato dopo il caricamento della pagina dai tag manager quando non puoi modificare il template direttamente. Puoi anche collegare le entità per riferimento usando @id, così un blocco Product può puntare all’Organisation che lo vende senza ripetere per intero i dati del marchio.

Prendi un negozio Shopify che vende una ceramica artigianale monoprodotto. Il template prodotto genera un blocco AggregateRating con ratingValue di 4,7 su un reviewCount di 213, un blocco Offer con price 18,00 e priceCurrency EUR e availability impostata su InStock, e un blocco Organisation separato su ogni pagina che descrive il laboratorio e il suo logo. Quando il commerciante lancia una vendita lampo, il tema deve rigenerare il prezzo nel JSON nello stesso momento in cui cambia il prezzo sulla pagina, altrimenti i due valori vanno fuori sincrono. Se un prodotto si esaurisce, availability deve passare a OutOfStock anche nel markup, altrimenti Google può continuare a mostrare un prezzo e uno stato di disponibilità che non valgono più.

JSON-LD conta anche per i motori di risposta. ChatGPT, Perplexity e Google AI Overviews si appoggiano a segnali puliti e leggibili quando decidono di cosa parla una pagina e se citarla, e un blocco ben formato rimuove l’ambiguità su nome del prodotto, prezzo, valutazione e venditore. Non è una garanzia di essere citati, e questi sistemi leggono comunque il testo visibile, ma i dati strutturati abbassano il costo di comprensione della pagina e rendono i fatti chiave più difficili da interpretare male.

La precisazione onesta è che JSON-LD deve corrispondere a ciò che il visitatore vede davvero. Google considera i dati strutturati che dichiarano valutazioni, prezzi o contenuti non presenti sulla pagina una violazione delle linee guida, e può sopprimere i rich snippet o emettere un’azione manuale. Tieni il JSON sincronizzato con il contenuto visibile, validalo dopo le modifiche al template e trattalo come una descrizione fedele della pagina, non come un posto in cui aggiungere dichiarazioni in più.