Vai al contenuto
SilktideAiuto

Validità dei dati strutturati

Quando una pagina include dati leggibili dalle macchine che ne descrivono i contenuti ai motori di ricerca, tali dati devono essere validi per risultare utili. Silktide controlla che il markup venga analizzato correttamente, dichiari il tipo di elemento descritto e includa le proprietà richieste da quel tipo.

I sono solitamente scritti in , utilizzando il vocabolario schema.org:

<!-- Valido: viene analizzato correttamente, contiene un @type e include il titolo obbligatorio -->
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "Come conservare il vino"
}
</script>

Perché è importante

I motori di ricerca ignorano silenziosamente i dati strutturati non validi. JSON non valido, un blocco che non dichiara mai cosa descrive o un tipo a cui mancano le proprietà essenziali fanno sì che il markup venga ignorato: perdi i risultati avanzati (valutazioni a stelle, schede degli articoli, dettagli dei prodotti) che il markup avrebbe dovuto generare e nulla nella pagina ti segnala che è successo.

I dati strutturati non validi sono probabilmente peggio della loro assenza: il lavoro è stato fatto e la pagina sembra coperta, ma non produce alcun risultato.

Come risolvere il problema

  1. JSON non valido - correggi la sintassi. Le cause più comuni sono le virgole finali, le virgolette non precedute da escape all'interno del testo e i segnaposto dei modelli che non sono mai stati sostituiti.
  2. Nessun @type - aggiungine uno a ogni entità, utilizzando un tipo riconosciuto da schema.org come Article, Product o Event.
  3. Proprietà obbligatorie mancanti - aggiungi ciò che richiede il tipo: ad esempio, un Article richiede un headline, un Product richiede un name, mentre un Event richiede un name e startDate.
  4. Convalida il risultato con il Rich Results Test di Google o con il validatore di schema.org prima della pubblicazione.

Come Silktide esegue il controllo

  1. Controlla solo le pagine idonee all'indicizzazione nei motori di ricerca.
  2. Raccoglie ogni blocco JSON-LD presente nella pagina. Le pagine che non ne contengono alcuno vengono ignorate: la verifica dell'eventuale presenza di dati strutturati viene eseguita separatamente da Dati strutturati.
  3. Segnala al massimo un risultato per pagina, iniziando da quello più grave:
    • Un blocco che non contiene JSON valido.
    • Un blocco che non contiene @type.
    • Un tipo riconosciuto a cui manca una proprietà obbligatoria. Silktide verifica gli elementi essenziali dei tipi più comuni, tra cui Article (headline), Product, Organization, Person, LocalBusiness (name), Recipe (name e ingredients), Event (name e data di inizio), FAQPage (domande) e BreadcrumbList (elementi).

Risoluzione dei problemi

Il mio markup supera il test di Google, ma Silktide lo segnala

Silktide convalida gli elementi essenziali obbligatori dei tipi più comuni anziché l'intero vocabolario di schema.org; inoltre, le entità annidate vengono convalidate singolarmente. Ad esempio, una Person annidata come autore deve comunque avere un name. Controlla l'entità specifica indicata nel risultato.

Uso microdati o RDFa invece di JSON-LD

Questo controllo legge solo JSON-LD, il formato consigliato da Google. I dati strutturati in altri formati non vengono convalidati qui.

Per saperne di più

Ultimo aggiornamento

Questa pagina è stata utile?

Validità dei dati strutturati | Guida di Silktide