Dati strutturati per organizzazioni (Organization)

Scheda informativa del commerciante nei risultati della Ricerca Google

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.

Come aggiungere dati strutturati

I dati strutturati sono un formato standardizzato per fornire informazioni su una pagina e classificarne i contenuti. Se non li hai mai utilizzati, scopri di più su come funzionano i dati strutturati.

Ecco una panoramica su come creare, testare e rilasciare i dati strutturati.

  1. Aggiungi tutte le proprietà consigliate che si applicano alla tua pagina web. Non ci sono proprietà obbligatorie; aggiungi quelle che si applicano ai tuoi contenuti. In base al formato che utilizzi, scopri dove inserire i dati strutturati nella pagina.
  2. Segui le linee guida.
  3. Convalida il codice utilizzando lo strumento di Test dei risultati avanzati e correggi eventuali errori critici. Prendi in considerazione anche la possibilità di correggere eventuali problemi non critici che potrebbero essere segnalati nello strumento, in quanto possono contribuire a migliorare la qualità dei tuoi dati strutturati (tuttavia, questo non è necessario per l'idoneità per i risultati avanzati).
  4. Implementa alcune pagine che includono dati strutturati e utilizza lo strumento Controllo URL per verificare come Google vede la pagina. Assicurati che la pagina sia accessibile per Google e che non venga bloccata da file robots.txt, tag noindex o requisiti di accesso. Se la pagina non presenta problemi, puoi chiedere a Google di ripetere la scansione degli URL.
  5. Per tenere Google informata delle future modifiche, ti consigliamo di inviare una Sitemap. Puoi automatizzare questa operazione con l'API Search Console Sitemap.

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 del negozio 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

PostalAddress

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

Text

Il paese associato all'indirizzo postale, utilizzando il codice paese ISO 3166-1 alpha-2 a due lettere.

address.addressLocality

Text

La città del tuo indirizzo postale.

address.addressRegion

Text

La regione del tuo indirizzo postale, se applicabile. Ad esempio, uno stato.

address.postalCode

Text

Il codice postale del tuo indirizzo.

address.streetAddress

Text

Il tuo indirizzo postale completo.

alternateName

Text

Un altro nome comune utilizzato dalla tua organizzazione, se applicabile.

contactPoint

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

Text

L'indirizzo email per contattare la tua attività, se applicabile. Se utilizzi un tipo LocalBusiness, specifica un indirizzo email principale a livello di LocalBusiness prima di utilizzare contactPoint per indicare più modi per contattare la tua organizzazione.

contactPoint.telephone

Text

Il numero di telefono per contattare la tua attività, se applicabile. Assicurati di includere il codice paese e il prefisso. Se utilizzi un tipo LocalBusiness, specifica un numero di telefono principale a livello LocalBusiness prima di utilizzare contactPoint per indicare più modi per contattare la tua organizzazione.

description

Text

Una descrizione dettagliata dell'organizzazione, se applicabile.

duns

Text

Il numero DUNS di Dun & Bradstreet per identificare la tua Organization, se applicabile. Consigliamo invece di utilizzare il campo iso6523Code con il prefisso 0060:.

email

Text

L'indirizzo email per contattare la tua attività, se applicabile.

foundingDate

Date

La data di fondazione della tua Organization nel formato di data ISO 8601, se applicabile.

globalLocationNumber

Text

Il Global Location Number GS1 che identifica la sede della tua Organization, se applicabile.

hasMerchantReturnPolicy

MerchantReturnPolicy

Le norme sui resi utilizzate dal tuo Organization, se applicabili. Se aggiungi questa proprietà, assicurati di includere anche i campi obbligatori e consigliati per MerchantReturnPolicy.

iso6523Code

Text

L'identificatore ISO 6523 della tua organizzazione, se applicabile. La prima parte di un identificatore ISO 6523 è un ICD (International Code Designator) che definisce lo schema di identificazione utilizzato. La seconda parte è l'identificatore effettivo; consigliamo di separare l'ICD e l'identificatore con i due punti (U+003A). I valori comuni dell'ICD includono:

  • 0060: sistema di numerazione universale dei dati Dun & Bradstreet (DUNS)
  • 0088: Global Location Number (GLN) GS1
  • 0199: identificatore LEI (Legal Entity Identifier)
legalName

Text

Il nome legale registrato della tua Organization, se applicabile e diverso dalla proprietà name.

leiCode

Text

L'identificatore per la tua Organization come definito nello standard ISO 17442, se applicabile. Consigliamo invece di utilizzare il campo iso6523Code con il prefisso 0199:.

logo

URL o ImageObject

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:

  • L'immagine deve essere almeno 112 x 112 px.
  • L'URL immagine deve poter essere sottoposto a scansione e indicizzato.
  • Il formato file immagine deve essere supportato da Google Immagini.
  • Assicurati che l'immagine abbia l'aspetto previsto su uno sfondo solo bianco (ad esempio, se il logo è principalmente bianco o grigio, potrebbe non avere l'aspetto desiderato quando mostrato su uno sfondo bianco).

Se utilizzi il tipo ImageObject, assicurati che abbia una proprietà contentUrl o url valida che segua le stesse linee guida di un tipo URL.

naics

Text

Il codice NAICS (North American Industry Classification System) per la tua Organization, se applicabile.

name

Text

Il nome della tua organizzazione. Utilizza lo stesso name e alternateName che usi per il nome del sito.

numberOfEmployees

QuantitativeValue

Il numero di dipendenti nella tua Organization, se applicabile.

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

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 sameAs.

taxID

Text

L'ID fiscale associato alla tua Organization, se applicabile. Assicurati che taxID corrisponda al paese specificato nel campo address.

telephone

Text

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

URL

L'URL del sito web della tua organizzazione, se applicabile. In questo modo Google può identificarla in modo univoco.

vatID

Text

Il codice di partita IVA (imposta sul valore aggiunto) associato alla tua Organization, se applicabile al tuo paese e alla tua attività. Questo è un importante indicatore di fiducia per gli utenti (ad esempio, possono cercare la tua attività nei registri pubblici per partite IVA).

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

Text

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

MerchantReturnEnumeration

Il tipo di norme sui resi. Usa uno dei seguenti valori:

  • https://schema.org/MerchantReturnFiniteReturnWindow: è previsto un numero di giorni prestabilito per restituire un prodotto.
  • https://schema.org/MerchantReturnNotPermitted: i resi non sono consentiti.
  • https://schema.org/MerchantReturnUnlimitedWindow: non sono previsti limiti di tempo per restituire un prodotto.

Se usi MerchantReturnFiniteReturnWindow, la proprietà merchantReturnDays è obbligatoria.

returnPolicyCountry

Text

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
Proprietà consigliate
customerRemorseReturnFees

ReturnFeesEnumeration

Un tipo specifico di commissione sui resi se il prodotto viene restituito a causa del ripensamento del cliente. Vedi returnFees per i possibili valori.

customerRemorseReturnLabelSource

ReturnLabelSourceEnumeration

Il metodo attraverso il quale il consumatore ottiene un'etichetta per la spedizione del reso di un prodotto. Vedi returnLabelSource per i possibili valori.

customerRemorseReturnShippingFeesAmount

MonetaryAmount

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 returnShippingFeesAmount.

itemCondition

OfferItemCondition

Le condizioni alle quali è possibile restituire un articolo. Puoi specificare più condizioni accettate. Utilizza i seguenti valori:

  • https://schema.org/DamagedCondition: sono accettati gli articoli danneggiati.
  • https://schema.org/NewCondition: sono accettati gli articoli nuovi.
  • https://schema.org/RefurbishedCondition: sono accettati gli articoli ricondizionati.
  • https://schema.org/UsedCondition: sono accettati gli articoli usati.
itemDefectReturnFees

ReturnFeesEnumeration

Un tipo specifico di commissione sui resi per i prodotti difettosi. Vedi returnFees per i possibili valori.

itemDefectReturnLabelSource

ReturnLabelSourceEnumeration

Il metodo attraverso il quale il consumatore può ottenere un'etichetta per la spedizione del reso di un prodotto. Vedi returnLabelSource per i possibili valori.

itemDefectReturnShippingFeesAmount

MonetaryAmount

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 returnShippingFeesAmount.

merchantReturnDays

Integer o Date o DateTime

Il numero di giorni (dalla data di consegna) entro cui è possibile restituire un prodotto. Questa proprietà è obbligatoria solo se imposti returnPolicyCategory su MerchantReturnFiniteReturnWindow.

refundType

RefundType

Il tipo di rimborso disponibile per il consumatore quando restituisce un prodotto.

  • https://schema.org/ExchangeRefund: l'articolo può essere sostituito con lo stesso prodotto.
  • https://schema.org/FullRefund: è possibile rimborsare l'intero importo dell'articolo.
  • https://schema.org/StoreCreditRefund: è possibile rimborsare l'articolo sotto forma di buono acquisto.
returnFees

ReturnFeesEnumeration

Il tipo predefinito di commissione di reso. Utilizza uno dei seguenti valori supportati:

  • https://schema.org/FreeReturn: non è previsto alcun costo a carico del consumatore per la restituzione del prodotto. Se utilizzata, non includere la proprietà returnShippingFeesAmount.
  • https://schema.org/ReturnFeesCustomerResponsibility: il consumatore stesso deve occuparsi della spedizione del reso e pagarla. Se utilizzata, non includere la proprietà returnShippingFeesAmount.
  • https://schema.org/ReturnShippingFees: è prevista una tariffa di spedizione addebitata dal commerciante al consumatore per restituire il prodotto. Specifica la tariffa di spedizione (diversa da zero) utilizzando la proprietà returnShippingFeesAmount.
returnLabelSource

ReturnLabelSourceEnumeration

Il metodo attraverso il quale il consumatore può ottenere un'etichetta per la spedizione del reso di un prodotto. Usa uno dei seguenti valori:

  • https://schema.org/ReturnLabelCustomerResponsibility: è responsabilità del consumatore creare un'etichetta di reso.
  • https://schema.org/ReturnLabelDownloadAndPrint: l'etichetta di reso deve essere scaricata e stampata dal cliente.
  • https://schema.org/ReturnLabelInBox: l'etichetta di reso è stata inclusa al momento della spedizione originale del prodotto.
returnMethod

ReturnMethodEnumeration

Il tipo di metodo di reso offerto. Questa opzione è consigliata solo se returnPolicyCategory è diversa da MerchantReturnNotPermitted. Utilizza uno o più dei seguenti valori:

  • https://schema.org/ReturnAtKiosk: l'articolo può essere restituito presso un infopoint.
  • https://schema.org/ReturnByMail: l'articolo può essere restituito per posta.
  • https://schema.org/ReturnInStore: l'articolo può essere restituito in negozio.
returnPolicySeasonalOverride

MerchantReturnPolicySeasonalOverride

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 MerchantReturnPolicyUnlimitedWindow, ma il periodo di reso dovrebbe essere limitato durante i saldi del Black Friday:

"returnPolicySeasonalOverride": {
"@type": "MerchantReturnPolicySeasonalOverride",
"startDate": "2024-11-29",
"endDate": "2024-12-06",
"merchantReturnDays": "10"
"returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow"
}
returnPolicySeasonalOverride.endDate

Date oppure DateTime

La data di fine della variazione stagionale.

returnPolicySeasonalOverride.merchantReturnDays

Integer o Date o DateTime

Il numero di giorni (dalla data di consegna) entro cui è possibile restituire un prodotto. Questa proprietà è obbligatoria solo se imposti returnPolicyCategory su MerchantReturnFiniteReturnWindow.

returnPolicySeasonalOverride.returnPolicyCategory

MerchantReturnEnumeration

Il tipo di norme sui resi. Usa uno dei seguenti valori:

  • https://schema.org/MerchantReturnFiniteReturnWindow: è previsto un numero di giorni prestabilito per restituire un prodotto.
  • https://schema.org/MerchantReturnNotPermitted: i resi non sono consentiti.
  • https://schema.org/MerchantReturnUnlimitedWindow: non sono previsti limiti di tempo per restituire un prodotto.

Se usi MerchantReturnFiniteReturnWindow, la proprietà merchantReturnDays è obbligatoria.

returnPolicySeasonalOverride.startDate

Date oppure DateTime

La data di inizio della variazione stagionale.

returnShippingFeesAmount

MonetaryAmount

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 returnFees deve essere impostato su https://schema.org/ReturnShippingFees). Se il reso è gratuito, returnFees va impostato su https://schema.org/FreeReturn. Se il consumatore deve gestire e pagare il costo di spedizione per il reso, returnFees deve essere impostata su https://schema.org/ReturnFeesCustomerResponsibility.

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.

Risoluzione dei problemi

Se hai difficoltà con l'implementazione o il debug dei dati strutturati, ecco alcune risorse che potrebbero esserti utili.