Categorias de quarto permitem definir vários tipos de quarto para uma única propriedade ou combinar um itinerário de um quarto com recursos de tarifa (serviços adicionais que vêm com uma taxa e condições de venda) para seus usuários além de um preço padrão.
Principais conceitos e fluxo de trabalho
Com Categorias de quarto, é possível oferecer combinações adicionais de tipos de quarto físicos com diferentes pacotes de serviço.
A imagem a seguir mostra exemplos de Categorias de quarto:
Neste exemplo, o primeiro pacote é o quarto base, com desconto para apenas um ocupante adulto. O segundo é um tipo de quarto diferente, disponível para até três adultos. O terceiro é outro tipo de quarto na mesma propriedade. O quarto é um pacote "premium" do quarto base, que pode incluir comodidades como café da manhã gratuito ou uma finalização de compra mais tarde.
As imagens a seguir mostram exemplos de recursos de tarifa:
A exibição das Categorias de quarto e dos recursos de tarifa nos resultados da pesquisa é regida pelo mesmo processo de seleção de tarifas padrão.
Categorias de quarto
Você define Categorias de quarto e avalia recursos em Mensagens de transação. O elemento raiz de uma Mensagem de transação é <Transaction>.
A estrutura da Mensagem de transação depende do que você está fazendo: definir os metadados sobre a Categoria de quarto ou o recurso de tarifa ou atualizar o preço ou a disponibilidade da Categoria de quarto.
- Metadados
- Defina a categoria de Categoria de quarto e avalie os metadados do recurso com
<PackageData>em um elemento<PropertyDataSet>. Para mais informações, consulte Definir metadados de quartos e pacotes. Categorias de quarto usam elementos<RoomData>existentes para as descrições físicas de quartos. - Preços e disponibilidade
- Defina o preço e a disponibilidade da Categoria de quarto com o elemento
<RoomBundle>em uma<Result>para cada combinação de pacote/itinerário. Para mais informações, consulte Definir preços e disponibilidade.
A taxa, os tributos e outras taxas do quarto base são obrigatórios em <Result> quando não são usados com Categorias de quarto e podem ser removidos quando usados com Categorias de quarto. Se você estiver implementando Categorias de quarto usando uma conta ativa, siga estas etapas:
Inclua a diária, os tributos e outras taxas do quarto base em
<Result>e adicione uma Categoria de quarto que corresponda à Categoria de quarto base.Se necessário, defina Categorias de quarto adicionais no mesmo bloco
<Result>para outros tipos de quarto nessa propriedade ou diferentes pacotes de serviços.Depois que a Categoria de quarto é lançada, remova a tarifa básica, os tributos e outras taxas.
Metadados de Categoria de quarto
Ao definir Categorias de quarto e recursos de tarifa, você normalmente define a descrição, os serviços adicionais que fazem parte da tarifa e outras informações com antecedência. Essas informações são conhecidas como metadados da Categoria de quarto. Você faz referência a esses metadados nas atualizações de preços, mas não os inclui nas mensagens de atualização de preços.
Ao definir Categorias de quarto, use elementos <RoomData> existentes para as descrições de quarto físicos e elementos <PackageData> para os recursos e termos de tarifa que não fazem parte da descrição física do quarto.
O uso dos elementos <RoomData> e <PackageData> pode reduzir
significativamente o tamanho da lista de hotéis e do Feed de preços para
hotéis porque reduz a quantidade de dados repetitivos enviados em Mensagens de transação.
Por exemplo, dados como nome e descrição de um quarto normalmente são repetidos para cada itinerário. É possível usar os elementos <RoomData> e <PackageData>
para definir esse tipo de dados uma vez. Os dados de Categoria de quarto específicos do itinerário
são mesclados às definições armazenadas de quartos e pacotes para exibição ao
usuário final.
O Google faz a correspondência dos seus metadados com os dados específicos do itinerário para renderizar o conteúdo dos anúncios. Há um processamento especial para combinar os nomes e
descrições dos elementos <RoomData> e <PackageData>, permitindo
que a sala física seja descrita em <RoomData> e os recursos de taxa e
detalhes do pacote estejam em <PackageData>.
Se você definir os dados de quarto e de pacote para um único quarto ou Categoria de quarto, o Google incluirá ambos na saída do anúncio, separados por um hífen.
Diretrizes de fotos
Ao enviar fotos da sala, siga estas diretrizes para garantir que elas sejam exibidas aos usuários:
Envie fotos para cada tipo de quarto, incluindo fotos de quartos acessíveis, por exemplo, quartos designados e acessíveis com vários acessórios de banheiro, como chuveiro com rodinhas.
Inclua pelo menos quatro fotos do quarto e pelo menos uma foto do banheiro.
As fotos precisam ser do quarto em vez da propriedade. As fotos mais importantes são da cama, do quarto todo, do banheiro, do espaço de estar e da vista do quarto (com o restante do quarto na mesma foto) e, se aplicável, da varanda, do pátio ou do terraço.
Também é útil tirar fotos da mesa, da cozinha, do cafeteira/chá e das características distintas do ambiente.
Evite fotos de pessoas e propriedades, como áreas externas ou de propriedade, como passeios turísticos/turismo e comida.
Evite fotos em close-up de objetos, como closes de têxteis.
Evite usar marcas e marcas de banho, embora produtos de higiene pessoal ou de marca possam ser incluídos em uma foto que capture todo o banheiro. As fotos não devem apresentar grandes blocos de texto, logotipos ou marcas d'água.
Forneça fotos padrão, em modo paisagem (horizontal) com um amplo campo de visão. Evite fotos tiradas com a lente olho de peixe e distorcidas. Capture fotos na resolução mais alta para melhorar a classificação. Não é necessário enviar a mesma foto em várias resoluções.
Precedência dos dados
Os dados de Categoria de quarto são coletados de todas as fontes e combinados, usando regras de precedência, para produzir os dados finais de um determinado hotel, itinerário e Categoria de quarto. A ordem é a seguinte, da menor para a maior precedência:
- (Menor) Dados de parceiros
- Dados da propriedade
<RoomData>, em que<RoomID>corresponde ao<RoomID>no bloco<RoomBundle>.<PackageData>, em que<PackageID>corresponde ao<PackageID>no bloco<RoomBundle>.- (Maior)
<RoomBundle>
Definir preços e disponibilidade
Para definir preços e disponibilidade de Categoria de quarto, use um elemento <RoomBundle> em uma Mensagem de transação para cada combinação de pacote ou itinerário. O
elemento <RoomBundle> precisa estar dentro do elemento <Result>. Veja abaixo um exemplo de código
para dois elementos <RoomBundle>. Observe que, neste exemplo, os dois elementos <RoomBundle> referenciam metadados de quartos e pacotes usando <RoomID> e <PackageID>.
Para cada <Result>, o conjunto contido de Categorias de quarto substitui o
conjunto existente para essa combinação de propriedade ou itinerário. Se você não definir qualquer Categoria de quarto ou recursos de tarifa no elemento <Result>, todas as Categorias de quarto são removidas e somente o quarto básico do hotel ou itinerário é exibido nos resultados da pesquisa.
Use elementos como <Name> para tornar suas Categorias de quarto mais atrativas para clientes em potencial e verifique se elas correspondem à página de destino do hotel. Neste exemplo, você definiria nomes e outras informações descritivas nos metadados.
<RatePlanID> é opcional e representa o identificador exclusivo de uma combinação de quarto e
pacote. É altamente recomendável usar o RatePlanID como uma variável para criar seu URL dinâmico da página de destino (antigo ponto de venda). Para mais detalhes, consulte Como usar variáveis e condições.
Os seguintes elementos são opcionais nas Categorias de quarto:
<Baserate>
<Tax>
<OtherFees>
<RoomID>
<PackageID>
<Occupancy>
<OccupancyDetails>
Ao implementar a Categoria de quarto em uma conta ativa, remova <Baserate> depois que a Categoria de quarto é ativada.
<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>
Definir metadados de quartos e pacotes
Para definir metadados de Categoria de quarto, use os elementos <PackageData> e <RoomData>
dentro do elemento <PropertyDataSet> de uma Mensagem de transação.
Você define os metadados de quartos e pacotes em uma Mensagem de transação separada dos dados de preços e disponibilidade. Ao definir esses dados com antecedência, suas atualizações de preços não precisam incluir informações repetitivas, como descrições, URLs de fotos, comodidades e outros dados sobre cada quarto ou pacote para cada itinerário.
O Google armazena os metadados para você e os insere nos anúncios quando eles são exibidos. É possível atualizar os metadados de quartos e pacotes a qualquer momento com uma nova mensagem de transação.
Na Mensagem de transação, você define um código de pacote e um código de quarto em cada bloco que você referencia nos blocos <Result> de atualizações de preço.
Se os dados de quartos e pacotes forem alterados (por exemplo, se você adicionar um novo tipo de quarto em uma propriedade, enviar uma nova Mensagem de transação que contenha os dados atualizados de quartos e pacotes), o Google substituirá os metadados existentes sobre um quarto ou pacote pelos novos dados.
O Google recomenda que você defina metadados durante a configuração inicial. Depois de
preparar os metadados, você só precisa referenciar os valores <RoomID> e
<PackageID> nas atualizações de
preços, em vez de incluir todas
essas informações novamente. O Google usa esses IDs para corresponder quartos e Categorias de quarto com os metadados armazenados. Isso pode reduzir muito o tamanho geral das Mensagens de transação.
Como os preços de combinações de quarto ou itinerário mudam com muito mais frequência do que as descrições de quartos ou pacotes, definir metadados uma vez e se referir a eles é um uso muito mais eficiente das Mensagens de transação. Além disso, erros como a não correspondência de descrições de sala podem ser eliminados usando metadados em vez de definir dados in-line.
O método recomendado e mais eficiente para definir metadados e preços separadamente é mostrado abaixo:
<!-- 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>
Ocupação e capacidade
Ao definir Categorias de quarto, você precisa entender a diferença entre ocupação e capacidade:
- Ocupação
- O número de hóspedes a que uma Categoria de quarto se destina. Por exemplo, o "Pacote lua de mel" tem uma ocupação de duas pessoas. Para definir o valor da ocupação de um pacote, use o elemento filho
<Occupancy>dos elementos<PackageData>ou<RoomBundle>. - Capacidade
- É o número máximo de pessoas que um quarto pode acomodar. A
capacidade de um quarto é sempre igual ou maior que a ocupação. Por
exemplo, a "Suíte de lua de mel" no seu hotel tem capacidade máxima de seis
pessoas, mas você cobra um pacote para duas pessoas. Para definir o valor da capacidade de um pacote, use o elemento filho
<RoomData>do elemento<Capacity>.
Ao definir o preço de uma Categoria de quarto, você precisa fornecer o preço para o número de hóspedes
para o qual a categoria se destina (o valor especificado no elemento <Occupancy>
do pacote). Se <Occupancy> for definido como dois, o preço nesse pacote precisará ser para duas pessoas. Não é possível definir <Occupancy> como quatro convidados e definir o preço do pacote para dois convidados.
Salas compartilhadas
Você também usa a ocupação e a capacidade em Categorias de quarto para definir preços para acomodações
compartilhadas, por exemplo, hostel. Por exemplo, para definir um preço por pessoa
para um quarto com oito quartos, defina "Ocupação" como 1 e
Capacidade como 8. Depois, identifique-o como tal no nome <RoomData>. Veja um exemplo.
Atualizar Categorias de quarto
Esta seção descreve como remover uma Categoria de quarto que não está mais disponível e como atualizar o preço de uma Categoria de quarto existente.
Remoção de Categoria de quarto
Categorias de quarto diferem da maneira como você os remove de hotéis.
Para remover uma combinação de quarto ou itinerário do inventário, defina <Baserate> do elemento <Result> como -1. Para remover uma Categoria de quarto de um
determinado quarto ou itinerário, remova o elemento <RoomBundle> do bloco
<Result> na Mensagem de transação.
Categorias de quarto em feeds de dados são consideradas um conjunto, que numera de 0 a dezenas delas. Ao enviar Categorias de quarto para o Google, você envia o conjunto completo atual. Não é possível alterar os valores de uma Categoria de quarto individual para marcar uma anteriormente disponível como indisponível. O conjunto de pacotes que está na Mensagem de transação mais recente substitui o conjunto atual.
Por exemplo, há os grupos A, B, C e D. Primeiro, você envia uma mensagem que define o conjunto de pacotes de sala A, B, C e D. Mais tarde, se os pacotes B venderem, reenvie o conjunto inteiro apenas com os pacotes A, C e D. Se todas as Categorias de quarto esgotaram, envie um conjunto vazio de Categorias de quarto.
Ajustes de preço
Para mudar o preço de uma Categoria de quarto, defina o novo <Baserate> no elemento
<Result>.
Sempre que você atualiza o bloco <Result> de um quarto/itinerário nas Mensagens de transação, é necessário incluir um conjunto completo de Categorias de quarto disponíveis para cada <Result>. O Google substitui o conjunto atual de Categorias de quarto pelo novo
conjunto. Se você não incluir nenhuma Categoria de quarto em <Result>, o Google removerá
todas as Categorias de quarto para esse quarto ou itinerário.
Atualizações de metadados
Você atualiza os metadados da Categoria de quarto com uma resposta para um <Query> do Google.
Você responde a uma Mensagem de consulta com uma Mensagem de transação que define os metadados de quartos e pacotes para os hotéis especificados. Para mais informações, consulte Mensagens de consulta.