Dati strutturati per eventi (Event)

La possibilità di pubblicazione su Google facilita agli utenti la scoperta degli eventi e la partecipazione tramite i risultati della Ricerca Google e altri prodotti Google, come Google Maps. Questa funzionalità offre numerosi vantaggi:

  • Più risultati interattivi: i tuoi eventi possono essere mostrati tramite questa funzionalità su Google, insieme a logo, descrizione e altro ancora.
  • Maggiori possibilità di scoperta e di conversione: gli utenti hanno un nuovo modo di interagire con gli eventi che pubblichi e di fare clic per raggiungere il tuo sito. Scopri come Eventbrite ha registrato un aumento del 100% nella crescita tipica del traffico anno su anno dalla Ricerca Google.
Esempio di eventi nei risultati di ricerca

Esistono tre opzioni per rendere i tuoi eventi idonei alla pubblicazione su Google:

  • Se pubblichi i tuoi eventi usando un sito web di terze parti (ad esempio, pubblichi eventi su siti web che vendono biglietti o su piattaforme social), verifica se il publisher dei tuoi eventi sta già usufruendo della funzionalità di ricerca degli eventi su Google. Se il publisher dei tuoi eventi è integrato con Google, continua a pubblicarli sul sito web di terze parti. In questo caso, puoi smettere di leggere.
  • Se utilizzi un CMS (ad esempio, WordPress) e non hai accesso al codice HTML, verifica se il tuo CMS prevede un plug-in per l'aggiunta di dati strutturati al tuo sito. In alternativa, puoi utilizzare l'Evidenziatore di dati per comunicare a Google i tuoi eventi senza modificare il codice HTML del tuo sito.
  • Se hai familiarità con la modifica del codice HTML, utilizza i dati strutturati per l'integrazione diretta con Google. Dovrai modificare il codice HTML delle pagine degli eventi.

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. Per una guida passo per passo su come aggiungere dati strutturati a una pagina web, consulta il codelab sui dati strutturati.

  1. Aggiungi le proprietà obbligatorie. 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

Evento standard

Di seguito è riportato un esempio di evento standard Event in formato JSON-LD. Un evento standard si svolge solo in una località fisica e secondo la programmazione. Puoi anche utilizzare la sintassi Microdati o RDFa.

<html>
  <head>
    <title>The Adventures of Kira and Morrison</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "Event",
      "name": "The Adventures of Kira and Morrison",
      "startDate": "2025-07-21T19:00-05:00",
      "endDate": "2025-07-21T23:00-05:00",
      "eventAttendanceMode": "https://schema.org/OfflineEventAttendanceMode",
      "eventStatus": "https://schema.org/EventScheduled",
      "location": {
        "@type": "Place",
        "name": "Snickerpark Stadium",
        "address": {
          "@type": "PostalAddress",
          "streetAddress": "100 West Snickerpark Dr",
          "addressLocality": "Snickertown",
          "postalCode": "19019",
          "addressRegion": "PA",
          "addressCountry": "US"
        }
      },
      "image": [
        "https://example.com/photos/1x1/photo.jpg",
        "https://example.com/photos/4x3/photo.jpg",
        "https://example.com/photos/16x9/photo.jpg"
       ],
      "description": "The Adventures of Kira and Morrison is coming to Snickertown in a can't miss performance.",
      "offers": {
        "@type": "Offer",
        "url": "https://www.example.com/event_offer/12345_202403180430",
        "price": 30,
        "priceCurrency": "USD",
        "availability": "https://schema.org/InStock",
        "validFrom": "2024-05-21T12:00"
      },
      "performer": {
        "@type": "PerformingGroup",
        "name": "Kira and Morrison"
      },
      "organizer": {
        "@type": "Organization",
        "name": "Kira and Morrison Music",
        "url": "https://kiraandmorrisonmusic.com"
      }
    }
    </script>
  </head>
  <body>
  </body>
</html>

Evento online

Di seguito è riportato un esempio di evento online.

<html>
  <head>
    <title>The Adventures of Kira and Morrison</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "Event",
      "name": "The Adventures of Kira and Morrison",
      "startDate": "2025-07-21T19:00:00-05:00",
      "endDate": "2025-07-21T23:00-05:00",
      "eventStatus": "https://schema.org/EventScheduled",
      "eventAttendanceMode": "https://schema.org/OnlineEventAttendanceMode",
      "location": {
        "@type": "VirtualLocation",
        "url": "https://operaonline.stream5.com/"
        },
      "image": [
        "https://example.com/photos/1x1/photo.jpg",
        "https://example.com/photos/4x3/photo.jpg",
        "https://example.com/photos/16x9/photo.jpg"
       ],
      "description": "The Adventures of Kira and Morrison is coming to Snickertown in a can't miss performance.",
      "offers": {
        "@type": "Offer",
        "url": "https://www.example.com/event_offer/12345_202403180430",
        "price": 30,
        "priceCurrency": "USD",
        "availability": "https://schema.org/InStock",
        "validFrom": "2024-05-21T12:00"
      },
      "performer": {
        "@type": "PerformingGroup",
        "name": "Kira and Morrison"
      },
      "organizer": {
        "@type": "Organization",
        "name": "Kira and Morrison Music",
        "url": "https://kiraandmorrisonmusic.com"
      }
    }
    </script>
  </head>
  <body>
  </body>
