Generatore di schema Organization

Dire alle macchine chi sei

Chi arriva sulla tua home page capisce chi sei in pochi secondi. Il logo è nell’angolo, l’indirizzo è nel footer, le icone social portano ai tuoi account. Un motore di ricerca deve ricavare tutto questo dall’impaginazione e dalle parole, e a volte sbaglia. Può scambiare il logo di un partner per il tuo, o attaccare al tuo nome il profilo di un omonimo.

I dati strutturati gli risparmiano le congetture. Aggiungi alla pagina un piccolo script, che i visitatori non vedono mai, con i fatti elencati in campi etichettati. Le etichette vengono da schema.org, un vocabolario comune mantenuto da Google, Microsoft, Yahoo e Yandex. Il formato è JSON-LD, cioè normale JSON con due chiavi riservate. @context indica il vocabolario e @type dice che tipo di cosa stai descrivendo.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "@id": "https://www.example.org/#organization",
  "name": "Riverside Community Center",
  "url": "https://www.example.org/",
  "logo": "https://www.example.org/logo.png",
  "sameAs": ["https://www.linkedin.com/company/riverside-cc"]
}
</script>

Cosa produce ogni parte del modulo

Tipo di organizzazione

Diventa @type. L’elenco contiene 7 tipi di organizzazione, 14 tipi di LocalBusiness e 2 luoghi. Se scegli un tipo di attività o un luogo ottieni anche la sezione degli orari di apertura, e il logo viene copiato in image, che i risultati locali si aspettano. Musei e luoghi di culto vengono scritti con due tipi, per esempio ["Museum", "Organization"], così campi come legalName restano validi.

Nomi

name è quello che usa la gente, legalName quello registrato, alternateName una sigla o un vecchio nome.

URL della home page

Compila url e costruisce anche @id, un identificativo permanente (il tuo indirizzo seguito da #organization) a cui possono rimandare gli altri dati strutturati del sito.

Profili

Ogni riga va in sameAs. È così che dici a un motore di ricerca che quella pagina Facebook, quella pagina LinkedIn o quella voce di Wikipedia parlano di te.

Indirizzo

Un oggetto PostalAddress. Viene scritto solo se c’è una via, una città o un codice postale.

Telefono

Salvato in formato internazionale. Con US o CA come paese, dieci cifre diventano +1-503-555-0123. Un numero scritto con + e prefisso internazionale viene mantenuto, con trattini tra i gruppi.

Orari

I giorni con gli stessi orari vengono uniti in un solo OpeningHoursSpecification. Due fasce orarie nello stesso giorno descrivono una chiusura a metà giornata.

Identificativo fiscale o numero di ente non profit

Scritto come taxID.

I campi lasciati vuoti restano fuori dal blocco.

L’elenco dei controlli sotto il codice

Un nome mancante è l’unica cosa che conta come errore. Tutto il resto è un avviso o una nota.

• URL e logo. Entrambi devono essere indirizzi https:// completi. Un indirizzo del logo che non finisce con un’estensione d’immagine riceve una nota. Un logo ospitato su un social network o su un servizio di condivisione file riceve un avviso, perché quei link scadono o respingono i crawler.
• Campi delle attività locali. Per i tipi di attività e di luogo, una via o una città mancante e un numero di telefono mancante sono avvisi. Gli orari mancanti ricevono solo una nota. Un giorno spuntato ma senza orari è un avviso.
• Formati. Un codice ZIP statunitense deve avere cinque cifre o essere uno ZIP+4. La data di fondazione deve essere un anno o YYYY-MM-DD. Ogni riga dei profili deve essere un URL completo. Un numero di telefono che non si riesce a convertire viene mantenuto esattamente come l’hai scritto.

Quando sparisce l’ultimo avviso, l’etichetta accanto al codice indica «Pronto da incollare».

Dove va il blocco

Incolla il blocco una volta sola, nella home page, in qualsiasi punto di <head> o <body>. I motori di ricerca leggono il JSON-LD in entrambi i posti.

• Siti scritti a mano o statici: incollalo nel template della home page prima di </head>.
• WordPress: guarda prima nel tuo plugin SEO. Yoast SEO, Rank Math e SEOPress generano già un blocco Organization dalle loro impostazioni, e due blocchi in concorrenza confondono più di quanto aiutino. Usa i loro campi, oppure disattiva il loro output e aggiungi il tuo con un plugin per il codice nell’header o con un blocco HTML personalizzato.
• Shopify, Squarespace, Wix, Webflow: ognuno ha un’impostazione «codice personalizzato» o «code injection» per l’head della home page.

Poi testa la pagina online con i due validatori linkati sotto il codice. Il Rich Results Test ti dice cosa è riuscito a leggere Google. Il validatore di schema.org controlla il vocabolario in sé.

Il blocco non si aggiorna da solo. Quando cambiano gli orari o il numero di telefono, torna qui, modifica la bozza e incolla la nuova versione al posto della vecchia.