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 transferência.

Visão geral dos modos de transferência

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

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

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 envio de preços que utiliza planos de tarifas, disponibilidade e metadados do hotel para definir estratégias de preços predefinidas para suas propriedades. Ao contrário dos preços pull e alterados, os feeds ARI não consultam preços ou itinerários específicos. Em vez disso, você envia mensagens contendo um subconjunto de informações que representam um modelo de preços para suas propriedades com base em vários detalhes de taxa, restrições e disponibilidade. Os feeds ARI usam a especificação XML OTA (OTA_HotelRateAmountNotifRQ e OTA_HotelAvailNotifRQ) para definir a disponibilidade e os preços. Entre em contato com seu gerente de contas para saber mais sobre o modo de transferência de ARI e determinar se esse tipo de feed é mais adequado para sua conta. Para mais informações, consulte Como usar ARI.

  • Pull: o Google consulta seu serviço regularmente para atualizar o cache dos dados de preços e disponibilidade. Nesse modelo, o Google envia uma solicitação ao seu servidor, que responde com dados atualizados. Esse modelo é melhor se você não sabe exatamente quando as informações de preço mudam ou se as informações de preço mudam irregularmente 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 Pull.

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

Além de atualizar os preços, é possível usar Mensagens de transação para remover propriedades do seu inventário. Para mais informações, consulte Como remover inventário.

Para mais informações sobre atualizações de preços, incluindo exemplos de Mensagens de transação, consulte Como atualizar preços.

Consultas de preços em tempo real

O Google também pode solicitar algumas atualizações de preço no momento do leilão com as consultas de preço em tempo real. 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 será incluído no leilão.

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

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

Contexto

As consultas de preços pull 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 retornar preços correspondentes a um conjunto completo de possíveis contextos do usuário pode ser caro, estamos testando um recurso em que contextos de usuários conhecidos são especificados como parte da consulta. Os contextos do usuário são baseados nas solicitações do usuário em que você teve a oportunidade de mostrar um preço e são calculados para abranger a grande maioria das solicitações. É possível que você veja um grande número de contextos de usuário para propriedades ou itinerários muito conhecidos, mas o número médio de contextos de usuário deve ser menor que 10. É possível retornar preços adicionais ou ignorar contextos de usuário especificados. 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.

Modo de transferência ARI Push

Com o modo de transferência ARI Push, você envia atualizações incrementais ao Google sempre que as taxas noturnas, a disponibilidade, as contagens de inventário ou outras restrições mudarem. Ao contrário dos preços pull ou alterados, o ARI Push permite que você use um modelo de preços diferente para atualizar com eficiência vários componentes de informações de preços para o Google.

O diagrama a seguir mostra o fluxo de solicitação e resposta do modo de transferência ARI Push:

fig1

Etapa 1: enviar mensagens push ARI para o Google

Para atualizar seus dados com o ARI Push, envie uma mensagem de solicitação ARI sempre que os dados mudarem. O modo de transferência ARI Push aceita vários tipos de mensagens e estratégias de preços. Para informações detalhadas sobre mensagens enviadas, consulte Como usar ARI.

Os preços devem ser exibidos pelo Google e ficar visíveis para os usuários dentro de 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 push ARI recebida, o Google responde com o status da conexão HTTP e os resultados do processamento de ARI. O Google responderá com 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 êxito ou se encontrou avisos ou erros do modo de transferência.

Colocar endereços IP na lista de permissões

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

Atualizar metadados de quartos e pacotes com o ARI Push

Use o tipo de mensagem Transação (dados da propriedade) para definir os tipos de quarto e planos de tarifas (pacotes) ativos para cada propriedade. Envie atualizações sempre que os tipos de quartos ou planos de tarifas forem adicionados, removidos ou modificados. Nesse caso, você envia 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 do modo de transferência devido ao XML estar incorreto ou estar 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 ARI ao Google, tente fazer a solicitação novamente 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 transferência Pull

No modo de transferência Pull, o Google envia Mensagens de consulta periodicamente ao seu servidor para solicitar atualizações de preço. Seu servidor responde a essas mensagens com Mensagens de transação que contêm dados atualizados de preço e disponibilidade.

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

fig2

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

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

Etapa 1: mensagem de consulta

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ê vai receber várias Mensagens de consulta durante os processos de mudança de preço.

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

  • O elemento raiz é <Query>.
  • Enviado para o 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á ter o domínio assinado por uma autoridade de certificação 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.

Etapa 2: Mensagem de transação

Quando o 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 Como atualizar preços.

Atualizar metadados de quartos e pacotes

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

Modo de transferência de preços alterado

Os preços alterados ajudam a reduzir o tamanho e a quantidade de Mensagens de consulta e transação para atualizações de preços. Ao usar os preços alterados, você envia ao Google uma lista das propriedades com preços atualizados. O Google responde com uma mensagem de consulta que solicita apenas os preços dessas propriedades.

Para configurar o endpoint ao qual o Google envia mensagens de solicitação de dica, consulte o Gerente técnico de contas (TAM). Isso é definido durante a configuração inicial.

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

fig3

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 Hint que o Google envia para seu servidor têm as seguintes características:

  • O elemento raiz é <HintRequest>.
  • Enviado para o endpoint definido durante a configuração inicial. Para mais informações, entre em contato com seu Gerente técnico de contas (TAM).
  • Use o método HTTP POST. Se você estiver usando HTTPS, o domínio precisará ser assinado por uma autoridade de certificação oficial.
  • O cabeçalho Content-Type está definido como application/xml.
  • Em uma frequência especificada, o Google envia um carimbo de data/hora para 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 que você defina a frequência para 5 minutos. Para definir ou modificar a frequência das mensagens de solicitação de Hint, entre em contato conosco.

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

Etapa 2: mensagem Hint Response

Seu servidor responde a uma mensagem de Solicitação de Hint com uma mensagem de Hint Response. Essa mensagem inclui os IDs de hotel e os itinerários das propriedades com preços alterados desde a última vez que você recebeu e respondeu a uma mensagem de solicitação de dica.

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

Etapa 3: mensagem de consulta

O Google recebe a mensagem de Hint Response e responde com uma Mensagem de consulta, como no modo Pull padrão. A diferença é que a Mensagem de consulta agora contém apenas os IDs de hotéis e itinerários para as propriedades que você especificou na mensagem Hint Response. O elemento raiz de uma Mensagem de consulta é <Query>.

Ao determinar para quais IDs de hotéis solicitar preços com os preços alterados, 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ço como resposta a Mensagens de consulta do Google. O elemento raiz de uma Mensagem de transação é <Transaction>. Para mais informações, consulte Modo de transferência Pull.