</html>

Evento misto online e offline

Di seguito è riportato un esempio di evento che si svolge in parte online e in parte in un luogo fisico.

<html>
  <head>
    <title>The Adventures of Kira and Morrison</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "Event",
      "name": "The Adventures of Kira and Morrison",
      "startDate": "2025-07-21T19:00-05:00",
      "endDate": "2025-07-21T23:00-05:00",
      "eventAttendanceMode": "https://schema.org/MixedEventAttendanceMode",
      "eventStatus": "https://schema.org/EventScheduled",
      "location": [{
        "@type": "VirtualLocation",
        "url": "https://operaonline.stream5.com/"
      },
      {
        "@type": "Place",
        "name": "Snickerpark Stadium",
        "address": {
          "@type": "PostalAddress",
          "streetAddress": "100 West Snickerpark Dr",
          "addressLocality": "Snickertown",
          "postalCode": "19019",
          "addressRegion": "PA",
          "addressCountry": "US"
        }
      }],
      "image": [
        "https://example.com/photos/1x1/photo.jpg",
        "https://example.com/photos/4x3/photo.jpg",
        "https://example.com/photos/16x9/photo.jpg"
       ],
      "description": "The Adventures of Kira and Morrison is coming to Snickertown in a can't miss performance.",
      "offers": {
        "@type": "Offer",
        "url": "https://www.example.com/event_offer/12345_202403180430",
        "price": 30,
        "priceCurrency": "USD",
        "availability": "https://schema.org/InStock",
        "validFrom": "2024-05-21T12:00"
      },
      "performer": {
        "@type": "PerformingGroup",
        "name": "Kira and Morrison"
      },
      "organizer": {
        "@type": "Organization",
        "name": "Kira and Morrison Music",
        "url": "https://kiraandmorrisonmusic.com"
      }
    }
    </script>
  </head>
  <body>
  </body>
</html>

Evento con stato aggiornato

Esistono diversi modi per impostare lo stato di un evento. Di seguito sono riportati alcuni esempi comuni di eventi con stato aggiornato. Per ulteriori informazioni, fai riferimento alla proprietà eventStatus.

Annullato

Di seguito è riportato un esempio di evento che è stato annullato.


<html>
  <head>
    <title>The Adventures of Kira and Morrison</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "Event",
      "name": "The Adventures of Kira and Morrison",
      "startDate": "2025-07-21T19:00-05:00",
      "endDate": "2025-07-21T23:00-05:00",
      "eventStatus": "https://schema.org/EventCancelled",
      "eventAttendanceMode": "https://schema.org/OfflineEventAttendanceMode",
      "location": {
        "@type": "Place",
        "name": "Snickerpark Stadium",
        "address": {
          "@type": "PostalAddress",
          "streetAddress": "100 West Snickerpark Dr",
          "addressLocality": "Snickertown",
          "postalCode": "19019",
          "addressRegion": "PA",
          "addressCountry": "US"
        }
      },
      "image": [
        "https://example.com/photos/1x1/photo.jpg",
        "https://example.com/photos/4x3/photo.jpg",
        "https://example.com/photos/16x9/photo.jpg"
       ],
      "description": "The Adventures of Kira and Morrison is coming to Snickertown in a can't miss performance.",
      "offers": {
        "@type": "Offer",
        "url": "https://www.example.com/event_offer/12345_202403180430",
        "price": 30,
        "priceCurrency": "USD",
        "availability": "https://schema.org/InStock",
        "validFrom": "2024-05-21T12:00"
      },
      "performer": {
        "@type": "PerformingGroup",
        "name": "Kira and Morrison"
      },
      "organizer": {
        "@type": "Organization",
        "name": "Kira and Morrison Music",
        "url": "https://kiraandmorrisonmusic.com"
      }
    }
    </script>
  </head>
  <body>
  </body>
</html>

Ripianificato

Di seguito è riportato un esempio di evento che è stato ripianificato.


