Dati strutturati per organizzazioni (Organization
)
Puoi utilizzare i dati strutturati per organizzazioni per comunicare a Google i dettagli amministrativi della tua organizzazione, ad esempio logo, indirizzo, dati di contatto e identificatori aziendali. Google può usare questo markup nelle schede informative e in altri elementi visivi (come l'attribuzione), che aiuta gli utenti a trovare i dettagli della tua organizzazione nella Ricerca Google.
How to add structured data
Structured data is a standardized format for providing information about a page and classifying the page content. If you're new to structured data, you can learn more about how structured data works.
Here's an overview of how to build, test, and release structured data.
- Add as many recommended properties that apply to your web page. There are no required properties; instead, add the properties that apply to your content. Based on the format you're using, learn where to insert structured data on the page.
- Follow the guidelines.
- Validate your code using the Rich Results Test and fix any critical errors. Consider also fixing any non-critical issues that may be flagged in the tool, as they can help improve the quality of your structured data (however, this isn't necessary to be eligible for rich results).
- Deploy a few pages that include your structured data and use the URL Inspection tool to test how Google sees the page. Be sure that your page is
accessible to Google and not blocked by a robots.txt file, the
noindex
tag, or login requirements. If the page looks okay, you can ask Google to recrawl your URLs. - To keep Google informed of future changes, we recommend that you submit a sitemap. You can automate this with the Search Console Sitemap API.
Esempi
Organization
Ecco un esempio di informazioni sull'organizzazione in codice JSON-LD.
<html> <head> <title>About Us</title> <script type="application/ld+json"> { "@context": "https://schema.org", "@type": "Organization", "image": "https://www.example.com/example_image.jpg", "url": "https://www.example.com", "sameAs": ["https://example.net/profile/example1234", "https://example.org/example1234"], "logo": "https://www.example.com/images/logo.png", "name": "Example Corporation", "description": "The example corporation is well-known for producing high-quality widgets", "email": "contact@example.com", "telephone": "+47-99-999-9999", "address": { "@type": "PostalAddress", "streetAddress": "Rue Improbable 99", "addressLocality": "Paris", "addressCountry": "FR", "addressRegion": "Ile-de-France", "postalCode": "75001" }, "vatID": "FR12345678901", "iso6523Code": "0199:724500PMK2A2M1SQQ228" } </script> </head> <body> </body> </html>
OnlineStore
con norme sui resi (esempio di sottotipo di Organization
)
Ecco un esempio di informazioni di negozi online in codice JSON-LD.
<html> <head> <title>About Us</title> <script type="application/ld+json"> { "@context": "https://schema.org", "@type": "OnlineStore", "name": "Example Online Store", "url": "https://www.example.com", "sameAs": ["https://example.net/profile/example12", "https://example.org/@example34"], "logo": "https://www.example.com/assets/images/logo.png", "contactPoint": { "contactType": "Customer Service", "email": "support@example.com", "telephone": "+47-99-999-9900" }, "vatID": "FR12345678901", "iso6523Code": "0199:724500PMK2A2M1SQQ228", "hasMerchantReturnPolicy": { "@type": "MerchantReturnPolicy", "applicableCountry": ["FR", "CH"], "returnPolicyCountry": "FR", "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow", "merchantReturnDays": 60, "returnMethod": "https://schema.org/ReturnByMail", "returnFees": "https://schema.org/FreeReturn", "refundType": "https://schema.org/FullRefund" } ... // Other Organization-level properties } </script> </head> <body> </body> </html>
Linee guida
Segui queste linee guida per far sì che i dati strutturati siano idonei per l'inclusione nei risultati della Ricerca Google.
Linee guida tecniche
Ti consigliamo di inserire queste informazioni nella tua home page o in una singola pagina che descrive la tua organizzazione, ad esempio Chi siamo. Non è necessario includerle in ogni pagina del sito.
Ti consigliamo di utilizzare il sottotipo schema.org Organization
più specifico
corrispondente alla tua organizzazione. Ad esempio, se hai un sito di e-commerce, ti consigliamo di utilizzare
il sottotipo OnlineStore
invece di
OnlineBusiness
Inoltre, se il tuo sito riguarda un'attività locale, ad esempio un ristorante o un negozio fisico, ti consigliamo di fornire i tuoi dati amministrativi utilizzando i sottotipi più specifici di LocalBusiness
e di rispettare i campi obbligatori e consigliati per le attività locali,
oltre a quelli consigliati in questa guida.
Definizioni dei tipi di dati strutturati
Google riconosce le seguenti proprietà di una
Organization
.
Per aiutare Google a comprendere meglio la tua pagina, includi il maggior numero possibile di proprietà consigliate applicabili
alla tua pagina web. Non ci sono proprietà obbligatorie; aggiungi quelle pertinenti per la tua organizzazione.
Proprietà consigliate | |
---|---|
address |
L'indirizzo (fisico o postale) della tua organizzazione, se applicabile. Includi tutte le proprietà applicabili al tuo paese; più ne fornisci, migliore sarà la qualità del risultato per gli utenti. Puoi fornire più indirizzi se hai una sede in più città, stati o paesi. Ad esempio: "address": [{ "@type": "PostalAddress", "streetAddress": "999 W Example St Suite 99 Unit 9", "addressLocality": "New York", "addressRegion": "NY", "postalCode": "10019", "addressCountry": "US" },{ "streetAddress": "999 Rue due exemple", "addressLocality": "Paris", "postalCode": "75001", "addressCountry": "FR" }] |
address.addressCountry |
Il paese associato all'indirizzo postale, utilizzando il codice paese ISO 3166-1 alpha-2 a due lettere. |
address.addressLocality |
La città del tuo indirizzo postale. |
address.addressRegion |
La regione del tuo indirizzo postale, se applicabile. Ad esempio, uno stato. |
address.postalCode |
Il codice postale del tuo indirizzo. |
address.streetAddress |
Il tuo indirizzo postale completo. |
alternateName |
Un altro nome comune utilizzato dalla tua organizzazione, se applicabile. |
contactPoint |
Il modo migliore che un utente ha per contattare la tua attività, se applicabile. Includi tutti i metodi di assistenza disponibili per gli utenti seguendo le best practice consigliate da Google. Ad esempio: "contactPoint": { "@type": "ContactPoint", "telephone": "+9-999-999-9999", "email": "contact@example.com" } |
contactPoint.email |
L'indirizzo email per contattare la tua attività, se applicabile.
Se utilizzi un tipo |
contactPoint.telephone |
Il numero di telefono per contattare la tua attività, se applicabile.
Assicurati di includere il codice paese e il prefisso.
Se utilizzi un tipo |
description |
Una descrizione dettagliata dell'organizzazione, se applicabile. |
duns |
Il numero DUNS di Dun & Bradstreet per identificare la tua |
email
|
L'indirizzo email per contattare la tua attività, se applicabile. |
foundingDate |
La data di fondazione della tua |
globalLocationNumber |
Il Global Location Number GS1 che identifica la sede della tua |
hasMerchantReturnPolicy
|
Le norme sui resi utilizzate dalla tua |
iso6523Code
|
L'identificatore ISO 6523 della tua organizzazione, se applicabile.
La prima parte di un identificatore ISO 6523 è un
|
legalName |
Il nome legale registrato della tua |
leiCode |
L'identificatore per la tua |
logo |
Un logo rappresentativo della tua organizzazione, se applicabile. L'aggiunta di questa proprietà può aiutare Google a comprendere meglio quale logo vuoi mostrare, ad esempio nei risultati della Ricerca e nelle schede informative. Linee guida per le immagini:
Se utilizzi il tipo |
naics |
Il codice NAICS (North American Industry Classification System)
per la tua |
name |
Il nome della tua organizzazione. Utilizza lo stesso |
numberOfEmployees |
Il numero di dipendenti nella tua Esempio con un numero specifico di dipendenti: "numberOfEmployees": { "@type": "QuantitativeValue", "value": 2056 } Esempio con il numero di dipendenti compreso in un intervallo: "numberOfEmployees": { "@type": "QuantitativeValue", "minValue": 100, "maxValue": 999 } |
sameAs
|
URL di una pagina su un altro sito web con informazioni aggiuntive sulla tua organizzazione,
se applicabile. Ad esempio, un URL che rimanda alla pagina del profilo della tua organizzazione su un social media o un sito di recensioni. Puoi fornire più URL |
taxID
|
L'ID fiscale associato alla tua |
telephone
|
Un numero di telefono dell'attività destinato a essere il recapito principale per i clienti, se applicabile. Assicurati di includere il codice paese e il prefisso. |
url
|
L'URL del sito web della tua organizzazione, se applicabile. In questo modo Google può identificarla in modo univoco. |
vatID
|
Il codice di partita IVA (imposta sul valore aggiunto) associato alla tua |
MerchantReturnPolicy
Utilizza le seguenti proprietà per descrivere le norme generali sui resi per l'intera Organization
, se applicabile alla tua attività.
Se disponi di norme specifiche per singoli prodotti, utilizza il
markup della scheda del commerciante.
Proprietà obbligatorie (scegli l'opzione più adatta al tuo caso d'uso) | |
---|---|
Opzione A | |
applicableCountry |
Il codice paese al quale si applicano le norme sui resi, utilizzando il formato del codice paese ISO 3166-1 alpha-2 a due lettere. Puoi specificare fino a 50 paesi. |
returnPolicyCategory |
Il tipo di norme sui resi. Usa uno dei seguenti valori:
Se usi |
returnPolicyCountry |
Il paese in cui deve essere spedito il prodotto per il reso. Può essere diverso dal paese in cui è stato originariamente spedito o inviato il prodotto. Il formato del codice paese è ISO 3166-1 alpha-2. Puoi specificare fino a 50 paesi. |
Opzione B | |
merchantReturnLink |
Specifica l'URL di una pagina web che descrive le norme sui resi. Possono essere le tue norme sui resi o le norme di terze parti di un servizio che gestisce i resi. |
Proprietà consigliate | |
---|---|
customerRemorseReturnFees |
Un tipo specifico di commissione sui resi se il prodotto viene restituito a causa del ripensamento del cliente.
Vedi |
customerRemorseReturnLabelSource |
Il metodo attraverso il quale il consumatore ottiene un'etichetta per la spedizione del reso di un prodotto.
Vedi |
customerRemorseReturnShippingFeesAmount |
Il costo della spedizione per la restituzione di un prodotto a causa del ripensamento del cliente. Questa proprietà
è obbligatoria solo se il consumatore deve pagare una tariffa di spedizione diversa da zero per restituire un prodotto.
Per ulteriori dettagli, consulta |
itemCondition |
Le condizioni alle quali è possibile restituire un articolo. Puoi specificare più condizioni accettate. Utilizza i seguenti valori:
|
itemDefectReturnFees |
Un tipo specifico di commissione sui resi per i prodotti difettosi. Vedi |
itemDefectReturnLabelSource |
Il metodo attraverso il quale il consumatore può ottenere un'etichetta per la spedizione del reso di un prodotto.
Vedi |
itemDefectReturnShippingFeesAmount |
Il costo di spedizione per la restituzione di un prodotto a causa di prodotti difettosi. Questa proprietà
è obbligatoria solo se il consumatore deve pagare una tariffa di spedizione diversa da zero per restituire un prodotto.
Per ulteriori dettagli, consulta |
merchantReturnDays |
Il numero di giorni (dalla data di consegna) entro cui è possibile restituire un prodotto. Questa
proprietà è obbligatoria solo se imposti |
refundType |
Il tipo di rimborso disponibile per il consumatore quando restituisce un prodotto.
|
returnFees |
Il tipo predefinito di commissione di reso. Utilizza uno dei seguenti valori supportati:
|
returnLabelSource |
Il metodo attraverso il quale il consumatore può ottenere un'etichetta per la spedizione del reso di un prodotto. Usa uno dei seguenti valori:
|
returnMethod |
Il tipo di metodo di reso offerto. Questa opzione è consigliata solo se
|
returnPolicySeasonalOverride |
Una variazione stagionale di una norma sui resi in caso di eventi speciali, come le festività.
Ad esempio, la categoria tipica delle norme sui resi è impostata su "returnPolicySeasonalOverride": { "@type": "MerchantReturnPolicySeasonalOverride", "startDate": "2024-11-29", "endDate": "2024-12-06", "merchantReturnDays": 10, "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow" } Per specificare più variazioni stagionali: In questo esempio, le normali norme sui resi sono illimitate, ma sono limitate durante i due intervalli di date seguenti: "returnPolicySeasonalOverride": [{ "@type": "MerchantReturnPolicySeasonalOverride", "startDate": "2024-11-29", "endDate": "2024-12-06", "merchantReturnDays": 10, "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow" }, { "@type": "MerchantReturnPolicySeasonalOverride", "startDate": "2024-12-26", "endDate": "2025-01-06", "merchantReturnDays": 10, "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow" }] |
returnPolicySeasonalOverride.endDate |
La data di fine della variazione stagionale. |
returnPolicySeasonalOverride.merchantReturnDays |
Il numero di giorni (dalla data di consegna) entro cui è possibile restituire un prodotto. Questa
proprietà è obbligatoria solo se imposti |
returnPolicySeasonalOverride.returnPolicyCategory |
Il tipo di norme sui resi. Usa uno dei seguenti valori:
Se usi |
returnPolicySeasonalOverride.startDate |
La data di inizio della variazione stagionale. |
returnShippingFeesAmount |
Il costo di spedizione per la restituzione di un prodotto. Questa proprietà è obbligatoria solo se il consumatore deve pagare al commerciante
una tariffa di spedizione diversa da zero per restituire un prodotto, nel qual caso |
Approccio alternativo alla configurazione delle impostazioni di spedizione con Google
Le norme sui resi dei rivenditori possono essere complesse e cambiare di frequente. Se hai problemi a indicare e a mantenere aggiornati i dettagli per i resi con il markup e hai un account Google Merchant Center, valuta la possibilità di configurare le tue norme sui resi nella guida di Google Merchant Center. In alternativa, puoi configurare norme sui resi a livello di account in Search Console, che vengono aggiunte automaticamente a Merchant Center.
Combinare più configurazioni di spedizione e reso
Se combini diverse configurazioni di spedizione e reso, tieni presente che puoi sovrascrivere le tue informazioni relative alle norme in base all'ordine di precedenza. Ad esempio, se fornisci sia il markup a livello di organizzazione sul tuo sito che le impostazioni delle norme sui resi in Search Console, Google utilizzerà soltanto le informazioni fornite in Search Console. Se invii un feed dei prodotti in Merchant Center e configuri le impostazioni di spedizione in Search Console, le tue informazioni del feed di Merchent Center sovrascrivono le impostazioni di Search Console.
Ecco cosa ha la precedenza per le informazioni relative alle norme su spedizione e resi (in ordine di efficacia, con i feed al primo posto):
- Feed inviati a Merchant Center a livello di prodotto
- API Content for Shopping (impostazioni per spedizioni o resi)
- Impostazioni in Merchant Center o Search Console
- Markup della scheda del commerciante a livello di prodotto
- Markup a livello di organizzazione
Risoluzione dei problemi
Se hai difficoltà con l'implementazione o il debug dei dati strutturati, ecco alcune risorse che potrebbero esserti utili.
- Se utilizzi un sistema di gestione dei contenuti (CMS) o un'altra persona si sta occupando del tuo sito, chiedile di aiutarti. Assicurati di inoltrarle gli eventuali messaggi di Search Console che illustrano il problema.
- Google non garantisce che le funzionalità che utilizzano dati strutturati vengano visualizzate nei risultati di ricerca. Per un elenco delle cause comuni per cui i tuoi contenuti potrebbero non essere mostrati da Google in un risultato avanzato consulta le linee guida generali sui dati strutturati.
- I tuoi dati strutturati potrebbero contenere un errore. Consulta l'elenco degli errori nei dati strutturati e il report sui dati strutturati non analizzabili.
- Se i dati strutturati della tua pagina sono interessati da un'azione manuale, i dati strutturati sulla pagina verranno ignorati (sebbene la pagina possa ancora essere visualizzata nei risultati della Ricerca Google). Per risolvere i problemi relativi ai dati strutturati, utilizza il report Azioni manuali.
- Consulta nuovamente le linee guida per verificare se i tuoi contenuti non sono conformi. Il problema può essere causato dall'utilizzo di contenuti di spam o di markup di spam. Tuttavia, il problema potrebbe non riguardare la sintassi e perciò non essere identificato dal Test dei risultati avanzati.
- Risolvi i problemi relativi a risultati avanzati mancanti o a un calo del numero totale di risultati avanzati.
- Lascia del tempo per le nuove operazioni di scansione e indicizzazione. Ricorda che possono passare diversi giorni dopo la pubblicazione di una pagina prima che Google la rilevi e la sottoponga a scansione. Per domande generali sulla scansione e sull'indicizzazione, consulta le Domande frequenti (FAQ) relative alla scansione e all'indicizzazione della Ricerca Google.
- Pubblica una domanda nel forum di Google Search Central.