Il markup schema descrive il contenuto di una pagina in forma strutturata. JSON-LD è il formato dei dati; tipi come Article e Product identificano ciò che viene descritto. Il generatore gratuito di Screpy trasforma i dati di articoli, prodotti o percorsi di navigazione in JSON-LD. Scegli il tipo corretto, compila il modulo e controlla il risultato prima di aggiungerlo al sito. Puoi copiare lo script completo o scaricare i dati JSON.
La generazione è il primo passo. Lo strumento non legge la pagina, non verifica prezzo o autore, non installa codice e non lo invia a Google. Servono fatti corretti, inserimento nella pagina giusta e controllo del risultato pubblicato.
Scegli il tipo di schema adatto alla pagina
Parti da ciò che il visitatore può davvero leggere o acquistare, non dall’aspetto che desideri nei risultati di ricerca. Sono disponibili tre modalità e tre sottotipi di articolo:
| Contenuto della pagina | Scelta | Cosa descrive |
|---|---|---|
| Articolo editoriale generale | Article | Articolo, titolo e autore |
| Articolo del blog | BlogPosting | Articolo presentato come post di blog |
| Notizia | NewsArticle | Articolo di attualità |
| Un prodotto con un’offerta | Product | Prodotto e un Offer attuale |
| Percorso di navigazione | Breadcrumb | BreadcrumbList ordinata |
Una categoria non è automaticamente un singolo Product. Una pagina commerciale non diventa NewsArticle solo perché l’opzione esiste. Seleziona il tipo che rappresenta fedelmente il contenuto.
Per indirizzo, contatti e orari di un’attività usa Local Business Schema Generator. Questo generatore non crea tutti i tipi di Schema.org. È preferibile un tipo preciso a dati forzati in un modulo non adatto.
Prepara informazioni corrette sull’articolo
Scegli Article, BlogPosting o NewsArticle e inserisci URL, titolo e nome dell’autore. Sono campi obbligatori di questo modulo, non requisiti universali di Google. La documentazione attuale di Article descrive proprietà consigliate quando pertinenti, anziché un elenco obbligatorio per tutti i casi.
L’autore generato è una sola Person. Usa il nome di una persona reale e, se disponibile, l’URL del profilo che la identifica. Non inserire un editore come persona né unire più autori in un solo nome per adattarli al modulo. Un autore Organization o più autori richiedono un’implementazione che rappresenti correttamente questi fatti. Questa schermata non produce quelle strutture.
I dettagli aggiuntivi comprendono fino a tre URL di immagini e le date effettive di pubblicazione e modifica. Usa immagini pertinenti e accessibili, non indirizzi inventati o un semplice logo per eliminare un avviso. Il modulo accetta date di calendario e rifiuta modifiche precedenti alla pubblicazione. Non cambiare la data iniziale in quella di oggi solo perché aggiungi markup.
Gli avvisi per immagini o date mancanti chiedono di verificare informazioni reali. Non giustificano valori inventati e non definiscono tutti i requisiti di una funzione di ricerca.
Descrivi una vera offerta per un prodotto
La modalità prodotto richiede nome, URL, prezzo reale, valuta e disponibilità. Seleziona lo stato corretto: InStock, OutOfStock, PreOrder, BackOrder o Discontinued. Descrizione, immagine, SKU e marchio sono facoltativi. Il risultato contiene un Product con un Offer: non è un feed, un sistema di varianti o un aggiornamento automatico delle scorte.
Per una Trail Bottle immaginaria a 29,90 EUR, disponibile in magazzino, la struttura essenziale è:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Product",
"name": "Trail Bottle",
"url": "https://example.com/products/trail-bottle/",
"offers": {
"@type": "Offer",
"url": "https://example.com/products/trail-bottle/",
"price": 29.9,
"priceCurrency": "EUR",
"availability": "https://schema.org/InStock"
}
}
</script>
Sono valori illustrativi, non un’offerta pubblicata né una scheda commerciale convalidata. L’esempio ridotto omette l’immagine, che il generatore segnala per revisione. Sostituisci tutti i dati immaginari e aggiungi un’immagine reale adatta quando esiste. Zero è ammesso per un’offerta davvero gratuita, non per sostituire un prezzo sconosciuto.
Recensioni e valutazioni aggregate non vengono generate. Non inventarle per rimuovere avvisi di un altro validatore. La guida Google agli snippet di prodotto distingue proprietà e requisiti delle offerte. Esperienze commerciali più ampie possono richiedere altre implementazioni oltre al modulo.
Costruisci il percorso di navigazione nell’ordine corretto
La modalità Breadcrumb crea un percorso da due a dieci elementi. Inserisci i nomi in un ordine sensato nella gerarchia del sito. Ogni elemento necessita di un nome; tutti tranne l’ultimo richiedono un URL completo. Il generatore assegna posizioni da uno e mostra un’anteprima, ma non scopre la struttura del sito.
Per una pagina immaginaria di controllo dell’equipaggiamento, potresti inserire:
| Posizione | Nome | URL |
|---|---|---|
| 1 | Guide | https://example.com/guides/ |
| 2 | Escursionismo | https://example.com/guides/hiking/ |
| 3 | Lista per lo zaino giornaliero | Facoltativo per questo ultimo elemento |
La documentazione Breadcrumb di Google consente di omettere l’URL finale, usando quello della pagina che contiene il markup. Installa questo percorso sulla pagina della lista, non su ogni pagina con gli stessi valori finali.
L’anteprima non aggiunge navigazione visibile al sito. Mantieni coerenza con la gerarchia reale e verifica i link del percorso visualizzati separatamente. Non presumere che il codice generato garantisca la stessa presentazione su ogni dispositivo.
Copia e installa JSON-LD nella pagina corretta
Copia script fornisce l’elemento HTML completo con il contenuto JSON-LD. Il download fornisce schema.json, contenente solo l’oggetto JSON senza involucro HTML. Servono a metodi diversi: un campo CMS che richiede JSON puro vuole i dati; un template HTML può accettare lo script completo.
L’introduzione di Google ai dati strutturati descrive JSON-LD dentro un elemento script in head o body. Usa template, campo o plugin appropriato al sito. Incollare codice in un normale editor di paragrafi può mostrarlo come testo o eliminarlo invece di installarlo.
Prima di aggiungere un blocco, controlla ciò che CMS o tema già producono. Article e BreadcrumbList possono descrivere aspetti diversi della stessa pagina. Il problema sono descrizioni contraddittorie dello stesso articolo, prodotto o percorso. Aggiorna l’implementazione responsabile invece di lasciare prezzo o autore vecchi accanto a una versione nuova incompatibile.
Il generatore serializza i valori in modo sicuro per il proprio script, ma non può confermare cosa pubblicherà il CMS. Salva la pagina, ispeziona l’output servito e verifica che i valori previsti siano presenti. Copiare o scaricare, da solo, non modifica il sito.
Convalida separatamente codice, fatti e idoneità
Controlla il risultato installato per livelli:
- Verifica che il JSON sia analizzabile e che lo script compaia sulla pagina prevista.
- Esamina tipi e proprietà dichiarati, compresi gli oggetti annidati.
- Confronta nomi, prezzi, date, immagini e navigazione con la pagina reale.
- Consulta i requisiti attuali della funzione di ricerca desiderata.
Structured Data Checker ispeziona JSON-LD installato, errori di parsing, entità e alcune proprietà. La copertura è limitata. Oggetti Person o Offer annidati, oppure sottotipi di articolo, possono risultare non supportati o parziali perché fuori da quei controlli. Questo stato da solo non rende invalida la struttura. Leggi i risultati specifici e usa una convalida più ampia quando necessario.
Usa il Rich Results Test per le funzioni Google supportate. Un’informazione consigliata mancante richiede revisione, non voti, immagini o date inventate. La sintassi corretta non dimostra neppure che una persona reale abbia scritto l’articolo o che l’offerta sia ancora disponibile.
Le linee guida generali di Google richiedono fatti pertinenti, corretti e aggiornati, oltre alle regole applicabili. Anche un markup corretto non garantisce un risultato avanzato. Il conteggio delle proprietà misura la dimensione dell’output, non la completezza o un punteggio SEO.
Mantieni il markup sincronizzato con i cambiamenti
Rigenera o aggiorna il template quando cambiano prezzo, scorte, autore, una data significativa o la gerarchia. Pubblica insieme fatti visibili e markup, poi ricontrolla la pagina. Il generatore non monitora modifiche successive e non aggiorna automaticamente installazioni esistenti.
Nelle pagine tradotte usa titolo, descrizione e nomi del percorso nella lingua corrispondente, con gli URL corretti e le offerte reali di quella versione. Conserva nomi tecnici come headline e priceCurrency. Cambiare lingua dell’interfaccia non traduce gli input né crea pagine localizzate.
Conserva dati controllati e punto di installazione nelle tue note di pubblicazione. L’aggiornamento successivo diventa così una modifica concreta a una fonte nota, non un altro script isolato che può divergere dal contenuto.