<html>
  <head>
    <title>The Adventures of Kira and Morrison</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "Event",
      "name": "The Adventures of Kira and Morrison",
      "startDate": "2025-07-21T19:00-05:00",
      "endDate": "2025-07-21T23:00-05:00",
      "eventStatus": "https://schema.org/EventRescheduled",
      "eventAttendanceMode": "https://schema.org/OfflineEventAttendanceMode",
      "previousStartDate": "2025-03-21T19:00-05:00",
      "location": {
        "@type": "Place",
        "name": "Snickerpark Stadium",
        "address": {
          "@type": "PostalAddress",
          "streetAddress": "100 West Snickerpark Dr",
          "addressLocality": "Snickertown",
          "postalCode": "19019",
          "addressRegion": "PA",
          "addressCountry": "US"
        }
      },
      "image": [
        "https://example.com/photos/1x1/photo.jpg",
        "https://example.com/photos/4x3/photo.jpg",
        "https://example.com/photos/16x9/photo.jpg"
       ],
      "description": "The Adventures of Kira and Morrison is coming to Snickertown in a can't miss performance.",
      "offers": {
        "@type": "Offer",
        "url": "https://www.example.com/event_offer/12345_202403180430",
        "price": 30,
        "priceCurrency": "USD",
        "availability": "https://schema.org/InStock",
        "validFrom": "2024-05-21T12:00"
      },
      "performer": {
        "@type": "PerformingGroup",
        "name": "Kira and Morrison"
      },
      "organizer": {
        "@type": "Organization",
        "name": "Kira and Morrison Music",
        "url": "https://kiraandmorrisonmusic.com"
      }
    }
    </script>
  </head>
  <body>
  </body>
</html>

Spostato online e ripianificato

Di seguito è riportato un esempio di evento che è stato ripianificato e spostato online.


<html>
  <head>
    <title>The Adventures of Kira and Morrison</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "Event",
      "name": "The Adventures of Kira and Morrison",
      "startDate": "2025-07-21T19:00-05:00",
      "endDate": "2025-07-21T23:00-05:00",
      "eventAttendanceMode": "https://schema.org/OnlineEventAttendanceMode",
      "eventStatus": [
        "https://schema.org/EventRescheduled",
        "https://schema.org/EventMovedOnline"
        ],
      "previousStartDate": "2025-03-21T19:00-05:00",
      "location": {
        "@type": "VirtualLocation",
        "url": "https://operaonline.stream5.com/"
      },
      "image": [
        "https://example.com/photos/1x1/photo.jpg",
        "https://example.com/photos/4x3/photo.jpg",
        "https://example.com/photos/16x9/photo.jpg"
       ],
      "description": "The Adventures of Kira and Morrison is coming to Snickertown in a can't miss performance.",
      "offers": {
        "@type": "Offer",
        "url": "https://www.example.com/event_offer/12345_202403180430",
        "price": 30,
        "priceCurrency": "USD",
        "availability": "https://schema.org/InStock",
        "validFrom": "2024-05-21T12:00-05:00"
      },
      "performer": {
        "@type": "PerformingGroup",
        "name": "Kira and Morrison"
      },
      "organizer": {
        "@type": "Organization",
        "name": "Kira and Morrison Music",
        "url": "https://kiraandmorrisonmusic.com"
      }
    }
    </script>
  </head>
  <body>
  </body>
</html>

Paesi e lingue in cui è disponibile la funzionalità

Siamo lieti di ampliare la disponibilità geografica della funzionalità di ricerca di eventi su Google. La funzionalità è disponibile nelle lingue e nelle regioni indicate di seguito.

Regione Lingue disponibili
Australia Inglese
Brasile Portoghese
Canada Inglese
Germania Tedesco
India Inglese
America Latina Spagnolo
Spagna Spagnolo
Regno Unito Inglese
Stati Uniti Inglese

Linee guida

Affinché il tuo sito sia idoneo per comparire nell'esperienza di ricerca di eventi su Google, devi rispettare queste linee guida.

Linee guida tecniche

  • La pagina di destinazione deve contenere elementi di dati strutturati di tipi di eventi su schema.org.
  • Ogni evento DEVE avere un URL univoco (una pagina foglia) e un markup su quell'URL.
  • La funzionalità per gli eventi su Google supporta solo le pagine dedicate a un singolo evento. Ti consigliamo di concentrarti sull'aggiunta del markup alle pagine di pubblicazione degli eventi anziché alle pagine che includono programmazioni o eventi multipli.

Norme relative ai contenuti

  • Per ogni evento devono essere indicati con precisione il nome, la data di inizio e la posizione.
  • Evita di contrassegnare come eventi delle attività che non lo sono:
    • Non promuovere come eventi prodotti o servizi che non lo sono, ad esempio "Pacchetto viaggio: San Diego/Los Angeles, 7 notti".
    • Non aggiungere sconti oppure opportunità di acquisto di breve durata come "Concerto: acquista subito i biglietti" o "Concerto: sconto del 50% fino a sabato".
    • Non contrassegnare come eventi gli orari di apertura, ad esempio: "Parco avventura aperto dalle 8:00 alle 17:00".
    • Non contrassegnare coupon o voucher come eventi, ad esempio: "5% di sconto sul primo ordine".
  • Contrassegna con il markup corretto gli eventi che durano più giorni:
    • Se le informazioni sull'evento o sui biglietti si riferiscono a un evento che dura più giorni, specifica le date di inizio e di fine dell'evento.
    • Se ci sono diverse esibizioni in diversi giorni, ognuna con biglietti individuali, aggiungi un elemento Event separato per ogni esibizione.

