Modos de transferência de preços

O modo de transferência determina como você envia atualizações de preços ao Google para combinações de hotel e itinerário. Você e seu gerente técnico de contas (TAM) trabalham juntos durante a configuração inicial para definir o modo de entrega.

Visão geral dos modos de transferência

Por padrão, um hotel pode ser consultado com até 330 dias de antecedência da disponibilidade de quartos e até 30 noites de estadia, mas você pode determinar o número máximo de itinerários (combinação de data de check-in e duração da estadia).

Quanto mais itinerários você apoiar, mais leilões vai participar. No entanto, quanto mais itinerários você oferecer, mais dados precisará enviar ao Google para manter as informações de preços precisas.

Os métodos típicos de atualização de preços usam mensagens de transação de uma das seguintes maneiras:

• ARI (Push): um feed de entrega de preços que usa planos de tarifas, disponibilidade e metadados de hotéis para definir estratégias de preços predefinidas para suas propriedades. Ao contrário dos preços pull e alterados, os feeds da ARI não consultam preços ou itinerários específicos. Em vez disso, você envia mensagens com um subconjunto de informações que representam um modelo de preços para suas propriedades com base em vários detalhes de tarifas, restrições e disponibilidade. Os feeds da ARI usam a especificação XML da OTA (OTA_HotelRateAmountNotifRQ e OTA_HotelAvailNotifRQ) para definir disponibilidade e preços. Entre em contato com seu gerente de contas para saber mais sobre o modo de veiculação da ARI e determinar se esse tipo de feed é o mais adequado para sua conta. Para mais informações, consulte Como usar a ARI.

• Extração: o Google consulta seu serviço regularmente para atualizar o cache de dados de preços e disponibilidade. Nesse modelo, o Google envia uma solicitação ao seu servidor, que responde com dados atualizados. Esse modelo é ideal se você não sabe exatamente quando as informações de preços mudam ou se elas mudam de forma irregular ao longo do dia. Os preços permanecem no cache até que os algoritmos do Google determinem que eles estão desatualizados, com base no histórico de mudanças de preços anteriores específico do parceiro. Para mais informações, consulte Como usar o modo de entrega por pull.

• Preço alterado (antigo Pull with Hints): semelhante ao Pull, mas o Google solicita dados apenas para um subconjunto de propriedades, não para todas. Esse modo pode reduzir significativamente a quantidade de tráfego de rede ao atualizar preços e disponibilidade das suas propriedades. Os preços permanecem no cache indefinidamente até serem atualizados. Para mais informações, consulte Como usar a mudança de preços.

Além de atualizar os preços, você pode usar as mensagens de transação para remover propriedades do seu inventário. Para mais informações, consulte Remover inventário.

Para mais informações sobre como fornecer atualizações de preços, incluindo exemplos de mensagens de transação, consulte Atualizar preços.

Consultas de preços em tempo real

O Google também pode solicitar algumas atualizações de preços no momento do leilão com consultas de preços em tempo real. As consultas de preços em tempo real são solicitações de preços do Google para um leilão atual. Se você responder dentro do prazo especificado, seu anúncio vai aparecer no leilão.

O Google armazena a resposta a uma consulta de preços em tempo real da mesma forma que faz com qualquer outra mensagem de transação. Como resultado, o Google pode veicular o preço do cache em vez de enviar outra consulta de preços em tempo real no futuro.

Para mais informações, consulte Consultas de preços em tempo real.

Importante: devido à nova experiência de pesquisa, a consulta Live tem disponibilidade limitada para usuários do EEE.

Contexto

As consultas de preços extraídos e alterados geralmente não especificam informações sobre o usuário, já que o Google usa suas respostas para preencher um cache que pode ser usado para atender a vários usuários diferentes.

Como pode ser caro retornar preços correspondentes a um conjunto completo de contextos possíveis do usuário, estamos testando um recurso em que os contextos de usuário mais usados são especificados como parte da consulta. Os contextos de usuário são baseados em solicitações de usuários em que você teve a oportunidade de mostrar um preço e são calculados para cobrir a grande maioria das solicitações de usuários. Você pode encontrar um grande número de contextos de usuário para propriedades ou itinerários muito procurados, mas o número médio de contextos de usuário deve ser menor que 10. Você pode retornar preços adicionais ou ignorar contextos de usuário específicos. Cabe a você decidir quais preços retornar para uma determinada consulta. No entanto, ignorar um contexto de usuário sugerido pode resultar em menos tráfego.

