Perché i dati strutturati contano davvero (senza magia)
I dati strutturati sono un modo standardizzato per descrivere a un motore di ricerca “che cosa” contiene una pagina: un articolo, un prodotto, una persona, un’azienda, una breadcrumb, una FAQ, un evento. Google usa questi segnali per comprendere e classificare meglio il contenuto e, quando la pagina è idonea, per mostrarlo in modo più ricco nei risultati (rich results).
Due precisazioni nette:
- Non esiste garanzia che il markup produca rich results: abilita l’idoneità, ma Google decide se mostrarli o meno.
- Il valore operativo principale è comprensione + idoneità, non “boost” diretto di ranking.
Che cos’è JSON-LD (e perché è la scelta pratica)
JSON-LD (JavaScript Object Notation for Linked Data) è un formato che inserisci nella pagina come blocco dati, tipicamente in un tag <script type="application/ld+json">. È separato dall’HTML visibile: questo lo rende pulito da gestire, aggiornare e validare.
Google supporta più formati (JSON-LD, Microdata, RDFa), ma nelle linee guida indica JSON-LD come formato consigliato, e può stare sia in <head> sia in <body>.
Schema.org: vocabolario, non “plugin”
Schema.org è il vocabolario: un elenco di tipi (Article, Organization, Product, ecc.) e proprietà (headline, author, datePublished, …). JSON-LD è solo il contenitore. In pratica: Schema.org = lingua; JSON-LD = formato del file.
Esempio pratico: JSON-LD per un articolo (Article / BlogPosting)
Questo è un esempio completo e realistico per un articolo. Sostituisci i valori con quelli del tuo CMS. Nota: le date vanno in formato ISO 8601; se puoi, includi il fuso orario.
Template (obbligatorio): sostituisci i segnaposto {{...}} con valori reali coerenti con la pagina (URL, immagini, autore, date, canonical). Non incollare in produzione senza compilare.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "BlogPosting",
"headline": "{{PAGE_TITLE}}",
"description": "{{META_DESCRIPTION}}",
"image": [
"{{IMAGE_URL}}"
],
"author": {
"@type": "Person",
"name": "{{AUTHOR_NAME}}",
"url": "{{AUTHOR_URL}}"
},
"publisher": {
"@type": "Organization",
"name": "{{SITE_NAME}}",
"logo": {
"@type": "ImageObject",
"url": "{{LOGO_URL}}"
}
},
"datePublished": "{{DATE_PUBLISHED_ISO}}",
"dateModified": "{{DATE_MODIFIED_ISO}}",
"mainEntityOfPage": {
"@type": "WebPage",
"@id": "{{CANONICAL_URL}}"
}
}
</script>
Scelte tecniche consigliate:
- @type: per blog va benissimo
BlogPosting(variante di Article). In alternativaArticle. - mainEntityOfPage.@id: usa la URL canonica reale dell’articolo.
- image: meglio un array, anche con una sola immagine.
- dateModified: se aggiorni spesso gli articoli, valorizzarlo aiuta a comunicare freschezza in modo coerente.
Extra ad alto ROI: Organization + BreadcrumbList
1) Organization (identità del sito)
Questo markup rafforza la chiarezza su “chi” pubblica il contenuto, utile soprattutto quando vuoi coerenza editoriale e segnali di entità.
Template: compila i profili social solo se esistono davvero e sono pubblici.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Organization",
"name": "{{SITE_NAME}}",
"url": "{{SITE_URL}}",
"logo": "{{LOGO_URL}}",
"sameAs": [
"{{SOCIAL_FACEBOOK_URL}}",
"{{SOCIAL_YOUTUBE_URL}}"
]
}
</script>
2) BreadcrumbList (navigazione gerarchica)
Le breadcrumb sono uno dei casi più puliti: poco rischio, alta coerenza, e Google spesso le usa in SERP quando la struttura è chiara.
Template: usa solo categorie/URL reali e raggiungibili. Se non hai breadcrumb, non forzarle.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "BreadcrumbList",
"itemListElement": [
{
"@type": "ListItem",
"position": 1,
"name": "{{BREADCRUMB_1_NAME}}",
"item": "{{BREADCRUMB_1_URL}}"
},
{
"@type": "ListItem",
"position": 2,
"name": "{{BREADCRUMB_2_NAME}}",
"item": "{{BREADCRUMB_2_URL}}"
},
{
"@type": "ListItem",
"position": 3,
"name": "{{BREADCRUMB_3_NAME}}",
"item": "{{BREADCRUMB_3_URL}}"
}
]
}
</script>
WordPress: plugin o inserimento manuale
Su WordPress puoi:
- usare plugin (Yoast / Rank Math / equivalenti) per generare markup base automaticamente;
- inserire JSON-LD manualmente (tema child, hook, oppure plugin di inserimento codice).
Nota operativa: se un plugin genera già Article/Organization, evita duplicazioni. Doppio markup incoerente = rumore, non segnale.
CMS PHP custom: generazione corretta (senza errori stupidi)
Nel tuo CMS la soluzione più solida è: costruisci un array PHP con i campi dell’articolo e lo serializzi con json_encode in modalità “safe”.
Template: i valori devono essere coerenti con il contenuto visibile e con la URL canonica reale.
<?php
$schema = [
"@context" => "https://schema.org",
"@type" => "BlogPosting",
"headline" => $article["title"],
"description" => $article["meta_description"],
"image" => [$article["image_url"]],
"author" => [
"@type" => "Person",
"name" => $article["author_name"],
"url" => $article["author_url"]
],
"publisher" => [
"@type" => "Organization",
"name" => $site["name"],
"logo" => [
"@type" => "ImageObject",
"url" => $site["logo_url"]
]
],
"datePublished" => $article["date_published_iso8601"],
"dateModified" => $article["date_modified_iso8601"],
"mainEntityOfPage" => [
"@type" => "WebPage",
"@id" => $article["canonical_url"]
]
];
?>
<script type="application/ld+json">
<?php
echo json_encode(
$schema,
JSON_UNESCAPED_UNICODE | JSON_HEX_TAG
);
?>
</script>
Regola d’oro: i valori nel JSON-LD devono descrivere contenuti realmente presenti e visibili nella pagina. Se dichiari autore, immagine, date, devono essere coerenti con ciò che l’utente vede.
Validazione: testare prima di “credere”
Fai sempre due controlli:
- Rich Results Test: verifica idoneità e anteprima dei risultati avanzati (quando applicabile).
- Schema Markup Validator: validazione generica Schema.org (utile per errori sintattici e proprietà sbagliate).
Dopo la pubblicazione, monitora in Search Console (report “Miglioramenti” / “Risultati avanzati” quando disponibili) e usa l’Ispezione URL per verificare come Google vede davvero la pagina.
Errori tipici che bruciano risultati (e tempo)
- Markup non rappresentativo: dichiari cose che la pagina non mostra (rischio policy e perdita idoneità).
- URL sbagliate: canonical incoerente, immagini non accessibili, pagine in noindex.
- Dati duplicati o contraddittori: due script Article diversi, due autori diversi, date incoerenti.
- Tipo schema errato: forzi FAQPage o Review dove non esistono davvero FAQ o recensioni reali.
Checklist finale (operativa)
- Ho scelto lo schema giusto per la pagina (Article/BlogPosting, Breadcrumb, Organization…).
- I campi nel JSON-LD corrispondono a contenuti visibili e verificabili.
- Le date sono in ISO 8601 e, se possibile, includono timezone.
- Ho validato con Rich Results Test e Schema Markup Validator.
- Ho controllato in Search Console e non ho bloccato la pagina (robots/noindex/login).
Conclusione: i dati strutturati non sono estetica, sono ingegneria semantica. Se li tratti come una disciplina tecnica (coerenza, validazione, monitoraggio), diventano un moltiplicatore pulito di leggibilità e, quando Google lo decide, di visibilità.
