I pacchetti camera consentono di definire più tipi di camera per una singola struttura oppure combinare l'itinerario di una camera con le caratteristiche della tariffa, i servizi aggiuntivi che prevedono una tariffa e condizioni di vendita per gli utenti al di là delle prezzo.
Concetti chiave e flusso di lavoro
Con i pacchetti camera puoi offrire combinazioni aggiuntive di tipi di camere fisiche con pacchetti di servizi diversi.
L'immagine seguente mostra esempi di pacchetti camera:
In questo esempio, il primo pacchetto è la camera base, con uno sconto solo per un pacchetto una persona adulta. Il secondo è un tipo di camera diverso, disponibile per un massimo di tre adulti. Il terzo è un altro tipo di camera all'interno della stessa proprietà. Il quarto è un "premium" pacchetto della camera base, che potrebbe La colazione è inclusa nel prezzo.
Le seguenti immagini mostrano esempi di caratteristiche relative alle tariffe:
La visualizzazione di pacchetti camera e caratteristiche delle tariffe nei risultati di ricerca è regolata dai la stessa procedura di selezione delle tariffe standard delle camere.
Pacchetti camera
Puoi definire i pacchetti camera e le caratteristiche delle tariffe nei messaggi Transaction. L'elemento principale
di un messaggio Transaction è <Transaction>.
La struttura del messaggio Transaction dipende da ciò che stai facendo: definendo i metadati relativi al pacchetto camera o alla funzionalità della tariffa oppure aggiornando i Prezzi o disponibilità dei pacchetti camera.
- Metadati
- Per definire i metadati di pacchetti camera e funzionalità della tariffa, utilizza
<PackageData>in un<PropertyDataSet>. Per ulteriori informazioni, consulta Definire la stanza e metadati del pacchetto. I pacchetti camera utilizzano gli elementi<RoomData>esistenti per le descrizioni delle camere fisiche. - Prezzi e disponibilità
- Per definire i prezzi e la disponibilità dei pacchetti camera, utilizza l'elemento
<RoomBundle>in<Result>per ogni combinazione pacchetto/itinerario. Per maggiori informazioni informazioni, consulta la sezione Definire prezzi e disponibilità.
La tariffa, le tasse e le altre commissioni della camera base sono obbligatorie ai sensi
<Result> se non vengono utilizzati con i pacchetti camera e possono essere rimossi quando
utilizzata con i pacchetti camera. Se implementi i pacchetti camera utilizzando una
di fatturazione, procedi nel seguente modo:
Includi la tariffa, le tasse e altre commissioni della camera base inferiori a
<Result>e aggiungi un pacchetto camera che corrisponda al pacchetto camera base.Se necessario, definisci altri pacchetti camera all'interno dello stesso blocco
<Result>per altri tipi di camere nella struttura o pacchetti di servizi diversi.Dopo il lancio del pacchetto camera, rimuovi la tariffa, le tasse e altre commissioni della camera base.
Metadati dei pacchetti camera
Quando definisci i pacchetti camera e le caratteristiche delle tariffe, in genere devi definire descrizione, servizi aggiuntivi inclusi nella tariffa e altre informazioni sul pacchetto camera. Queste informazioni sono note come i metadati del pacchetto camera. Poi dovrai fare riferimento a questi metadati nella tabella dei prezzi ma non includerli nei messaggi di aggiornamento.
Quando definisci i pacchetti camera, utilizza gli elementi <RoomData> esistenti per
descrizioni delle camere fisiche ed elementi <PackageData> per le caratteristiche delle tariffe
e termini che non fanno parte
della descrizione fisica di una camera.
L'utilizzo degli elementi <RoomData> e <PackageData> può significativamente
riduci le dimensioni del tuo elenco hotel e del prezzo dell'hotel
feed perché riduce
di dati ripetitivi inviati nei messaggi Transaction.
Ad esempio, dati come il nome e la descrizione di una stanza vengono in genere ripetuti
per ogni itinerario. Puoi utilizzare <RoomData> e <PackageData>
per definire questo tipo di dati una sola volta. Dati dei pacchetti camera specifici per l'itinerario
viene poi unita alle definizioni della camera e del pacchetto archiviate per mostrarle al
per l'utente finale.
Google associa i tuoi metadati ai dati specifici del tuo itinerario per eseguire il rendering
dei tuoi annunci. Esiste un'elaborazione speciale per combinare i nomi
descrizioni dagli elementi <RoomData> e <PackageData>, consentendo
la camera fisica da descrivere in <RoomData> e le caratteristiche della tariffa e
dettagli del pacchetto in <PackageData>.
Se definisci sia i dati della camera sia quelli del pacchetto per una camera o una camera singola Gruppo, Google include entrambi nell'output dell'annuncio, separati da un trattino.
Linee guida relative alle foto
Ecco alcune linee guida che devi seguire per inviare le foto delle stanze Assicurati che le tue foto vengano mostrate agli utenti:
Invia foto per ogni tipo di camera, comprese le foto delle camere accessibili stanze, ad esempio stanze accessibili agli ospiti con vari bagni come la doccia con accesso per disabili.
Includi almeno quattro foto della stanza e almeno una foto della bagno.
Le foto devono mostrare la camera stessa e non la proprietà. Le foto più importanti sono quelle del letto, dell'intera camera, del bagno, dello spazio abitativo, della vista dalla camera (con il resto della camera nella stessa foto) e, se applicabile, del balcone, del patio o della terrazza.
È utile anche scattare foto della scrivania, della cucina, di macchine per il caffè/tè, e caratteristiche distintive della camera.
Evita foto di persone e proprietà, ad esempio gli esterni o la proprietà. servizi turistici, turismo e ristorazione.
Evita i primi piani di oggetti, ad esempio primi piani di calici.
Evita brand e brand, anche se gli articoli da toeletta sono etichettati o di marca includi in una foto che ritragga l'intera area del bagno. Foto non deve contenere grandi blocchi di testo, loghi o filigrane.
Fornire foto standard orizzontali (orizzontali) con un ampio campo visivo. evita foto distorte e con effetto fisheye. Scatta foto alla massima risoluzione per migliorare il ranking. Non è necessario inviare la stessa foto in vari risoluzioni.
Precedenza dati
I dati dei pacchetti camera vengono raccolti da tutte le fonti e combinati, con precedenza , per produrre i dati finali per un determinato hotel, itinerario e pacchetto camera. L'ordinamento è il seguente, dalla precedenza più bassa a quella più alta:
- Dati partner (valore più basso)
- Dati della proprietà
<RoomData>, dove<RoomID>corrisponde a<RoomID>nel Blocco<RoomBundle><PackageData>, dove<PackageID>corrisponde a<PackageID>nel Blocco<RoomBundle>- (Maggiore)
<RoomBundle>
Definire prezzi e disponibilità
Per definire i prezzi e la disponibilità dei pacchetti camera, utilizza un elemento <RoomBundle> in
un messaggio Transaction per ogni pacchetto o combinazione di itinerario. La
L'elemento <RoomBundle> deve essere all'interno dell'elemento <Result>. Codice campione
per due elementi <RoomBundle> è mostrato di seguito. Tieni presente che, in questo esempio,
due elementi <RoomBundle> fanno riferimento ai metadati di camera e pacchetto utilizzando
<RoomID> e <PackageID>.
Per ogni <Result>, l'insieme contenuto di pacchetti camera sostituisce il valore
esistente per quella proprietà o combinazione di itinerario. Se non definisci pacchetti camera
o caratteristiche della tariffa nell'elemento <Result>, tutti i pacchetti camera verranno
rimossi e nei risultati di ricerca verrà mostrata solo la camera base per
l'hotel o l'itinerario.
Assicurati di utilizzare elementi come <Name> per rendere i tuoi pacchetti camera più
interessanti per i potenziali clienti e di verificare che corrispondano alla pagina di
destinazione dell'hotel. In questo esempio, devi definire i nomi e altre informazioni descrittive
nei metadati.
<RatePlanID> è facoltativo e rappresenta l'identificatore univoco per una combinazione di camera e pacchetto. Ti consigliamo vivamente di utilizzare RatePlanID come variabile per
creare l'URL della pagina di destinazione dinamica (in precedenza point of sale). Per maggiori dettagli, vedi
Utilizzare variabili e condizioni.
Nei pacchetti camera sono facoltativi i seguenti elementi:
<Baserate>
<Tax>
<OtherFees>
<RoomID>
<PackageID>
<Occupancy>
<OccupancyDetails>
Quando implementi il pacchetto camera in un account attivo, rimuovi <Baserate> dopo aver attivato il pacchetto camera.
<Result>
<!-- Note: When using Room Bundles, the top level result price is no
longer necessary. -->
<Property>180054</Property>
<Checkin>2017-10-07</Checkin>
<Nights>2</Nights>
<!-- Base Room Bundle -->
<RoomBundle>
<RoomID>060773</RoomID>
<PackageID>P54321</PackageID>
<Baserate currency="USD">199.99</Baserate>
<Tax currency="USD">25.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
<!-- RatePlanID is optional and represents the unique identifier for a
room and package data combination. We strongly recommend using RatePlanID
as a variable to build your dynamic landing page (formerly Point of Sale)
URL. For details, see Using Variables and Conditions. -->
<RatePlanID>060773-P54321</RatePlanID>
</RoomBundle>
<!-- Premium Room Bundle -->
<RoomBundle>
<RoomID>436233</RoomID>
<PackageID>P12345</PackageID>
<!-- Price for 4 ("occupancy") -->
<Baserate currency="USD">298.88</Baserate>
<Tax currency="USD">42.12</Tax>
<OtherFees currency="USD">10.00</OtherFees>
<RatePlanID>436233-P12345</RatePlanID>
</RoomBundle>
</Result>
Definisci i metadati di camere e pacchetti
Per definire i metadati del pacchetto camera, utilizza gli elementi <PackageData> e <RoomData>
all'interno dell'elemento <PropertyDataSet> di un messaggio Transaction.
Devi definire i metadati di camere e pacchetti in un messaggio Transaction che e sono distinti dai dati su prezzi e disponibilità. Con la definizione di questo i dati in anticipo, gli aggiornamenti dei prezzi non devono includere come descrizioni, URL di foto, comfort e altri dati su per ogni camera o pacchetto per ogni singolo itinerario.
Google memorizza i metadati per te e li inserisce negli annunci quando vengono visualizzati. Puoi aggiornare i metadati di camere e pacchetti in qualsiasi momento con una nuova Messaggio Transaction.
Nel messaggio Transaction, imposta un ID pacchetto e un ID camera in ogni blocco
a cui farai riferimento nei blocchi <Result> degli aggiornamenti dei prezzi.
Se i dati della camera e del pacchetto cambiano, ad esempio se aggiungi una nuova camera digita una proprietà, invia un nuovo messaggio Transaction contenente i dati aggiornati di camere e pacchetti. Google sostituisce i metadati esistenti una camera o un pacchetto con i nuovi dati.
Google consiglia di definire i metadati durante la configurazione iniziale. Dopo il giorno
predefinire i metadati, devi solo fare riferimento ai <RoomID> e
Valori di <PackageID> nei prezzi
aggiornamenti anziché includere tutte le
di nuovo queste informazioni. Google utilizza questi ID per abbinare le camere e i pacchetti camera
con i metadati archiviati. Ciò può ridurre notevolmente le dimensioni complessive
Messaggi Transaction.
Poiché i prezzi delle combinazioni di camere o itinerari cambiano molto più spesso delle descrizioni della camera o del pacchetto, definire i metadati una sola volta e farvi poi riferimento è un utilizzo molto più efficiente dei messaggi Transaction. Inoltre, gli errori come la mancata corrispondenza tra le descrizioni delle camere può essere eliminata utilizzando i metadati anziché rispetto alla definizione dei dati in linea.
Il metodo consigliato e più efficiente per definire i metadati e i prezzi come mostrato di seguito:
<!-- Efficient method of defining Room Bundles -->
<!----- Occupancy of 2 and 4 example ------>
<Transaction timestamp="2019-04-18T16:20:00-04:00" id="12345678">
<!-- Part1: Define RoomData and PackageData in PropertyDataSet -->
<!-- Note: Once defined it does not have to be repeated for future Transaction Messages. -->
<!-- PropertyDataSets can also be defined and sent in their own Transaction Message -->
<!-- separately from pricing. Google can be configured to pull just PropertyDataSets -->
<!-- once per day (or on a predefined frequency). -->
<PropertyDataSet>
<Property>180054</Property>
<!-- Can be reused by multiple Room Bundles -->
<RoomData>
<RoomID>060773</RoomID>
<Name>
<Text text="Single Queen Room - Non-Smoking" language="en"/>
<Text text="Chambre de la Roi Premium - Pas de Fumeurs" language="fr"/>
</Name>
<!-- Room can accommodate 4, but bundle is for 2 -->
<Capacity>4</Capacity>
<PhotoURL>
<URL>http://www.foo.com/static/bar/imageQueen.jpg</URL>
<Caption>
<Text text="A bright and breezy way to enjoy your mornin'
cuppa tea." language="en"/>
<Text text="Une façon lumineuse et aérée pour profiter
de votre journée tasse de thé." language="fr"/>
</Caption>
</PhotoURL>
</RoomData>
<RoomData>
<RoomID>436233</RoomID>
<Name>
<Text text="Premium King Room - Non-Smoking" language="en"/>
<Text text="Chambre de le Roi Premium - Pas de Fumeurs" language="fr"/>
</Name>
<!-- Room can accommodate 4 and bundle is for 4 -->
<Capacity>4</Capacity>
<PhotoURL>
<URL>http://www.foo.com/static/bar/imageKing.jpg</URL>
<Caption>
<Text text="A bright and breezy way to enjoy your mornin'
cuppa tea." language="en"/>
<Text text="Une façon lumineuse et aérée pour profiter
de votre journée tasse de thé." language="fr"/>
</Caption>
</PhotoURL>
</RoomData>
<!-- Can be reused by multiple Room Bundles -->
<PackageData>
<PackageID>P54321</PackageID>
<Occupancy>2</Occupancy>
<ChargeCurrency>web</ChargeCurrency>
<Refundable available="1" refundable_until_days="7"
refundable_until_time="18:00:00"/>
<ParkingIncluded>1</ParkingIncluded>
<InternetIncluded>1</InternetIncluded>
</PackageData>
<PackageData>
<PackageID>P12345</PackageID>
<Occupancy>4</Occupancy>
<ChargeCurrency>web</ChargeCurrency>
<Refundable available="1" refundable_until_days="1"
refundable_until_time="18:00:00"/>
<BreakfastIncluded/>
<ParkingIncluded>1</ParkingIncluded>
<InternetIncluded>1</InternetIncluded>
</PackageData>
</PropertyDataSet>
<!-- Efficient method of defining Room Bundles -->
<!-- Part 2: Reference RoomData and PackageData through ID -->
<Result>
<Property>180054</Property>
<Checkin>2017-10-07</Checkin>
<Nights>2</Nights>
<!-- Base Room Bundle -->
<RoomBundle>
<RoomID>060773</RoomID>
<PackageID>P54321</PackageID>
<Baserate currency="USD">199.99</Baserate>
<Tax currency="USD">25.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
<!-- RatePlanID is optional and represents the unique identifier for a
room and package data combination. We strongly recommend using RatePlanID
as a variable to build your dynamic landing page (formerly Point of Sale)
URL. For details, see Using Variables and Conditions. -->
<RatePlanID>060773-P54321</RatePlanID>
</RoomBundle>
<!-- Premium Room Bundle -->
<RoomBundle>
<RoomID>436233</RoomID>
<PackageID>P12345</PackageID>
<!-- Price for 4 ("occupancy") -->
<Baserate currency="USD">298.88</Baserate>
<Tax currency="USD">42.12</Tax>
<OtherFees currency="USD">10.00</OtherFees>
<RatePlanID>060773-P12345</RatePlanID>
</RoomBundle>
<!-- Continue providing all available RoomBundle rates under matched
property for any other occupancies -->
</Result>
</Transaction>
Occupazione e capacità
Quando definisci i pacchetti camera, devi comprendere la differenza tra numero di persone e capienza:
- Numero di persone
- Il numero di ospiti a cui è destinato un pacchetto camera. Ad esempio:
il "Pacchetto Luna di miele" ha un numero di persone pari a due. Devi impostare il valore di un
numero di persone del pacco utilizzando gli elementi
<PackageData>o<RoomBundle><Occupancy>elemento secondario. - Capacità
- Il numero massimo di persone che può ospitare fisicamente una camera. La
la capacità di una camera è sempre uguale o superiore al numero di persone. Per
ad esempio la "Suite Honeymoon" nel tuo hotel ha una capacità massima di 6
persone, ma il prezzo di un pacchetto è per due persone. Devi impostare il valore di un
di capacità del pacchetto utilizzando l'elemento secondario
<Capacity>dell'elemento<RoomData>.
Quando definisci il prezzo di un pacchetto camera, devi indicare il prezzo in base al numero di ospiti
a cui il bundle è destinato (il valore specificato nel
<Occupancy>). Se <Occupancy> è impostato su due, il prezzo in questione
il pacco deve essere per due persone. Non puoi impostare <Occupancy> su quattro invitati e
imposta il prezzo del pacchetto per due ospiti.
Camere condivise
Puoi anche utilizzare gli elementi Occupancy e Capacity nei pacchetti camera per impostare i prezzi delle camere condivise, ad esempio gli ostelli. Ad esempio, per impostare una tariffa per persona
per una camerata con 8 posti letto, devi impostare il Numero di persone su 1 e
Capacità di 8 e identificarlo come tale nel nome <RoomData>. Vedi
esempio.
Aggiorna pacchetti camera
In questa sezione viene descritto come rimuovere un pacchetto camera non più disponibile. e come aggiornare il prezzo di un pacchetto camera esistente.
Rimozione di pacchetti camera
La rimozione dei pacchetti camera è diversa dai prezzi dell'hotel che li rappresentano.
Per rimuovere una combinazione di camera o itinerario dall'inventario, imposta la
Da <Baserate> a -1 di <Result> elemento. Per rimuovere un pacchetto camera per un
una determinata camera o itinerario, rimuovi l'elemento <RoomBundle> dal
Blocco <Result> nel messaggio Transaction.
I pacchetti camera nei feed di dati sono considerati un insieme, quale numero è presente da 0 a decine. Quando invii i pacchetti camera a Google, invii attuale, completo. I valori di un singolo pacchetto camera non possono essere modificati in contrassegnane una precedentemente disponibile come non disponibile. Qualunque insieme di bundle sia incluso il messaggio Transaction più recente sostituisce l'insieme corrente.
Ad esempio, sono presenti i gruppi A, B, C e D. Per prima cosa invii un messaggio definisce l'insieme dei pacchetti camera A, B, C e D. In seguito, se il pacchetto B dovesse esaurirsi, invia di nuovo l'intero set solo con i pacchetti A, C e D. Se tutti i pacchetti camera sono esauriti, invia un set vuoto di pacchetti camera.
Aggiustamenti dei prezzi
Per modificare il prezzo di un pacchetto camera, imposta il nuovo <Baserate> in <Result>
.
Ogni volta che aggiorni il blocco <Result> di una camera/un itinerario nella tua transazione
devi includere un insieme completo di pacchetti camera disponibili per ogni
<Result>. Google sostituisce l'insieme esistente di pacchetti camera con il nuovo
per iniziare. Se non includi pacchetti camera in <Result>, Google rimuove
tutti i pacchetti camera per la camera o l'itinerario in questione.
Aggiornamenti dei metadati
Per aggiornare i metadati dei pacchetti camera devi utilizzare una risposta a un messaggio <Query> di Google.
Devi rispondere a un messaggio Query con un messaggio Transaction che definisce la stanza e i metadati del pacchetto per gli hotel specificati. Per ulteriori informazioni, consulta la sezione Query Messaggi.