Linee guida per data e ora

Quando implementi le proprietà startDate, endDate e previousStartDate, segui queste linee guida per data e ora.

Come specificare i fusi orari

Specifica il fuso orario includendo la differenza espressa in UTC o GMT. Se l'evento inizia alle 19:00 del 5 settembre a New York, il valore di startDate sarà GMT/UTC-5 durante l'ora solare e GMT/UTC-4 durante l'ora legale. Durante l'ora solare, il valore di startDate corrisponde rispettivamente a "2019-09-05T19:00:00-05:00" o "2019-09-05T19:00:00-04:00". Se non viene fornito alcun fuso orario, Google utilizza quello della località dell'evento come specificato in location. Per gli eventi online, il fuso orario è obbligatorio, in quanto Google non può utilizzare dati sulla posizione per capire quando inizia l'evento.

Best practice

  • L'evento si svolge in un intervallo di date: se l'evento dura più giorni, indica sia la data di inizio sia quella di fine. Se non conosci l'orario, non inserirlo.

    Consigliato

    "startDate": "2019-07-01T10:00:00-05:00",
    "endDate": "2019-07-26T17:00:00-05:00"

    Consigliato

    "startDate": "2019-07-01",
    "endDate": "2019-07-26"

    Non consigliato

    "startDate": "2019-07-01T00:00:00+00:00",
    "endDate": "2019-07-26T23:59:59+00:00"
  • L'evento inizia a un'ora specifica: se l'evento inizia a un'ora specifica, ad esempio alle 17:00, utilizza 2019-07-20T17:00:00. Includi la differenza UTC appropriata (ad esempio, utilizza 2019-07-20T17:00:00-07:00 se l'evento è in California).
  • L'evento dura un giorno intero: se l'evento dura tutto il giorno, non indicare un'ora specifica per la data di inizio. Ad esempio, puoi utilizzare 2019-08-15 come startDate e come endDate per un evento che dura un giorno intero.
  • L'ora di inizio dell'evento non è nota: se non conosci l'orario di inizio, non indicare un'ora specifica. Ad esempio, puoi utilizzare 2019-08-15 come startDate e come endDate.

    Consigliato: "startDate": "2025-07-21"

    Non consigliato: "startDate": "2019-08-15T00:00:00+00:00"

    Non consigliato: "startDate": "2019-07-20T00:00:00"

Esempi di come Google interpreta le date

Di seguito sono riportati alcuni esempi di come Google interpreta la data e l'ora di inizio:

Interpretazioni di data e ora di inizio
2019-08-15T00:00:00+00:00 Google interpreta startTime come 2019-08-14T17:00:00-07:00 (se location è impostato per la California) o come 2019-08-15T09:00:00 (se location è impostato per la Corea).
2019-08-15T23:59:59+00:00 Questo non significa la fine di 2019-08-15, a meno che l'evento si svolga nel fuso orario GMT. Google interpreta startTime come 2019-08-15T16:59:59-07:00 (se location è impostato per la California) o come 2019-08-16T08:59:59 (se location è impostato per la Corea).
2019-07-10 Questo significa che la data è indipendente dal fuso orario. Quando viene usato in startDate, significa che l'evento inizia nel luogo location a un'ora non specificata di quel giorno. Quando viene usato in endDate, significa che l'evento termina nel luogo location a un'ora non specificata di quel giorno.
2019-07-20T00:00:00 Questo corrisponde a mezzanotte del giorno 2019-07-20 nel fuso orario dell'evento. Probabilmente non sarà l'ora corretta, a meno che l'evento non inizi a mezzanotte.

Definizioni dei tipi di dati strutturati

La definizione completa di Event è disponibile all'indirizzo schema.org/Event.

Affinché i tuoi contenuti siano idonei per essere visualizzati nei risultati di ricerca estesi, devi includere le proprietà obbligatorie. Puoi anche includere le proprietà consigliate per aggiungere ulteriori informazioni sui tuoi contenuti, fornendo così un'esperienza utente migliore.

Proprietà obbligatorie
location

Place o VirtualLocation

Il luogo dell'evento. Esistono diversi requisiti, a seconda che l'evento si verifichi online o presso un luogo fisico:

  • Luogo fisico: se l'evento si svolge in un luogo fisico, imposta @type su Place. Aggiungi le proprietà location.address e location.name.
  • Evento online: se l'evento si svolge online, imposta @type su VirtualLocation. Aggiungi la proprietà location.url.
  • Misto (online e luogo fisico): se un evento si svolge sia online sia in un luogo fisico, includi le proprietà online e luogo fisico nidificate in un array nidificato. Ad esempio:
    "location": [{
      "@type": "VirtualLocation",
      "url": "https://operaonline.stream5.com/"
    },
    {
      "@type": "Place",
      "name": "Snickerpark Stadium",
      "address": {
        "@type": "PostalAddress",
        "streetAddress": "100 West Snickerpark Dr",
        "addressLocality": "Snickertown",
        "postalCode": "19019",
        "addressRegion": "PA",
        "addressCountry": "US"
      }
    }]
location.address

PostalAddress

L'indirizzo fisico preciso della sede dell'evento. Questa proprietà è obbligatoria solo per gli eventi che si svolgono in un luogo fisico.

Non consigliato: Sydney

Consigliato: Bennelong Point, Sydney NSW 2000, Australia

Esempio per gli Stati Uniti

"location": {
  "@type": "Place",
  "name": "Snickerpark Stadium",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "100 West Snickerpark Dr",
    "addressLocality": "Snickertown",
    "postalCode": "19019",
    "addressRegion": "PA",
    "addressCountry": "US"
  }
}

