Questa pagina è stata tradotta dall'API Cloud Translation.

Pacchetti camera

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 fino a tre adulti. Il terzo è un altro tipo di camera 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. La radice 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 ulteriori 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.

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à. Il più foto importanti del letto, dell'intera stanza, del bagno, del soggiorno, e la vista dalla stanza (con il resto della stanza nella stessa foto). Se applicabile, il balcone, il patio o la 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 alcuna Pacchetti camera o caratteristiche delle tariffe nell'elemento <Result> e poi in tutte le camere I pacchetti vengono rimossi e viene visualizzata solo la camera base per l'hotel o l'itinerario in questione nei risultati di ricerca.

Assicurati di utilizzare elementi come <Name> per arricchire i tuoi pacchetti camera interessanti per i potenziali clienti e assicurarsi 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 di una camera e di pacchetti. 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 il tag Il pacchetto camera è abilitato.

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

Perché i prezzi delle combinazioni di camere o itinerari cambiano molto più spesso rispetto alle descrizioni della camera o del pacchetto, definendo i metadati una volta e facendo riferimento è un uso 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 utilizzare Occupazione e Capacità anche nei pacchetti camera per impostare i prezzi dei alloggi, ad esempio ostello. 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

Aggiorni i metadati del pacchetto camera con una risposta a un <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.