Dati strutturati per case vacanze (VacationRental)

Illustrazione di case vacanze nella Ricerca Google

Quando aggiungi dati strutturati alle tue pagine delle schede di case vacanze, la Ricerca Google può mostrare la tua scheda in modi più completi. Gli utenti possono visualizzare le informazioni della scheda, ad esempio nome, descrizione, immagini, località, valutazione, recensioni e altro direttamente nei risultati di ricerca.

Prima di iniziare

Queste istruzioni sono rivolte ai proprietari di siti che hanno già contattato un Technical Account Manager di Google e che hanno accesso a Hotel Center. Se vuoi integrare le tue schede di case vacanze ma Google non ti ha ancora contattato, contattaci utilizzando il modulo di interesse relativo alle case vacanze.

Questa funzionalità è limitata ai siti che soddisfano determinati criteri di idoneità, e sono necessari dei passaggi aggiuntivi per completare l'integrazione. Per scoprire di più su come mostrare le tue case vacanze su Google, consultate la guida introduttiva all'integrazione.

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.

Esempio

Ecco un esempio di una semplice scheda di casa vacanze che utilizza il formato JSON-LD.


<html>
  <head>
    <title>My Beautiful Vacation Rental</title>
    <script type="application/ld+json">
      {
        "@context": "https://schema.org",
        "@type": "VacationRental",
        "additionalType": "HolidayVillageRental",
        "brand": {
          "@type": "Brand",
          "name": "brandIdName"
        },
        "containsPlace": {
          "@type": "Accommodation",
          "additionalType": "EntirePlace",
          "bed": [{
            "@type": "BedDetails",
            "numberOfBeds" : 1,
            "typeOfBed": "Queen"
          },
          {
            "@type": "BedDetails",
            "numberOfBeds" : 2,
            "typeOfBed": "Single"
          }],
         "occupancy": {
            "@type": "QuantitativeValue",
            "value" : 2
          },
          "amenityFeature": [
            {
              "@type": "LocationFeatureSpecification",
              "name": "ac",
              "value": true
            },
            {
              "@type": "LocationFeatureSpecification",
              "name": "airportShuttle",
              "value": true
            },
            {
             "@type": "LocationFeatureSpecification",
              "name": "balcony",
              "value": true
            },
            {
              "@type": "LocationFeatureSpecification",
              "name": "beachAccess",
              "value": true
            },
            {
              "@type": "LocationFeatureSpecification",
              "name": "childFriendly",
              "value": true
            }
          ],
          "floorSize": {
            "@type": "QuantitativeValue",
            "value" : 75,
            "unitCode": "MTK"
          },
          "numberOfBathroomsTotal": 1,
          "numberOfBedrooms": 3,
          "numberOfRooms": 5
        },
        "identifier": "abc123",
        "latitude": "42.12345",
        "longitude": "101.12345",
        "name": "My Beautiful Vacation Rental",
        "address": {
          "addressCountry": "US",
          "addressLocality": "Mountain View",
          "addressRegion": "California",
          "postalCode": "94043",
          "streetAddress": "1600 Amphitheatre Pkwy, Unit 6E"
        },
        "aggregateRating": {
          "ratingValue": 4.5,
          "ratingCount": 10,
          "reviewCount": 3,
          "bestRating": 5
        },
        "image": [
          "https://example.com/mylisting/unit_image1.png",
          "https://example.com/mylisting/unit_image2.png",
          "https://example.com/mylisting/unit_image3.png",
          "https://example.com/mylisting/unit_image4.png",
          "https://example.com/mylisting/unit_image5.png",
          "https://example.com/mylisting/unit_image6.png",
          "https://example.com/mylisting/unit_image7.png",
          "https://example.com/mylisting/unit_image8.png"
        ],
        "checkinTime": "18:00:00+08:00",
        "checkoutTime": "11:00:00+08:00",
        "description": "A great Vacation Rental in the perfect neighborhood.",
        "knowsLanguage": ["en-US", "fr-FR"],
        "review": [{
          "@type": "Review",
          "reviewRating": {
            "@type": "Rating",
            "ratingValue": 4,
            "bestRating": 5
          },
          "author": {
            "@type": "Person",
            "name": "Lillian Ruiz"
          },
          "datePublished": "2024-12-01",
          "contentReferenceTime": "2024-11-17"
        },
        {
          "@type": "Review",
          "reviewRating": {
            "@type": "Rating",
            "ratingValue": "5",
            "bestRating": "5"
          },
          "author": {
            "@type": "Person",
            "name": "John S."
          },
          "datePublished": "2024-10-01",
          "contentReferenceTime": "2024-09-28"
        }
      ]
      }
    </script>
  </head>
  <body></body>
  </html>

