Guida approfondita su JSON-LD
1. Introduzione a JSON-LD
JSON-LD (JavaScript Object Notation for Linked Data) è un formato di dati leggero e facile da leggere sia per gli umani che per le macchine. È basato su JSON e viene utilizzato per serializzare dati strutturati interconnessi sul web. JSON-LD permette di aggiungere semantica ai dati, rendendo più facile il loro utilizzo e interpretazione da parte dei sistemi di ricerca e altre applicazioni.
2. Sintassi di base di JSON-LD
JSON-LD si basa sulla sintassi JSON e aggiunge alcune caratteristiche specifiche per la gestione dei dati collegati. I documenti JSON-LD contengono una struttura ad albero composta da oggetti, array e valori.
Esempio:
less
{
"@context": "https://schema.org/",
"@type": "Person",
"name": "Mario Rossi",
"jobTitle": "Ingegnere del software"
}
Il contesto JSON-LD è un meccanismo che permette di mappare termini a IRI (Internationalized Resource Identifiers), facilitando l’interpretazione dei dati. Un contesto può essere un oggetto interno al documento JSON-LD o un riferimento a un documento esterno.
Esempio di contesto interno:
scss
{
"@context": {
"schema": "https://schema.org/",
"name": "schema:name",
"jobTitle": "schema:jobTitle"
},
"@type": "schema:Person",
"name": "Mario Rossi",
"jobTitle": "Ingegnere del software"
}
4. Espansione e contrazione
L’espansione JSON-LD è il processo di trasformazione di un documento JSON-LD in una forma completamente espansa, dove tutte le chiavi sono sostituite con le loro IRI corrispondenti. La contrazione è il processo inverso.
Esempio di espansione:
less
{
"@id": "https://example.com/person/1",
"https://schema.org/name": "Mario Rossi",
"https://schema.org/jobTitle": "Ingegnere del software"
}
5. Framing e Flattening
Il framing JSON-LD è una tecnica che permette di modellare l’output di un documento JSON-LD in una struttura specifica, rendendolo più facile da elaborare. Il flattening è il processo di trasformazione di un documento JSON-LD in un array di oggetti, eliminando eventuali annidamenti.
Esempio di framing:
less
{
"@context": "https://schema.org/",
"@type": "Person",
"name": "Mario Rossi",
"jobTitle": "Ingegnere del software",
"colleagues": {
"@type": "Person",
"name": "Luigi Bianchi"
}
}
6. Esempi pratici
Ecco alcuni esempi di documenti JSON-LD per diversi casi d’uso.
Esempio di documento JSON-LD per un evento:
json
{
"@context": "https://schema.org/",
"@type": "Event",
"name": "Conferenza sull'intelligenza artificiale",
"startDate": "2023-05-01T09:00:00",
"endDate": "2023-05-03T18:00:00",
"location": {
"@type": "Place",
"name": "Centro Congressi Internazionale",
"address": {
"@type": "PostalAddress",
"streetAddress": "Via dei Congressi, 1",
"addressLocality": "Roma",
"postalCode": "00100",
"addressCountry": "IT"
}
},
"organizer": {
"@type": "Organization",
"name": "Società Italiana di Intelligenza Artificiale",
"url": "https://www.example.it/siia"
}
}
Esempio di documento JSON-LD per un prodotto e-commerce:
{
"@context": "https://schema.org/",
"@type": "Product",
"name": "Smartphone XYZ",
"image": "https://www.example.it/images/smartphone-xyz.jpg",
"description": "Smartphone XYZ con schermo 6 pollici, 128GB di memoria e fotocamera 48MP.",
"brand": {
"@type": "Brand",
"name": "XYZ"
},
"offers": {
"@type": "Offer",
"priceCurrency": "EUR",
"price": "499.99",
"availability": "http://schema.org/InStock",
"seller": {
"@type": "Organization",
"name": "Esempio E-commerce"
}
}
}
Esempio di documento JSON-LD per un’organizzazione:
{
"@context": "https://schema.org/",
"@type": "Organization",
"name": "Web Agency S.r.l.s.",
"url": "https://www.example.it/",
"logo": "https://www.example.it/logo.png",
"contactPoint": {
"@type": "ContactPoint",
"telephone": "+39-06-12345678",
"contactType": "Servizio clienti"
},
"address": {
"@type": "PostalAddress",
"streetAddress": "Via delle Industrie, 10",
"addressLocality": "Roma",
"postalCode": "00100",
"addressCountry": "IT"
}
}
In questi esempi, JSON-LD viene utilizzato per rappresentare informazioni su un evento, un prodotto e un’organizzazione in modo strutturato e facilmente interpretabile sia per le persone che per le macchine. Questi dati possono essere sfruttati dai motori di ricerca e altre applicazioni per comprendere meglio il contenuto di una pagina web e fornire risultati di ricerca più accurati e pertinenti.
Come posso utilizzare JSON-LD sul mio sito web?
Per utilizzare JSON-LD sul tuo sito web, segui questi passaggi:
- Identifica il tipo di contenuto che desideri descrivere con JSON-LD. Ad esempio, potresti voler descrivere un evento, un prodotto, un’organizzazione o un articolo di blog.
- Visita il sito di Schema.org (https://schema.org/) e cerca il tipo di oggetto più adatto al tuo caso d’uso. Schema.org è una raccolta di vocabolari di dati strutturati che possono essere utilizzati con JSON-LD.
- Crea un documento JSON-LD utilizzando la sintassi appropriata. Assicurati di includere un contesto (
@context) che punti a “https://schema.org/“, il tipo dell’oggetto (@type) e i relativi attributi e valori. Puoi utilizzare gli esempi forniti in questa guida come punto di partenza. - Aggiungi il documento JSON-LD al codice HTML del tuo sito web utilizzando un elemento
<script>con l’attributotypeimpostato su “application/ld+json”. Ad esempio:
html
<script type="application/ld+json">
{
"@context": "https://schema.org/",
"@type": "Product",
"name": "Smartphone XYZ",
"image": "https://www.example.it/images/smartphone-xyz.jpg",
"description": "Smartphone XYZ con schermo 6 pollici, 128GB di memoria e fotocamera 48MP.",
"brand": {
"@type": "Brand",
"name": "XYZ"
},
"offers": {
"@type": "Offer",
"priceCurrency": "EUR",
"price": "499.99",
"availability": "http://schema.org/InStock",
"seller": {
"@type": "Organization",
"name": "Esempio E-commerce"
}
}
}
</script>
Inserisci l’elemento
<script>nel codice HTML della pagina in cui desideri che i dati JSON-LD vengano interpretati dai motori di ricerca e altre applicazioni. Di solito, è consigliabile posizionare l’elemento<script>all’interno del tag<head>del tuo documento HTML, ma può anche essere posizionato nel tag<body>.Testa il tuo documento JSON-LD utilizzando uno strumento di validazione come il “Strumento per i dati strutturati” di Google (https://search.google.com/structured-data/testing-tool) o il “JSON-LD Playground” (https://json-ld.org/playground/). Questi strumenti ti aiuteranno a identificare eventuali errori nella sintassi JSON-LD e a verificare che i dati vengano interpretati correttamente.
Una volta completati questi passaggi, i motori di ricerca e altre applicazioni che supportano JSON-LD saranno in grado di comprendere e utilizzare i dati strutturati presenti sul tuo sito web, migliorando la visibilità e la rilevanza dei tuoi contenuti nei risultati di ricerca.
Come posso aggiungere JSON-LD al mio sito web WordPress?
Installa e attiva un plugin per l’inserimento di JSON-LD: Esistono diversi plugin WordPress che facilitano l’aggiunta di JSON-LD al tuo sito. Alcuni esempi di questi plugin sono “Schema & Structured Data for WP & AMP”, “WP SEO Structured Data Schema” e “All In One Schema Rich Snippets”. Puoi cercare il plugin più adatto alle tue esigenze nel repertorio ufficiale dei plugin WordPress (https://wordpress.org/plugins/).
Configura il plugin: Dopo aver installato e attivato il plugin, accedi al pannello di amministrazione di WordPress e trova le impostazioni del plugin. In base al plugin scelto, potresti dover configurare le impostazioni generali, selezionare il tipo di schema da utilizzare e inserire i dati specifici del tuo sito. Segui le istruzioni fornite dal plugin per completare la configurazione.
Aggiungi JSON-LD ai tuoi contenuti: Una volta configurato il plugin, dovresti essere in grado di aggiungere JSON-LD ai tuoi post, pagine o tipi di contenuto personalizzati. In molti plugin, questo può essere fatto tramite un’interfaccia utente integrata nel pannello di amministrazione di WordPress. In alternativa, alcuni plugin offrono shortcode o blocchi specifici per l’inserimento di JSON-LD nei tuoi contenuti.
Verifica l’integrazione dei dati strutturati: Dopo aver aggiunto JSON-LD al tuo sito web WordPress, è importante verificare che i dati strutturati vengano interpretati correttamente dai motori di ricerca. Utilizza uno strumento di validazione come il “Strumento per i dati strutturati” di Google (https://search.google.com/structured-data/testing-tool) o il “JSON-LD Playground” (https://json-ld.org/playground/) per testare le pagine del tuo sito e assicurarti che il JSON-LD sia correttamente integrato.
Seguendo questi passaggi, sarai in grado di aggiungere JSON-LD al tuo sito web WordPress e migliorare la visibilità dei tuoi contenuti nei risultati di ricerca.
Perché il JSON-LD è il formato migliore per i dati strutturati?
Il JSON-LD (JavaScript Object Notation for Linked Data) è considerato il formato migliore per i dati strutturati per diverse ragioni:
Facilità d’uso: Il JSON-LD è basato sulla notazione JSON, che è un formato di dati leggibile dagli umani e ampiamente utilizzato per lo scambio di dati tra client e server. La sua sintassi semplice e concisa lo rende facile da scrivere e comprendere.
Separazione dei dati e della presentazione: A differenza di altri formati di dati strutturati come Microdata e RDFa, che richiedono l’integrazione dei dati strutturati direttamente nel codice HTML, il JSON-LD consente di separare i dati strutturati dalla presentazione. Questo permette di mantenere il codice HTML pulito e semplifica la gestione dei dati strutturati.
Flessibilità: Il JSON-LD supporta la definizione di contesti e l’estensione di vocabolari, il che consente di creare schemi personalizzati e combinare diversi vocabolari in un unico documento. Questa flessibilità rende il JSON-LD adatto a una vasta gamma di applicazioni e settori.
Interoperabilità: Il JSON-LD è un formato standardizzato per i dati strutturati e fa parte delle specifiche del World Wide Web Consortium (W3C). Questo significa che è ampiamente supportato e compatibile con una vasta gamma di strumenti e tecnologie.
Supporto dei motori di ricerca: I principali motori di ricerca come Google, Bing e Yahoo! raccomandano l’uso del JSON-LD per l’implementazione dei dati strutturati. L’adozione di JSON-LD può migliorare la visibilità e la pertinenza dei contenuti nei risultati di ricerca e favorire l’ottenimento di risultati avanzati come i rich snippets e le Knowledge Graph.
Per tutte queste ragioni, il JSON-LD è considerato il formato migliore per l’implementazione dei dati strutturati nei siti web e nelle applicazioni web.