Ponto principal: o país do usuário é o único contexto compatível com a mudança de preço por pull ou push. Os detalhes de ocupação e os contextos de tipo de dispositivo precisam ser enviados pela consulta de preços em tempo real com contexto. Consulte os exemplos em Com consultas contextuais.

Dica: se você quiser receber contextos de usuários populares em consultas enviadas pelo Google, entre em contato com seu gerente técnico de contas (TAM). Eles vão confirmar que você está pronto para receber essas mensagens e fazer um ajuste de configuração para começar a enviar contextos de usuário em consultas para você.

Modo de transferência por push da ARI

Com o modo de entrega por push da ARI, você envia atualizações incrementais ao Google sempre que as tarifas noturnas, a disponibilidade, as contagens de inventário ou outras restrições mudam. Ao contrário do Pull ou dos preços alterados, o ARI Push permite usar um modelo de preços diferente para atualizar com eficiência vários componentes das informações de preços no Google.

O diagrama a seguir mostra o fluxo de solicitação e resposta para o modo de entrega por push da ARI:

Etapa 1: enviar mensagens push da ARI para o Google

Para atualizar seus dados com o ARI Push, envie uma mensagem de solicitação do ARI sempre que seus dados mudarem. O modo de entrega por push da ARI é compatível com vários tipos de mensagens e estratégias de preços. Para informações detalhadas sobre o envio de mensagens, consulte Como usar a ARI.

Seus preços precisam ser veiculados pelo Google e ficar visíveis para os usuários em até 15 a 20 minutos após o recebimento de uma mensagem.

Etapa 2: confirmar se os dados foram armazenados em cache pelo Google

Para cada mensagem de push da ARI recebida, o Google responde com o status da conexão HTTP e os resultados do processamento da ARI. O Google responde com um HTTP 200 OK se a conexão com o servidor for bem-sucedida. Ele também inclui um corpo com uma mensagem de resposta indicando se as atualizações foram aplicadas com sucesso ou se houve avisos ou erros no modo de entrega.

Lista de permissões de endereços IP

Para permitir qualquer endereço IP que você usa para enviar mensagens ARI ao Google, use a página de configurações de preço da ARI da Central para Hotéis. Saiba como atualizar as configurações de preços na Central para Hotéis.

Atualizar metadados de sala e pacote com o ARI Push

Use o tipo de mensagem Transação (dados da propriedade) para definir os tipos de quarto e planos de tarifa (pacotes) ativos de cada propriedade. Envie atualizações sempre que tipos de quartos ou planos de tarifas forem adicionados, removidos ou modificados. Nesse caso, envie uma mensagem XML com as novas informações nos elementos <RoomData> e <PackageData>. Esses elementos são filhos do elemento <PropertyDataSet>.

Erros de conexão ou conteúdo

Se você receber um erro de modo de entrega porque o XML está malformado ou incorreto, encontre a resolução recomendada em Mensagens de erro de status do feed.

Se você receber um erro de conexão HTTP ao enviar uma mensagem da ARI para o Google, tente novamente a solicitação em intervalos de 1, 5 e 20 minutos. Se o problema persistir após três tentativas, pare de enviar mensagens e entre em contato com o Suporte do Google.

Modo de entrega pull

No modo de entrega por pull, o Google envia periodicamente mensagens de consulta ao seu servidor para solicitar atualizações de preço. O servidor responde a essas mensagens com mensagens de transação que contêm dados atualizados de preços e disponibilidade.

O diagrama a seguir mostra o fluxo de solicitação/resposta de Pull:

Depois de receber as atualizações de preço, o Google geralmente processa os novos dados de preços e disponibilidade em aproximadamente 5 minutos.

As seções a seguir descrevem cada uma dessas etapas em mais detalhes.

Etapa 1: consultar mensagem

Por padrão, o Google envia mensagens de consulta para todas as propriedades definidas na sua Lista de hotéis. Isso pode significar que você precisa receber várias mensagens de consulta durante os processos de mudança de preço.

As mensagens de consulta de preços que o Google envia ao seu servidor têm as seguintes características:

• O elemento raiz é <Query>.
• Enviado ao endpoint definido durante a configuração inicial. Para mais informações, entre em contato com seu gerente técnico de contas (TAM).
• Usa o método HTTP POST. Se você estiver usando HTTPS, precisará que o domínio seja assinado por uma autoridade certificadora oficial.
• O cabeçalho Content-Type está definido como application/xml.
• Cada mensagem inclui até 100 propriedades para as quais o Google solicita dados de preços e disponibilidade.
• O cabeçalho User-Agent está definido como Google-HotelAdsPrices.

Importante: pode haver muitas mensagens de consulta para atualizar todos os preços de todos os hotéis, e as mensagens de transação resultantes podem ser muito grandes. Para reduzir o tamanho e o número de mensagens, recomendamos usar Changed Pricing.

Etapa 2: mensagem de transação

Quando seu servidor recebe uma mensagem de consulta, ele precisa responder com uma mensagem de transação que contenha informações de preços para os itinerários solicitados.

O elemento raiz de uma mensagem de transação é <Transaction>. Para mais informações, consulte Mensagens de transação e Atualização de preços.

Atualizar metadados de Room e pacote

Além de atualizar os dados de preços com o Pull, você também pode usar mensagens de transação para atualizar os metadados de quartos e pacotes. Para mais informações, consulte Como definir metadados de sala e pacote.

Modo de transferência de preços alterados

A mudança de preços ajuda a reduzir o tamanho e a quantidade de mensagens de consulta e transação para atualizações de preços. Ao usar o preço alterado, você envia ao Google uma lista de propriedades com preços atualizados. O Google responde com uma mensagem "Query" que pede apenas os preços dessas propriedades.

Para configurar o endpoint em que o Google envia mensagens de solicitação de sugestão, consulte seu gerente técnico de contas (TAM). Você teria configurado isso durante a configuração inicial.

Ponto-chave: se você não implementar mensagens de resposta de sugestão, as mensagens de consulta do Google vão solicitar dados para propriedades all identificadas na sua lista de hotéis.

O diagrama a seguir mostra o fluxo de solicitação e resposta para preços alterados:

As seções a seguir descrevem cada uma das etapas desse fluxo.

Etapa 1: mensagem de solicitação de dica

As mensagens de solicitação de dica que o Google envia ao seu servidor têm as seguintes características:

• O elemento raiz é <HintRequest>.
• Enviado ao endpoint definido durante a configuração inicial. Para mais informações, entre em contato com seu gerente técnico de contas (TAM, na sigla em inglês).
• Use o método HTTP POST. Se você estiver usando HTTPS, será necessário assinar o domínio por uma autoridade certificadora oficial.
• O cabeçalho Content-Type está definido como application/xml.
• Em uma frequência especificada, o Google envia um carimbo de data/hora ao seu servidor que define a última vez que você respondeu a uma mensagem de solicitação de dica.
• O cabeçalho User-Agent está definido como Google-HotelAdsPrices.

Recomendamos definir a frequência para 5 minutos. Para definir ou modificar a frequência das mensagens de solicitação de dica, entre em contato.

Quando você recebe uma mensagem de solicitação de dica do Google, responda com todos os preços que foram atualizados desde esse carimbo de data/hora. Para mais informações, consulte Mensagens de solicitação de dica.

Etapa 2: Hint Response message

O servidor responde a uma mensagem de solicitação de dica com uma mensagem de resposta de dica. Essa mensagem inclui os IDs de hotel e os itinerários das propriedades cujos preços mudaram desde a última vez que você recebeu e respondeu a uma mensagem de solicitação de dica.

O elemento raiz de uma mensagem de resposta de dica é <Hint>. Para mais informações, consulte Mensagens de resposta de dica.

Etapa 3: consultar mensagem

O Google recebe a mensagem de resposta de dica e responde com uma mensagem de consulta, assim como no modo de extração padrão. A diferença é que a mensagem de consulta agora contém apenas os IDs de hotéis e os itinerários das propriedades especificadas na mensagem de resposta de dica. O elemento raiz de uma mensagem de consulta é <Query>.

Ao determinar para quais IDs de hotel solicitar preços com a mudança de preços, o Google ignora o conteúdo do seu feed de lista de hotéis. Isso reduz bastante o tamanho da mensagem de consulta que você recebe do Google e o tamanho da mensagem de transação da sua resposta.

Etapa 4: mensagem de transação

Você envia uma mensagem de transação com uma atualização de preços como resposta às mensagens de consulta do Google. O elemento raiz de uma mensagem de transação é <Transaction>. Para mais informações, consulte Modo de entrega por pull.