Esempi per il Giappone

Puoi scrivere gli indirizzi per il Giappone in diversi modi e Google riuscirà comunque a comprenderli. Ecco un esempio con la via, la località e il paese inseriti in diversi campi.

"location": {
  "@type": "Place",
  "name": "ダイバーシティ東京",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "江東区青海1-10",
    "addressLocality": "東京",
    "addressCountry": "日本"
  }
}

Ecco un esempio della via e del paese dell'indirizzo inseriti in diversi campi.

"location": {
  "@type": "Place",
  "name": "ダイバーシティ東京",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "東京都江東区青海1-10",
    "addressCountry": "日本"
  }
}

Ecco un esempio dell'intero indirizzo su una riga.

"location": {
  "@type": "Place",
  "name": "ダイバーシティ東京",
  "address": {
    "@type": "PostalAddress",
    "name": "東京都江東区青海 1-1-10 ダイバーシティ東京プラザ"
   }
}

Best practice per gli indirizzi:

  • Se l'evento si svolge in più strade, definisci la posizione iniziale e specifica tutti i dettagli nella descrizione.
  • Se l'evento non ha una posizione ben definita, utilizza il nome della città o il luogo più rappresentativo.
  • Se l'evento si svolge in più luoghi contemporaneamente, crea eventi diversi per ogni luogo.
location.url

URL

L'URL dell'evento online che le persone possono utilizzare per partecipare. Questa proprietà è obbligatoria se l'evento si svolge online. Se l'URL per partecipare all'evento non è disponibile fino al termine della registrazione, fornisci l'URL di registrazione tramite il quale le persone possono seguire i passaggi successivi per partecipare all'evento.

"location": {
  "@type": "VirtualLocation",
  "url": "https://operaonline.stream5.com/"
}
name

Text

Il titolo completo dell'evento.

Non consigliato: Bill Graham Civic Auditorium

Non consigliato: **PROMOZIONE VALIDA PER UN TEMPO LIMITATO - Concerto di Kesha e Macklemore a 25 €**

Consigliato: The Adventures of Kesha and Macklemore

Consigliato: Meet and Greet con Kesha e Macklemore

Best practice:

  • Non usare il tipo di evento come nome dell'evento. Ad esempio, "Concerto" non è un nome descrittivo per un evento.
  • Non includere informazioni non pertinenti come URL, prezzi o artisti. Usa invece le proprietà appropriate per tali valori.
  • Metti in evidenza un aspetto esclusivo dell'evento nel titolo. Questo aiuta gli utenti a prendere decisioni più rapide (ad esempio: "include domande e risposte con l'artista").
  • Non aggiungere promozioni a breve termine (ad esempio "acquista subito i biglietti").
startDate

DateTime

La data e l'ora di inizio dell'evento nel formato ISO-8601. Aggiungi la data e l'ora per aiutare gli utenti a trovare gli eventi adatti ai loro programmi. Per gli eventi online, devi specificare il fuso orario includendo la differenza rispetto a UTC o GMT.

"startDate": "2025-07-21T19:00"
Proprietà consigliate
description

Text

Descrizione dell'evento. Descrivi tutti i dettagli dell'evento per consentire agli utenti di comprendere e partecipare all'evento più facilmente.

Best practice:

  • Aggiungi una descrizione chiara e concisa dell'evento specifico.
  • Concentrati sui dettagli dell'evento e non sulle funzionalità del tuo sito.
  • Non ripetere altre informazioni quali data e luogo; aggiungi invece queste informazioni alle rispettive proprietà.
"description": "The Adventures of Kira and Morrison is coming to Snickertown in a can't miss performance."
endDate

DateTime

La data e l'ora di fine dell'evento nel formato ISO-8601. Utilizza lo stesso formato che hai usato per startDate. Aggiungi sia la data che l'ora per aiutare gli utenti a trovare gli eventi adatti ai loro programmi. Per gli eventi online, devi specificare il fuso orario includendo la differenza rispetto a UTC o GMT.

"endDate": "2025-07-21T23:00"
eventAttendanceMode

EventAttendanceModeEnumeration

