Messaggio tariffa

Panoramica

Il messaggio Rate (OTA_HotelRateAmountNotifRQ) definisce le tariffe notturne per il numero di persone per ogni combinazione di tipo di camera e piano tariffario per intervalli di date specifici. Nell'ambito del messaggio relativo alle tariffe, Google supporta i prezzi basati sul numero di persone, consentendo di specificare diverse tariffe per notte in base al numero massimo degli occupanti previsti.

Le seguenti sezioni trattano le linee guida generali, un esempio di base e le procedure scenari per aiutarti ad aggiungere e aggiornare le tariffe e a inviare Valuta messaggio.

Comportamento della tariffa di corrispondenza

Poiché gli utenti richiedono un numero di persone specifico, la tariffa visualizzata dipende da come definisci i prezzi nel messaggio relativo alle tariffe. In questa sezione viene spiegato come vengono Le richieste degli utenti vengono abbinate alle tue tariffe in base al numero di persone richiesta e le tariffe che definisci.

Principi chiave

  • Una tariffa definita per un numero specifico si applica a tutti i numero di persone meno ridotti, se non diversamente definito.

  • Le richieste per un numero di persone superiore a quelle definite sono considerate non possibili.

  • I prezzi basati sul numero di persone si applicano sia ai prezzi per data sia a quelli basati sulla durata del soggiorno modelli di prezzo descritti di seguito. Ciò significa che puoi specificare le tariffe per ogni ingente di persone. Se non esiste una tariffa per un numero di persone specifico, la tariffa per viene usato il numero successivo di persone più alto. Puoi anche definire gli addebiti per gli ospiti e i bambini aggiuntivi utilizzando AdditionalGuestAmounts o ExtraGuestCharges, che vengono applicati fino alla capienza definita per una camera.

Vantaggi ed esempi

Efficienza

Per più persone con lo stesso importo di tariffa, non è necessario impostare un tariffa per ogni numero di persone. Puoi semplificare i messaggi impostando solo il valore in base al numero di persone più alto supportato dal tipo di camera e dal piano tariffario. Gli utenti vedranno questa tariffa per ogni numero di persone inferiore o uguale all'intervallo impostato valore.

Esempio:le tariffe per un tipo di camera e un piano tariffario sono le stesse per da uno a quattro. Utilizza il messaggio Tariffa per impostare una tariffa per il valore massimo per 4 persone. Utenti che cercano camere singole, doppie e triple vedranno la stessa tariffa. Gli utenti che cercano 5 o più termini non vedranno le tariffe.

Controllo

È possibile fornire esplicitamente tariffe distinte per il numero di persone alternative. Invia una tariffa diversa per ogni numero di persone se vuoi avere un maggiore controllo Google abbina le richieste alle tariffe in base al numero di persone.

Esempio: se le tariffe sono definite per il numero di persone 3 e 1, per il numero di persone singole per le ricerche sarà visualizzata la tariffa per single, una ricerca per due persone mostrerà la percentuale di persone triple e gli utenti che cercano 4 o più anni non vedranno tariffe.

Per altri esempi di vari scenari relativi alle tariffe, consulta Istruzioni.

Elementi obbligatori e facoltativi

Il riferimento XML fornisce le descrizioni degli elementi obbligatori e facoltativi. Per maggiori dettagli su attributi ed elementi secondari, consulta la sezione Valuta e Attributi.

Sintassi e schemi

Utilizza la sintassi tariffaria esempio come riferimento quando crei il messaggio Tariffa per assicurarti stai seguendo il formato corretto.

Puoi utilizzare uno strumento XML di terze parti come xmllint per convalidare i tuoi feed con gli schemi pubblicati prima di inviarli a Google. Per il messaggio relativo alle tariffe consulta la pagina Schemi di Hotel Ads.

Modelli di prezzo

Prezzi per data

Questo è il modello di determinazione del prezzo standard utilizzato per la maggior parte delle proprietà. per-date si basa sull'impostazione di tariffe che vengono sommate per tutte le date del soggiorno arrivi a un prezzo totale. In questo modello, tutte le tariffe di un elemento Rate sono interpretati come applicabili a un intervallo di date del soggiorno specificato in <StatusApplicationControl>.

Prezzi basati sulla lunghezza del soggiorno

Il modello di determinazione dei prezzi basato sulla durata del soggiorno si basa sulle tariffe impostate per un data di arrivo e durata del soggiorno. Le tariffe specificate ai sensi della sezione Il modello di prezzi basato sulla lunghezza del soggiorno è giornaliero. Ad esempio, se invii una tariffa di 100 $ per una durata del soggiorno di 3 notti, il prezzo totale viene calcolato come 3x100$=300$.