Criteri di idoneità

Affinché i dati strutturati per case vacanze siano idonei per essere utilizzati nella Ricerca Google, devi seguire queste linee guida.

Definizioni dei tipi di dati strutturati

Le seguenti tabelle elencano le proprietà e l'utilizzo per eseguire il markup delle schede di case vacanze utilizzando schema.org/VacationRental. Affinché i tuoi dati strutturati siano idonei alla visualizzazione, devi includere le proprietà obbligatorie. Puoi anche includere le proprietà consigliate per aggiungere ulteriori informazioni sui contenuti e fornire così un'esperienza utente migliore.

VacationRental

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

Proprietà obbligatorie
containsPlace

Accommodation

La scheda di una casa vacanze deve contenere una Accommodation per eseguire il markup di dettagli aggiuntivi come letti, numero di persone, numero di camere e proprietà amenityFeature.

containsPlace.occupancy

QuantitativeValue

Informazioni sul numero massimo consentito di ospiti che possono soggiornare nella casa vacanze.

"occupancy": {
  "@type": "QuantitativeValue",
  "value" : 5
  }
containsPlace.occupancy.value

Integer

Il valore numerico di ospiti che possono soggiornare nella casa vacanze.
identifier

Text

Un identificatore univoco per la proprietà.

Linee guida aggiuntive:

  • L'identificatore deve essere indipendente dai contenuti della scheda; ad esempio, non cambia quando il proprietario aggiorna il nome della scheda o il numero di camere da letto.
  • Per la stessa scheda deve essere utilizzato lo stesso identificatore in lingue diverse.
image

URL ripetuto