Indica se l'evento si svolge online, offline in un luogo fisico oppure sia online sia offline. Se non includi questa proprietà, Google interpreta la modalità dell'evento come OfflineEventAttendanceMode, ovvero presume che l'evento si verificherà in un luogo fisico. Utilizza uno dei seguenti valori:

Di seguito è riportato un esempio di evento solo online:

{
"@context": "https://schema.org",
"@type": "Event",
"eventAttendanceMode": "https://schema.org/OnlineEventAttendanceMode",
"location": {
  "@type":"VirtualLocation",
  "url": "https://operaonline.stream5.com/"
  }
}

Di seguito è riportato un esempio di evento che si svolge in parte online e in parte offline:

{
"@context": "https://schema.org",
"@type": "Event",
"eventAttendanceMode": "https://schema.org/MixedEventAttendanceMode",
"location": {
  "@type": "VirtualLocation",
  "url": "https://operaonline.stream5.com/"
},
{
  "@type": "Place",
  "name": "Snickerpark Stadium",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "100 West Snickerpark Dr",
    "addressLocality": "Snickertown",
    "postalCode": "19019",
    "addressRegion": "PA",
    "addressCountry": "US"
    }
  }
}
eventStatus EventStatusType

Lo stato dell'evento. Se non utilizzi questo campo, Google considera eventStatus come EventScheduled. Di seguito sono riportati i valori supportati. Puoi utilizzare più stati, se applicabile (ad esempio, se un evento è stato ripianificato e spostato online).

EventCancelled

L'evento è stato annullato.

{
  "@context": "https://schema.org",
  "@type": "Event",
  "eventStatus": "https://schema.org/EventCancelled",
  "startDate": "2020-07-21T19:00"
}
EventMovedOnline

L'evento è stato modificato passando dalla partecipazione di persona a quella online.

{
  "@context": "https://schema.org",
  "@type": "Event",
  "eventStatus": "https://schema.org/EventMovedOnline",
  "eventAttendanceMode": "https://schema.org/OnlineEventAttendanceMode",
  "location": {
    "@type":"VirtualLocation",
    "url": "https://operaonline.stream5.com/"
  },
  "startDate": "2020-07-21T19:00"
}
EventPostponed

L'evento è stato posticipato a una data successiva, ma la nuova data non è ancora nota. Mantieni la data originale in startDate dell'evento fino a quando non saprai quando avrà luogo. Non appena vieni a conoscenza delle nuove informazioni sulla data, modifica eventStatus in EventRescheduled e aggiorna startDate e endDate con le nuove informazioni.

{
  "@context": "https://schema.org",
  "@type": "Event",
  "eventStatus": "https://schema.org/EventPostponed",
  "startDate": "2020-07-21T19:00"
}
EventRescheduled

L'evento è stato ripianificato in una data successiva. Aggiorna startDate e endDate con le nuove date. (Facoltativo) Puoi anche contrassegnare il campo eventStatus come ripianificato e aggiungere previousStartDate.

{
  "@context": "https://schema.org",
  "@type": "Event",
  "eventStatus": "https://schema.org/EventRescheduled",
  "startDate": "2020-07-21T19:00",
  "endDate": "2025-07-21T23:00",
  "previousStartDate": "2025-03-21T19:00"
}
EventScheduled

L'evento è pianificato. Questo valore è lo stato predefinito per gli eventi. Se non imposti eventStatus, Google presume che l'evento si svolgerà secondo la pianificazione.

{
  "@context": "https://schema.org",
  "@type": "Event",
  "eventStatus": "https://schema.org/EventScheduled",
  "startDate": "2020-07-21T19:00"
}
image

Proprietà ripetuta ImageObject o URL

URL di un'immagine o di un logo per l'evento o il tour. Un'immagine facilita la comprensione e il coinvolgimento rispetto all'evento. Ti consigliamo di scegliere immagini che abbiano una larghezza di 1920 px (la larghezza minima è 720 px).

Ulteriori linee guida per le immagini:

  • Ogni pagina deve contenere almeno un'immagine (indipendentemente dal fatto che includa markup o meno). Google sceglierà l'immagine migliore da mostrare nei risultati della Ricerca in base alle proporzioni e alla risoluzione.
  • Gli URL delle immagini devono poter essere sottoposti a scansione e indicizzazione. Per verificare se Google può accedere agli URL, utilizza lo strumento Controllo URL.
  • Le immagini devono rappresentare i contenuti con markup.
  • Le immagini devono essere in un formato file supportato da Google Immagini.
  • Per ottenere risultati ottimali, consigliamo di fornire più immagini ad alta risoluzione (minimo 50.000 pixel moltiplicando larghezza e altezza) con le seguenti proporzioni: 16 x 9, 4 x 3 e 1 x 1.

Ad esempio:

"image": [
  "https://example.com/photos/1x1/photo.jpg",
  "https://example.com/photos/4x3/photo.jpg",
  "https://example.com/photos/16x9/photo.jpg"
]
location.name

Text