Puoi utilizzare il modello di prezzi basato sulla lunghezza del soggiorno specificando RatePlanType="26" su StatusApplicationControl elementi. Devi inoltre imposta gli attributi RateTimeUnit e UnitMultiplier su Rate elementi in XML. In questo modo, tutte le tariffe dell'elemento Rate specificato verranno applicate ai soggiorni definite dalle date di arrivo specificate in <StatusApplicationControl> e Valore della lunghezza del soggiorno specificato per UnitMultiplier.

Puoi utilizzare sia i modelli di prezzi per data che quelli basati sulla durata del soggiorno in un'unica soluzione , tuttavia, ogni proprietà deve usare un solo modello di determinazione del prezzo. Tieni presente i seguenti punti quando implementi i prezzi basati sulla lunghezza del soggiorno:

  • Le tariffe per durate diverse del soggiorno non vengono combinate quando si utilizzano i prezzi basati sulla lunghezza del soggiorno. Ad esempio, una durata del soggiorno pari a 3 non viene combinata con una durata del soggiorno pari a 3. 1 per avere una tariffa LOS di 4. La percentuale di durata del soggiorno pari a 4 deve essere espressa in modo esplicito specificato.
  • La tariffa per 1 notte nei prezzi basati sulla lunghezza del soggiorno non viene utilizzata come tariffa per singola notte con prezzi per data.
  • Ogni proprietà deve usare solo prezzi basati sulla lunghezza del soggiorno o per data dei prezzi, a seconda di come le tariffe sono rappresentate nel tuo sistema.

Per attivare i prezzi basati sulla lunghezza del soggiorno per il tuo account, effettua la richiesta tramite il tuo TAM oppure contattaci.

Linee guida o azioni

Prezzi per data

Delta: aggiungi o aggiorna le tariffe in base al numero di persone solo per il numero di persone specificato combinazioni di tipo di camera, piano tariffario e date del soggiorno specificate in <StatusApplicationControl>.

  • Gli aggiornamenti delle tariffe utilizzano l'azione Delta per impostazione predefinita.
  • Un aggiornamento di Delta non modifica le tariffe memorizzate in precedenza per altri numero di persone. Ad esempio, se hai specificato le tariffe per singola e camere doppie e invia un aggiornamento delle tariffe di Delta per la camera singola camera per due persone, la tariffa per due persone rimane invariata.

Overlay: elimina tutte le tariffe esistenti in base al numero di persone per il tipo di camera, piano tariffario e le date specificate in <StatusApplicationControl> e sostituisci con nuove tariffe. Ad esempio, se hai specificato le tariffe per singola e camere doppie e invii un aggiornamento di Overlay per le camere singole camera, Google rimuoverà tutte le tariffe precedenti (sia singola che doppia per il numero di persone) e dopo l'aggiornamento rimarrà solo la tariffa per una persona.

Remove: elimina tutte le tariffe esistenti in base al numero di persone per il tipo di camera, piano tariffario e le date specificate in <StatusApplicationControl>.

Prezzi basati sulla lunghezza del soggiorno

Delta: aggiungi o aggiorna le tariffe in base al valore LOS solo per le combinazioni specificate di tipo di camera, piano tariffario e date di check-in specificate in <StatusApplicationControl>. Sostituisce tutte le tariffe in base al numero di persone associate con i valori della lunghezza del soggiorno aggiornati.

  • Per impostazione predefinita, gli aggiornamenti delle tariffe utilizzano l'azione Delta.
  • Un aggiornamento Delta non modifica le tariffe memorizzate in precedenza per altre durate del soggiorno. Ad esempio, se hai specificato le tariffe per gli OS 1 e 2 e invii un aggiornamento delle tariffe Delta per l'OS 1, le tariffe per il numero di persone dell'OS 2 rimangono invariate.
  • Un aggiornamento di Delta sovrascrive tutte le tariffe memorizzate in precedenza in base al numero di persone per la durata del soggiorno specificata. Ad esempio, se hai specificato tariffe per due persone per LOS 1 e invio di un aggiornamento delle tariffe pari a Delta per LOS 1 con una sola tariffa per una persona, la tariffa per 2 persone viene rimossa.

