JSON-LD

JSON-LD (JavaScript Object Notation for Linked Data) è un formato di dati strutturati che incorpora informazioni leggibili dalle macchine nelle pagine web utilizzando sintassi JSON standard racchiusa in un tag `<script type="application/ld+json">`. Indica ai motori di ricerca esattamente di cosa tratta una pagina etichettando i contenuti con vocabolario standardizzato da Schema.org, identificando entità come organizzazioni, prodotti, articoli, FAQ ed eventi insieme alle loro proprietà e relazioni. Gli script JSON-LD si trovano nell'head HTML della pagina e non influenzano l'aspetto della pagina per i visitatori. Google raccomanda JSON-LD come formato preferito per i dati strutturati rispetto ad alternative come Microdata e RDFa.

I motori di ricerca utilizzano JSON-LD per alimentare i risultati arricchiti — risultati di ricerca migliorati che mostrano valutazioni a stelle, accordion FAQ, prezzi dei prodotti, percorsi breadcrumb e passaggi "come fare" direttamente nella pagina dei risultati. Le pagine con dati strutturati implementati correttamente tendono a ottenere tassi di clic più elevati perché si distinguono visivamente e forniscono risposte prima ancora che l'utente clicchi. Per gli editori, questo significa più traffico organico ai [flipbook](/glossary/flipbook) e alle pagine documenti senza spesa pubblicitaria aggiuntiva. JSON-LD aiuta anche gli assistenti AI e i motori di risposta a comprendere i contenuti, cosa sempre più importante man mano che gli utenti si spostano verso la ricerca conversazionale.

La funzionalità [SEO e anteprime social](/features/seo-and-social-previews) di FlipLink consente di definire metadati per ogni pubblicazione, che vengono tradotti in dati strutturati analizzabili dai motori di ricerca. Il sito marketing di fliplink.me utilizza anche schemi JSON-LD per Organization, SoftwareApplication, FAQPage, BreadcrumbList e Article per massimizzare la visibilità nelle ricerche. Quando pubblicate un flipbook con titolo, descrizione e miniatura personalizzati, FlipLink genera il markup strutturato appropriato affinché i motori di ricerca possano indicizzare e visualizzare il vostro contenuto con precisione. Questi dati strutturati funzionano insieme agli [OG tags](/glossary/og-tags) — JSON-LD è destinato ai motori di ricerca mentre gli OG tags sono destinati alle piattaforme social.

JSON-LD utilizza una struttura sintattica specifica che segue il vocabolario Schema.org. Ogni blocco JSON-LD inizia con un campo `@context` che punta a Schema.org e un campo `@type` che specifica il tipo di entità. I tipi comuni per l'editoria digitale includono: - **Organization**: Nome dell'azienda, logo, informazioni di contatto, profili social - **SoftwareApplication**: Nome dell'app, prezzi, valutazioni, requisiti del sistema operativo - **FAQPage**: Coppie domanda-risposta visualizzate come risultati arricchiti FAQ espandibili - **Article / BlogPosting**: Autore, data di pubblicazione, titolo, immagine in evidenza - **BreadcrumbList**: Gerarchia di navigazione mostrata come percorsi breadcrumb nei risultati - **HowTo**: Istruzioni passo-passo con immagini opzionali per ogni passaggio - **WebSite**: Nome del sito e azione di ricerca per i sitelink Più blocchi JSON-LD possono esistere su una singola pagina, ciascuno descrivendo un'entità diversa. Non devono referenziarsi a vicenda — i motori di ricerca li combinano per costruire una comprensione completa della pagina.

Se state aggiungendo JSON-LD a pagine che presentano contenuti FlipLink, seguite questa checklist: 1. **Identificate il tipo di pagina.** Determinate quale tipo Schema.org descrive meglio la vostra pagina — Article per i post del blog, FAQPage per le sezioni FAQ, Product o SoftwareApplication per le pagine prodotto. 2. **Definite le proprietà obbligatorie.** Ogni tipo di schema ha proprietà obbligatorie e raccomandate. Per Article servono come minimo `headline`, `author`, `datePublished` e `image`. Consultate la documentazione di Google sui dati strutturati per i dettagli. 3. **Aggiungete il tag script JSON-LD.** Inserite un blocco `<script type="application/ld+json">` nella sezione `<head>` della pagina contenente i dati strutturati. 4. **Validate il markup.** Usate il Rich Results Test di Google per confermare che il JSON-LD è sintatticamente corretto e idoneo per i risultati arricchiti. 5. **Testate su diversi tipi di pagina.** Se avete più template (pagine prodotto, post del blog, voci del glossario), validate ciascun template separatamente poiché utilizzano tipi di schema diversi. 6. **Monitorate in Search Console.** Dopo il deployment, controllate i report Miglioramenti di Google Search Console per errori o avvisi sui dati strutturati. Correggete eventuali problemi tempestivamente per mantenere l'idoneità ai risultati arricchiti.

**JSON-LD garantisce che la mia pagina otterrà risultati arricchiti?** No. JSON-LD rende la pagina idonea per i risultati arricchiti, ma Google decide se visualizzarli in base alla qualità del contenuto, rilevanza e altri fattori di ranking. Un'implementazione corretta aumenta significativamente le possibilità ma non garantisce risultati migliorati. **Posso avere più blocchi JSON-LD su una pagina?** Sì. È comune includere blocchi separati per BreadcrumbList, il tipo di contenuto principale (Article, FAQPage, ecc.) e Organization su una singola pagina. I motori di ricerca analizzano ogni blocco indipendentemente e combinano le informazioni. **Qual è la differenza tra JSON-LD e [Schema Markup](/glossary/schema-markup)?** [Schema Markup](/glossary/schema-markup) si riferisce alla pratica generale di aggiungere dati strutturati alle pagine web usando il vocabolario Schema.org. JSON-LD è uno dei tre formati per implementare lo [schema markup](/glossary/schema-markup), insieme a Microdata e RDFa. JSON-LD è il formato raccomandato da Google perché è il più facile da implementare e mantenere — i dati risiedono in un tag script separato anziché essere intrecciati nel markup HTML della pagina.