Dati strutturati per organizzazioni (`Organization`)

Scheda informativa del commerciante nei risultati della Ricerca Google

L'aggiunta di dati strutturati per l'organizzazione alla home page può aiutare Google a comprendere meglio i dettagli amministrativi della tua organizzazione e di distinguerla nei risultati di ricerca. Alcune proprietà vengono utilizzate dietro le quinte per distinguere la tua organizzazione da altre (ad esempio iso6523 e naics), mentre altre possono influenzare gli elementi visivi nei risultati della Ricerca (ad esempio quale logo viene mostrato nei risultati della Ricerca e nella tua scheda informativa). Se sei un commerciante, puoi influire su più dettagli nella tua scheda informativa del commerciante e nel tuo profilo del brand, come le norme sui resi, l'indirizzo e i dati di contatto. Non ci sono proprietà obbligatorie; ti consigliamo invece di aggiungere tutte le proprietà pertinenti per la tua organizzazione.

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.

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.
Utilizzi un CMS? Potrebbe essere più facile utilizzare un plug-in integrato nel CMS.
Utilizzi JavaScript? Scopri come generare dati strutturati con JavaScript.
Segui le linee guida.
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).
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.
Nota: la ripetizione della scansione e dell'indicizzazione non è immediata. Ricorda che potrebbero passare diversi giorni dopo la pubblicazione di una pagina prima che Google la rilevi e la sottoponga a scansione.
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",
      "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` (sottotipo di `Organization`) con norme sui resi

Ecco un esempio di negozio online con norme sui resi in codice JSON-LD.

Per ulteriori esempi e informazioni dettagliate sulle norme sui resi standard a livello di commerciante, consulta la documentazione separata sul markup delle norme sui resi del commerciante.

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

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

`OnlineStore` (sottotipo di `Organization`) con un programma fedeltà

Ecco un esempio di negozio online con un programma fedeltà e due livelli di adesione in codice JSON-LD.

Per informazioni dettagliate sui programmi per membri, consulta la documentazione relativa ai programmi fedeltà.

<html>
  <head>
    <title>About Us</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "OnlineStore",
      "hasMemberProgram": {
        "@type": "MemberProgram",
        "name": "Membership Plus",
        "description": "For frequent shoppers this is our top-rated loyalty program",
        "url": "https://www.example.com/membership-plus",
        "hasTiers": [
          {
            "@type": "MemberProgramTier",
            "@id": "#plus-tier-silver",
            "name": "silver",
            "url": "https://www.example.com/membership-plus-silver",
            "hasTierBenefit": [
              "https://schema.org/TierBenefitLoyaltyPoints"
            ],
            "membershipPointsEarned": 5
          },
          {
            "@type": "MemberProgramTier",
            "@id": "#plus-tier-gold",
            "name": "gold",
            "url": "https://www.example.com/membership-plus-gold",
            "hasTierRequirement":
            {
              "@type": "CreditCard",
              "name": "Example platinum card plus"
            },
            "hasTierBenefit": [
              "https://schema.org/TierBenefitLoyaltyPrice",
              "https://schema.org/TierBenefitLoyaltyPoints"
            ],
            "membershipPointsEarned": 10
          }
        ]
      }
      // Other Organization-level properties
      // ...
    }
    </script>
  </head>
  <body>
  </body>
</html>

<html>
  <head>
    <title>About Us</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "OnlineStore",
      "hasMemberProgram": {
        "@type": "MemberProgram",
        "name": "Membership Plus",
        "description": "For frequent shoppers this is our top-rated loyalty program",
        "url": "https://www.example.com/membership-plus",
        "hasTiers": [
          {
            "@type": "MemberProgramTier",
            "@id": "#plus-tier-silver",
            "name": "silver",
            "url": "https://www.example.com/membership-plus-silver",
            "hasTierBenefit": [
              "https://schema.org/TierBenefitLoyaltyPoints"
            ],
            "membershipPointsEarned": 5
          },
          {
            "@type": "MemberProgramTier",
            "@id": "#plus-tier-gold",
            "name": "gold",
            "url": "https://www.example.com/membership-plus-gold",
            "hasTierRequirement":
            {
              "@type": "CreditCard",
              "name": "Example platinum card plus"
            },
            "hasTierBenefit": [
              "https://schema.org/TierBenefitLoyaltyPrice",
              "https://schema.org/TierBenefitLoyaltyPoints"
            ],
            "membershipPointsEarned": 10
          }
        ]
      }
      // 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.

Ti consigliamo di concentrarti sulle proprietà utili per gli utenti, come name o alternateName per il nome della tua attività, nonché un'indicazione della presenza fisica (ad esempio address o telephone) e della presenza online (ad esempio url o logo).

Proprietà consigliate
`address`	`PostalAddress` Questa è una proprietà obbligatoria se utilizzi `LocalBusiness` o uno dei suoi sottotipi. 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 con cui viene chiamata la 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` ripetuto Le norme sui resi della tua `Organization`, se applicabili. Consulta Markup delle norme sui resi del commerciante per informazioni dettagliate sulle proprietà obbligatorie e facoltative per `MerchantReturnPolicy`. Se non fornisci norme sui resi per la tua `Organization` o se alcuni dei tuoi prodotti hanno norme sui resi specifiche per le quali devi sostituire le norme sui resi definite per la tua `Organization`, utilizza questa proprietà anche nel markup della scheda del commerciante.
`hasMemberProgram`	`MemberProgram` ripetuto Un programma fedeltà per membri che offri, se applicabile. Consulta la sezione Markup dei programmi per membri per informazioni dettagliate sulle proprietà obbligatorie e facoltative per `MemberProgram`.
`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 che rappresenta l'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).

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.