Una o più immagini della casa vacanze. La scheda deve contenere almeno 8 foto (almeno un'immagine di ciascuno dei seguenti ambienti: camera da letto, bagno e area comune).

Inoltre, segui i requisiti per l'immagine della scheda della proprietà.

latitude
(o geo.latitude)

Number

La latitudine della località della casa vacanze. La precisione deve essere di almeno 5 cifre decimali.

longitude
(o geo.longitude)

Number

La longitudine della località della casa vacanze. La precisione deve essere di almeno 5 cifre decimali.

name

Text

Il nome della scheda della casa vacanze.
Proprietà consigliate
additionalType

Text

Il tipo di scheda della casa vacanze. Ecco alcuni valori suggeriti:

  • Apartment
  • Bungalow
  • Cabin
  • Chalet
  • Cottage
  • Gite
  • HolidayVillageRental
  • House
  • Villa
  • VacationRental

Le definizioni complete di questi valori si trovano nelle Categorie di strutture ricettive.

address

PostalAddress

La posizione fisica completa della casa vacanze.

Fornisci la via, la città, lo stato o la regione e il codice postale della casa vacanze. Se applicabile, fornisci il numero della proprietà o dell'appartamento.

Tieni presente che caselle postali e altri indirizzi solo postali non sono considerati indirizzi fisici completi.

"address": {
  "addressCountry": "US",
  "addressLocality": "Mountain View",
  "addressRegion": "California",
  "postalCode": "94043",
  "streetAddress": "1600 Amphitheatre Pkwy, Apartment 4E"
}
address.addressCountry

Text

Il paese della casa vacanze, utilizzando il codice paese ISO 3166-1 alpha-2 a due lettere.
address.addressLocality

Text

La città della casa vacanze.
address.addressRegion

Text

Il nome dello stato, della regione o della provincia della casa vacanze.
address.postalCode

Text

Il codice postale della casa vacanze.
address.streetAddress

Text

L'indirizzo completo della casa vacanze, incluso il numero della proprietà o dell'appartamento, se applicabile.
aggregateRating

AggregateRating

La valutazione media della casa vacanze si basa su più valutazioni o recensioni. Segui le linee guida sugli snippet recensione e l'elenco di proprietà per la valutazione complessiva obbligatorie e consigliate.

brand

Brand

L'ID brand associato a questa proprietà. Per ulteriori informazioni su come associare le tue proprietà ai brand e su come collegare le icone e i nomi visualizzati del brand ai rispettivi ID brand, consulta la documentazione di Hotel Center. 

"brand": {
  "@type": "Brand",
  "name" : "brandIdName"
}
checkinTime

Time

Il primo orario in cui è possibile effettuare il check-in in una struttura ricettiva, nel formato ISO 8601.

Esempio: 14:30:00+08:00
checkoutTime

Time

L'ultimo orario in cui è possibile effettuare il check-in in una struttura ricettiva, nel formato ISO 8601.

Esempio: 14:30:00+08:00
containsPlace.additionalType

Text

Il tipo di camera per questo alloggio. Usa uno dei seguenti valori:

  • EntirePlace
  • PrivateRoom
  • SharedRoom
containsPlace.amenityFeature

amenityFeature ripetuta

Indica se la proprietà dispone di una certa caratteristica o comfort. Gli esempi booleani seguono questo schema:

"amenityFeature": {
  "@type": "LocationFeatureSpecification",
  "name" : "featureName",
  "value": true
}
Valori booleani

Utilizza uno dei seguenti valori per la proprietà amenityFeature.name. I valori devono essere in inglese, anche per le schede non in inglese.

ac

Indica se la proprietà è dotata di aria condizionata.
airportShuttle

Indica se l'host offre un servizio di trasporto da e per l'aeroporto o altri capolinea.
balcony

Indica se la proprietà ha un balcone.
beachAccess

Indica se la proprietà ha accesso a una spiaggia pubblica nelle vicinanze.
kidsFriendly

Indica se la proprietà è adatta ai bambini.
crib

Indica se la proprietà fornisce una culla.
elevator

Indica se la proprietà è dotata di ascensore.
fireplace

Indica se la proprietà include un camino.
freeBreakfast

Indica se la colazione è inclusa nel prezzo.
gymFitnessEquipment

Indica se la proprietà è dotata di palestra o attrezzi da fitness.
heating

Indica se la proprietà è dotata di riscaldamento.
hotTub

Indica se la proprietà è dotata di vasca idromassaggio.
instantBookable

Indica se la proprietà può essere prenotata istantaneamente tramite la procedura di pagamento. L'alternativa è attendere l'approvazione.

ironingBoard

Indica se la proprietà è dotata di ferro e asse da stiro.
kitchen

Indica se la proprietà è dotata di cucina.
microwave

Indica se la proprietà è dotata di forno a microonde.
outdoorGrill

Indica se la proprietà ha una griglia per barbecue.
ovenStove

Indica se la struttura è dotata di forno o piano cottura.
patio

Indica se la proprietà è dotata di un patio.
petsAllowed

Indica se l'ospite può portare un animale domestico presso la proprietà.
pool

Indica se la proprietà dispone di una piscina.
privateBeachAccess

Indica se la proprietà ha accesso dedicato a una spiaggia non pubblica.
selfCheckinCheckout

Indica se la proprietà supporta il check-in e il check-out automatici.
smokingAllowed

Indica se è consentito fumare nella proprietà.
tv

Indica se la proprietà è dotata di TV.
washerDryer

Indica se la proprietà è dotata di lavatrice/asciugatrice.
wheelchairAccessible

Indica se la proprietà è accessibile in sedia a rotelle.
wifi

Indica se la struttura dispone di Wi-Fi.

Valori non booleani

Sono supportate anche le seguenti coppie non booleane name e value per amenityFeature. Entrambi i valori devono essere in inglese, anche per le schede in lingue diverse dall'inglese.

I valori non booleani seguono questo schema:

"amenityFeature": {
  "@type": "LocationFeatureSpecification",
  "name" : "featureName",
  "value": "detail"
  }

internetType

Il tipo di connessione a internet disponibile nella proprietà. Ecco alcuni valori suggeriti:

  • Free
  • Paid
  • None

"amenityFeature": {
  "@type": "LocationFeatureSpecification",
  "name" : "internetType",
  "value": "Free"
}

parkingType

Il tipo di parcheggio disponibile nella proprietà. Ecco alcuni valori suggeriti:

  • Free
  • Paid
  • None

"amenityFeature": {
  "@type": "LocationFeatureSpecification",
  "name" : "parkingType",
  "value": "Free"
}
poolType

Il tipo di piscina disponibile nella proprietà. Ecco alcuni valori suggeriti:

  • Indoor
  • Outdoor
  • None

"amenityFeature": {
  "@type": "LocationFeatureSpecification",
  "name" : "poolType",
  "value": "Outdoor"
}

licenseNum

Il numero di licenza (turista o aziendale) che deve essere mostrato per le proprietà in determinate regioni del mondo. Potrebbe essere ripetuto e, se ci sono più licenze, suggeriamo di aggiungere l'autorità della licenza come contesto (ad esempio: Paris: 123456ABC). 

"amenityFeature": {
  "@type": "LocationFeatureSpecification",
  "name" : "licenseNum",
  "value": "Paris: 123456ABC"
}
containsPlace.bed

BedDetails ripetuti

Informazioni sul tipo e sul numero di letti presenti nella casa vacanze. 

"bed": [{
  "@type": "BedDetails",
  "numberOfBeds" : 1,
  "typeOfBed": "Queen"
  },
  {
  "@type": "BedDetails",
  "numberOfBeds" : 2,
  "typeOfBed": "Single"
  }]
containsPlace.bed.numberOfBeds

Integer

Il numero di letti nella casa vacanze.

containsPlace.bed.typeOfBed

Text

Il tipo di letti nella casa vacanze. Ecco alcuni valori suggeriti:

  • CaliforniaKing
  • King
  • Queen
  • Full
  • Double
  • SemiDouble
  • Single
containsPlace.floorSize

QuantitativeValue

Le dimensioni della struttura. Deve essere specificata utilizzando i valori delle proprietà unitCode:

  • Per i piedi quadrati: FTK o SQFT
  • Per i metri quadrati: MTK o SQM
"floorSize": {
  "@type": "QuantitativeValue",
  "value" : 75,
  "unitCode": "MTK"
  }
containsPlace.numberOfBathroomsTotal

Integer

Il totale dei bagni nella casa vacanze. Segui le convenzioni immobiliari documentate dall'organizzazione RESO e utilizza la semplice somma del numero di bagni. Ad esempio, per una proprietà con due bagni completi e un mezzo bagno, il numero totale è 2,5.

containsPlace.numberOfBedrooms

Integer

Il numero totale di camere da letto nella casa vacanze.
containsPlace.numberOfRooms

Integer

Il numero totale di camere nella casa vacanze.
description

Text

Una descrizione della struttura.
knowsLanguage

Repeated Text

Le lingue parlate dall'host. Utilizza i codici lingua dello standard IETF BCP 47, come en-US o fr-FR.

review

Repeated Review

Una o più recensioni degli utenti della casa vacanze. Segui le linee guida sugli snippet recensione e l'elenco di proprietà delle recensioni obbligatorie e consigliate. 

"review": {
  "@type": "Review",
  "reviewRating": {
    "@type": "Rating",
    "ratingValue": "4",
    "bestRating": "5"
  },
  "datePublished": "2023-02-09"
  "author": {
    "@type": "Person",
    "name": "Lillian R"
  }
}
review.contentReferenceTime

DateTime

La data di inizio del soggiorno dell'autore della recensione.

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.