francescomargiotta.com

Generatore JSON-LD e Schema.org

Genera dati strutturati JSON-LD per FAQ, articoli, prodotti, organizzazioni, persone, breadcrumb e libri, con validazione, direttamente nel browser.

«Titolo (headline)» è obbligatorio.

«URL della pagina» è consigliato per i risultati arricchiti di Google.

«URL dell'immagine» è consigliato per i risultati arricchiti di Google.

«Data di pubblicazione» è consigliato per i risultati arricchiti di Google.

«Nome dell'autore» è consigliato per i risultati arricchiti di Google.

Verifica il risultato prima di pubblicarlo:

Cos'è JSON-LD e come usare questo generatore

JSON-LD è il formato con cui descrivi a un motore di ricerca che cosa contiene una pagina, usando il vocabolario di Schema.org: che quella pagina è un articolo con un titolo, un autore e una data, oppure un prodotto con un prezzo, oppure un elenco di domande e risposte. Si scrive come un blocco di JSON dentro un tag script di tipo application/ld+json, separato dall'HTML visibile, ed è il formato che Google raccomanda. Questo strumento ti guida campo per campo e produce il codice pronto da incollare.

Cosa aspettarsi dai dati strutturati: aiutano i motori a capire la pagina e la rendono idonea a risultati arricchiti, come prezzo e valutazione per i prodotti, breadcrumb al posto dell'URL, autore e data per gli articoli. Non li garantiscono, e Google non li indica come fattore di posizionamento diretto. Un dettaglio utile da conoscere: dal 2023 i risultati arricchiti delle FAQ sono mostrati solo per siti governativi e sanitari autorevoli. Il markup FAQPage resta valido e leggibile dalle macchine, ma per la maggior parte dei siti non cambierà l'aspetto del risultato.

Come si usa: scegli il tipo di dato, compila i campi (quelli con l'asterisco sono obbligatori; gli altri, se lasciati vuoti, vengono semplicemente omessi dall'output), copia il codice e incollalo nella pagina, nell'head o nel body, perché entrambi i punti sono accettati. Prima di pubblicare, controlla il risultato con il Google Rich Results Test e con lo Schema Markup Validator: i link sono sotto lo strumento.

La regola più importante: il markup deve descrivere ciò che è davvero visibile nella pagina. Non marcare contenuti che l'utente non vede e non inserire valutazioni o recensioni inventate o assenti dalla pagina: è una violazione delle linee guida di Google e può costare un'azione manuale sul sito. Per questo lo strumento genera la valutazione di un prodotto solo se compili sia la media sia il numero di recensioni, e ti ricorda di usare soltanto dati reali.

Tutto avviene nel tuo browser: i dati che inserisci non vengono inviati a nessun server. Quando il codice è racchiuso nel tag script, lo strumento sostituisce il carattere «<» con la sequenza equivalente \u003c: se nel testo ci fosse per errore «</script>», chiuderebbe il tag e romperebbe la pagina, e questa sostituzione lo impedisce senza cambiare il significato dei dati. Puoi inserire più blocchi JSON-LD nella stessa pagina, per esempio un Article e un BreadcrumbList insieme.

Domande frequenti

Dove incollo il codice JSON-LD?
In un tag script di tipo application/ld+json, nell'head o nel body della pagina: Google accetta entrambi. Se usi un CMS, molti hanno un campo per codice personalizzato o un plugin; con un framework si inserisce nel template della pagina.
JSON-LD o Microdata?
Entrambi sono validi, ma Google raccomanda JSON-LD: sta separato dall'HTML visibile, quindi è più semplice da scrivere, aggiornare e verificare.
I dati strutturati migliorano il posizionamento?
Non direttamente, secondo Google. Possono rendere la pagina idonea a risultati arricchiti, che possono aumentare visibilità e clic, ma non c'è alcuna garanzia che vengano mostrati.
Perché le FAQ non mostrano il risultato arricchito?
Dal 2023 Google mostra i risultati arricchiti delle FAQ solo per siti governativi e sanitari autorevoli. Il markup resta valido e leggibile dalle macchine, ma per gli altri siti di solito non cambia come appare il risultato.
Posso mettere più blocchi JSON-LD nella stessa pagina?
Sì. Puoi usare più tag script, per esempio uno per l'articolo e uno per il breadcrumb, oppure un unico blocco con più entità. Ogni blocco deve descrivere contenuti realmente presenti nella pagina.
I dati inseriti vengono inviati a un server?
No. Il codice viene generato interamente nel tuo browser: nulla viene trasmesso, salvato o registrato.

Dai libri

Anatomia di un LLM
Anatomia di un LLM

Dai token all'hardware: come funziona davvero l'IA generativa

Scopri il libro

Strumenti correlati