Overlay: elimina tutte le tariffe esistenti in base al numero di persone per la durata del soggiorno, la camera tipo, piano tariffario e date di check-in specificate in <StatusApplicationControl> e sostituirle con nuove tariffe. Ad esempio, se hai specificato tariffe per LOS 1 e 2 e invii un aggiornamento di Overlay per la LOS 1, Google rimuoverà tutte le tariffe precedenti (sia LOS 1 che 2) e solo la LOS 1 rimarrà dopo l'aggiornamento.

Remove: elimina tutte le tariffe esistenti in base al numero di persone per tutta la durata del soggiorno tipo di camera, piano tariffario e date di check-in specificate in <StatusApplicationControl>.

Fisco

Se le tasse e le commissioni sono semplici, l'importo totale può essere specificato utilizzando AmountAfterTax. Le tasse complesse, ad esempio quelle che si applicano per soggiorno (anziché per notte), non possono essere rappresentate in AmountAfterTax.

In generale, Google consiglia di utilizzare TaxFeeInfo anziché AmountAfterTax.

Se possibile, devi includere AmountBeforeTax (anche se specifichi AmountAfterTax) poiché alcune impostazioni internazionali (ad esempio gli Stati Uniti) mostrano la proprietà prezzo al lordo delle imposte.

Tutte le tasse e commissioni che un utente deve pagare (IVA, tasse di soggiorno, spese di pulizia, città tasse e così via) devono essere incluse, anche se non sono state pagate al momento della prenotazione o pagato direttamente alla proprietà.

Esempio

Questa sezione fornisce un esempio base di messaggio Rate che utilizza obbligatori e elementi facoltativi. Dopo aver preparato il file, devi inviarlo a Google utilizzando un messaggio POST al seguente endpoint: https://www.google.com/travel/hotels/uploads/property_data

Per scoprire di più su come eseguire il push/POST del messaggio, vedi Push dei messaggi.

Per HotelCode, utilizza l'ID hotel univoco usato nel sistema per che identifica la proprietà. Questo valore deve corrispondere all'ID hotel specificato utilizzando <id> nell'elemento <listing> nel feed elenco hotel. Per <PackageID> e <RoomID>, utilizza gli stessi ID che hai già utilizzare all'interno del tuo sistema per i piani tariffari e i tipi di camera (rispettivamente). Coerenza con il tuo sistema è fondamentale per garantire che Google mostri correttamente i tuoi prezzi e i tuoi dati.

Questo esempio mostra come impostare le tariffe utilizzando un'azione Delta:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2022-02-25T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Delta">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <RateAmountMessages HotelCode="HotelID">
    <RateAmountMessage>
      <StatusApplicationControl Start="2022-12-01"
                                End="2022-12-31"
                                InvTypeCode="RoomID"
                                RatePlanCode="PackageID" />
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt NumberOfGuests="1" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="2" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="3" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="4" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
</OTA_HotelRateAmountNotifRQ>

Procedure

Questa sezione fornisce soluzioni agli scenari che potresti riscontrare durante l'invio Valutare i messaggi.

Per esempi su come aggiungere, rimuovere e aggiornare le tariffe, consulta la sezione Tariffe Esempi.

Scenario 1: come modificare il prezzo in base al numero di persone

Descrizione

In precedenza, le tariffe per notte erano definite solo per due persone (che anche si applica a una singola persona), ma ora è disponibile una tariffa più economica per ingente di persone.

Soluzione

Invia la nuova tariffa per 1 numero di persone utilizzando l'aggiornamento predefinito con ambito Delta. Questo nuovo non influisce sulla tariffa per 2 persone.

Scenario 2: come sostituire le tariffe in base al numero di persone di una proprietà

Descrizione

In precedenza hai definito le tariffe per il numero di persone da 1 a 4, ma ora solo il numero di persone 1 e 2 è valido.

Soluzione

Utilizza NotifType="Overlay" per sostituire tutte le tariffe in base al numero di persone per una determinata proprietà, tipo di camera, piano tariffario e date. In questo scenario, l'azione Overlay le tariffe di listino per il numero di persone 1 e 2.

Scenario 3: come impostare la stessa tariffa per più persone

Descrizione

Una tariffa per una determinata numero di persone può essere venduta a un gruppo con meno persone. In questo puoi semplificare i messaggi inviando solo l'aggiornamento delle tariffe per il numero massimo di persone applicabile.

Soluzione

Se hai lo stesso prezzo per più persone, imposta il numero di persone più alto supportato dal tipo di camera e dal piano tariffario, utilizza questo valore per il numero di persone più basso. Vale a dire, non è necessario ripetere lo stesso tariffa per notte per numero di persone 1-6, se sono tutte uguali; impostalo su 6.