Il nome dettagliato del luogo o della sede in cui si svolge l'evento. Questa proprietà è consigliata solo per gli eventi che si svolgono in un luogo fisico.

Non consigliato: San Francisco, CA

Consigliato: Bill Graham Civic Auditorium

Best practice:

  • Non includere un nome di città a meno che l'evento si svolga in tutta la città.
  • La proprietà location.name deve essere il nome della sede o del luogo, non una ripetizione del titolo dell'evento. Se non conosci il nome del luogo, non usare questa proprietà.
offers

Offer

Una proprietà Offer nidificata, una per ogni tipo di biglietto.
"offers": {
  "@type": "Offer"
}
offers.availability

Text

Uno dei seguenti elementi:

  • InStock: i biglietti per l'evento sono disponibili.
  • SoldOut: i biglietti per l'evento sono esauriti.
  • PreOrder: i biglietti per l'evento sono preordinabili.
"offers": {
  "@type": "Offer",
  "availability": "https://schema.org/InStock"
}
offers.price

Number

Il prezzo più basso disponibile per i biglietti, compresi i costi di servizio e le commissioni. Non dimenticare di aggiornare questo valore se i prezzi cambiano o i biglietti finiscono.

Se l'evento è disponibile senza costi, commissioni o oneri di servizio, imposta price su 0.

"offers": {
  "@type": "Offer",
  "price": "30"
}
offers.priceCurrency

Text

Il codice di valuta ISO 4217 di 3 lettere.

"offers": {
  "@type": "Offer",
  "priceCurrency": "USD"
}
offers.validFrom

DateTime

La data e l'ora in cui i biglietti saranno in vendita (richiesto solo per le offerte di durata limitata), in formato ISO-8601.

"offers": {
  "@type": "Offer",
  "validFrom": "2024-05-21T12:00"
}
offers.url

URL

L'URL di una pagina che offre la possibilità di acquistare i biglietti.

"offers": {
  "@type": "Offer",
  "url": "https://www.example.com/event_offer/12345_201803180430"
}

Questo URL deve soddisfare i seguenti requisiti:

  • Indirizzare a una pagina di destinazione che offre in modo chiaro e predominante l'opportunità di acquistare un biglietto che consente l'ammissione a quell'evento specifico a qualsiasi membro del pubblico.
  • Essere un link cliccabile dalla pagina web che contiene l'evento.
  • Poter essere sottoposto a scansione da parte di Googlebot (non bloccato dal file robots.txt).
organizer

Organization o Person

La persona o l'organizzazione che ospita l'evento. Questo valore è particolarmente importante per gli eventi online, per i quali non ci sono informazioni sulla sede dell'evento. Se includi organizer, ti invitiamo ad aggiungere le seguenti proprietà:

organizer.name

Text

Il nome della persona o dell'organizzazione che ospita l'evento.

organizer.url

URL

L'URL del dominio dell'host dell'evento.

performer

Person

I partecipanti che si esibiranno all'evento, ad esempio artisti e comici. Utilizza una proprietà PerformingGroup o Person nidificata, una per ogni artista.

"performer": {
  "@type": "PerformingGroup"
}
performer.name

Testo

Il nome del partecipante che si esibirà all'evento, ad esempio il nome dell'artista o del comico.

"performer": {
  "@type": "PerformingGroup",
  "name": "Kira and Morrison"
}
previousStartDate

DateTime

La data precedente di inizio dell'evento nel caso in cui sia stato ripianificato. Se aggiungi previousStartDate, devi aggiungere anche la proprietà eventStatus e impostare eventStatus su EventRescheduled. Non utilizzare altri stati di evento.

Per gli eventi online, devi specificare il fuso orario includendo la differenza rispetto a UTC o GMT.

Per gli eventi ripianificati, la proprietà startDate deve essere utilizzata solo per la nuova data di inizio. Nel caso (raro) di un evento posticipato e ripianificato più volte, questo campo può essere ripetuto.

{
"@context": "https://schema.org",
"@type": "Event",
"previousStartDate": ["2020-03-21T19:00-05:00", "2020-03-20T19:00-05:00", "2020-03-21T19:00-05:00"],
"eventStatus": "https://schema.org/EventRescheduled",
"startDate": "2020-07-21T19:00-05:00"
}

Monitorare i risultati avanzati con Search Console

Search Console è uno strumento che consente di monitorare il rendimento delle tue pagine in Ricerca Google. Registrarsi in Search Console non è obbligatorio per essere inclusi nei risultati di Ricerca Google, ma può aiutarti a capire e migliorare il modo in cui Google vede il tuo sito. Ti consigliamo di controllare Search Console nei seguenti casi:

  1. Dopo aver effettuato il deployment dei dati strutturati per la prima volta
  2. Dopo aver rilasciato nuovi modelli o aggiornato il codice
  3. Analisi periodica del traffico

Dopo aver effettuato il deployment dei dati strutturati per la prima volta

Dopo che Google ha indicizzato le tue pagine, cerca i problemi utilizzando il report sullo stato dei risultati avanzati pertinente. L'ideale sarebbe un aumento degli elementi validi e nessun aumento di quelli non validi. Se riscontri problemi nei dati strutturati:

  1. Correggi gli elementi non validi.
  2. Controlla un URL pubblicato per verificare se il problema persiste.
  3. Richiedi la convalida utilizzando il report sullo stato.

Dopo aver rilasciato nuovi modelli o aggiornato il codice

Quando apporti modifiche significative al tuo sito web, monitora l'aumento degli elementi non validi dei dati strutturati.
  • Se vedi un aumento di errori, forse hai reso disponibile un nuovo modello non funzionante oppure il tuo sito interagisce con il modello esistente in modo nuovo, ma non corretto.
  • Se noti una diminuzione degli elementi validi (non associata a un aumento di quelli non validi), forse non stai più incorporando dati strutturati nelle tue pagine. Utilizza lo strumento Controllo URL per scoprire la causa del problema.

Analisi periodica del traffico

Analizza il traffico di Ricerca Google utilizzando il rapporto sul rendimento. I dati mostrano la frequenza con cui la pagina viene visualizzata nei risultati multimediali nella Ricerca, la frequenza con cui gli utenti fanno clic e qual è la posizione media che visualizzi nei risultati di ricerca. Puoi anche estrarre automaticamente questi risultati con l'API Search Console.

Risoluzione dei problemi

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

Se l'evento non viene mostrato tramite la funzionalità per gli eventi su Google o è stata applicata un'azione manuale per markup strutturato contenente spam in Search Console, risolvi i problemi più frequenti e rivedi le nostre linee guida. Se i problemi persistono, consulta le Domande frequenti sugli eventi o pubblica un nuovo post nel forum di Google Search Central.

La sede dell'evento risulta mancante o è errata

Che cosa ha causato il problema: Google non comprende i valori forniti per le proprietà eventLocation, addressLocality o addressRegion. Google cerca di abbinare le informazioni sulla località a una posizione fisica e la località fornita risulta mancante o errata.

Risolvere il problema

  1. Assicurati che i dati strutturati includano i valori per eventLocation, addressLocality o addressRegion (a seconda del luogo, in quanto non tutte le proprietà relative alla posizione sono applicabili).
  2. Verifica che il campo location.name utilizzi il nome della località, oppure lascialo vuoto se non ha un nome. Un problema comune è rappresentato dall'inserimento involontario del nome dell'evento nel campo location.name.
  3. Convalida la correzione:
    1. Apri lo strumento di Test dei risultati avanzati.
    2. Inserisci l'URL di pubblicazione degli eventi nella casella Fetch URL (Recupera URL).
    3. Fai clic su Validate (Convalida).
    4. Fai clic su Preview (Anteprima).

      Success (Operazione riuscita): lo strumento di Test dei risultati avanzati mostra l'elemento eventLocation corretto nello strumento anteprima della Ricerca Google.

      Try again (Riprova): lo strumento di Test dei risultati avanzati mostra il testo "false" al posto della località dell'evento nello strumento anteprima della Ricerca Google. Assicurati che la località sia reale.

Il mio sito non viene visualizzato come opzione per l'acquisto dei biglietti

Che cosa ha causato il problema: la proprietà offers.url non è presente o non soddisfa i requisiti degli URL.

Risolvere il problema

  1. Assicurati che i tuoi dati strutturati includano la proprietà offers.url.
  2. Assicurati che il tuo URL soddisfi i requisiti degli URL per offers.url.
  3. Chiedi a Google di ripetere la scansione del tuo sito.
  4. Invia una richiesta di (ri)valutazione.

Ora o data non corrette

Che cosa ha causato il problema: l'ora o la data non sono corrette. Gli errori più frequenti includono il mancato inserimento della differenza per il fuso orario o l'indicazione di un orario di inizio non corretto (ad esempio, mezzanotte come ora di inizio).

Risolvere il problema

  1. Specifica la differenza corretta rispetto al fuso orario locale. Ad esempio, se il tuo evento inizia alle 19:00 a New York (UTC - 5) e termina alle 21:00, allora il valore di startDate è 2019-08-15T19:00:00-05:00 e il valore di endDate è 2019-08-15T21:00:00-05:00. Se non riesci a inserire la differenza per i tuoi eventi, non indicare l'orario includendo la differenza (ad esempio, utilizza 2019-08-15T19:00:00).
  2. Assicurati che l'ora di inizio o di fine sia corretta. Un errore comune consiste nell'impostare un evento a partire da mezzanotte quando l'evento non inizia effettivamente a mezzanotte. Se l'evento dura una giornata intera o l'ora di inizio non è stata comunicata, specifica solo il giorno. Ad esempio:

    Consigliato: 2019-07-20

    Non consigliato: 2019-07-20T00:00:00

    Non consigliato: 2019-08-15T00:00:01+00:00

    Non consigliato2019-08-15T00:00:00+00:00