Modos de transferência de preços

O modo de envio 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 entrega

Por padrão, é possível consultar um hotel 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ê oferecer suporte, mais leilões vai participar. No entanto, quanto mais itinerários você oferecer suporte, mais dados precisará enviar ao Google para manter a precisão dos dados de preços.

Os métodos típicos de atualização de preços usam mensagens Transaction de uma destas formas:

• ARI (push): um feed de envio de preços que usa 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 de 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 de ARI usam a especificação XML da 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 envio de ARI e determinar se esse tipo de feed é o mais adequado para sua conta. Para mais informações, consulte Como usar a ARI.

• Pull: 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 para o servidor, que responde com dados atualizados. Esse modelo é melhor se você não souber 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ço anterior específico do parceiro. Para mais informações, consulte Como usar o modo de entrega de pull.

• Preço alterado (antes chamado de "Pull with hints") é semelhante ao Pull, exceto pelo fato de que 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 os 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 o preço alterado.

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 Como remover o inventário.

Para mais informações sobre como enviar 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 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 período especificado, seu anúncio vai aparecer no leilão.

O Google armazena a resposta a uma consulta de preços em tempo real, assim como qualquer outra mensagem de transação. Como resultado, o Google pode exibir 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 em tempo real tem disponibilidade limitada para usuários do EEE.

Contexto

As consultas de preços de extração e de alteração 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 vários usuários.

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

Dica: se você quiser receber os contextos de usuários mais comuns nas consultas que o Google envia, 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ários em consultas para você.

Modo de envio push de ARI

Com o modo de envio por push de ARI, você envia atualizações incrementais ao Google sempre que as diárias, a disponibilidade, a contagem 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 vários componentes de informações de preços para o Google de maneira eficiente.

O diagrama a seguir mostra o fluxo de solicitação e resposta para o modo de envio de push do ARI:

Etapa 1: enviar mensagens push de ARI para o Google

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

Seus preços precisam ser veiculados pelo Google e ficar visíveis para os usuários em 15 a 20 minutos depois que uma mensagem for recebida.

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

Para cada mensagem push do ARI recebida, o Google responde com o status da conexão HTTP e os resultados do processamento do ARI. O Google vai responder 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 que indica se as atualizações foram aplicadas ou se encontraram avisos ou erros do modo de entrega.

Endereços IP na lista de permissões

Para permitir endereços 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ço na Central para Hotéis.

Atualizar metadados do Room e do pacote com o ARI Push

Use o tipo de mensagem Transação (dados da propriedade) para definir os tipos de quarto e os planos de tarifa (pacotes) ativos para cada propriedade. Você precisa enviar atualizações sempre que tipos de quarto 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 de modo de entrega devido a um XML incorreto ou com formato inválido, encontre a solução recomendada em Mensagens de erro de status do feed.

Se você receber um erro de conexão HTTP ao enviar uma mensagem 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 envio pull

Com o modo de envio de pull, o Google envia periodicamente mensagens de consulta para 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ços e disponibilidade.

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

Depois de receber as atualizações de preço, o Google geralmente processa os novos dados de preço e disponibilidade em aproximadamente 5 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 reprecificação.

As mensagens de consulta de preços 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 o gerente técnico de contas (TAM).
• Usa o método HTTP POST. Se você estiver usando HTTPS, é necessário assinar o domínio com 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ço 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 Alteração de preço.

Etapa 2: mensagem de transação

Quando o servidor recebe uma mensagem de consulta, ele precisa responder com uma mensagem de transação que contém informações de preços dos 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 sala 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 quarto e pacote. Para mais informações, consulte Como definir metadados de sala e pacote.

Modo de envio de preços alterado

A mudança de preço 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 de consulta que solicita apenas os preços dessas propriedades.

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

Importante: se você não implementar as mensagens de resposta de dicas, 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 a alteração de preço:

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 dicas 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, será necessário assinar o domínio com 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 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 definir a frequência como 5 minutos. Para definir ou modificar a frequência das mensagens de solicitação de dicas, entre em contato.

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

Etapa 2: mensagem de resposta da dica

Seu 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 foram alterados desde a última vez que você recebeu e respondeu a uma mensagem de solicitação de sugestão.

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

Etapa 3: mensagem de consulta

O Google recebe a mensagem de resposta de sugestão 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 e itinerários de hotéis das propriedades que você especificou na mensagem de resposta de sugestão. O elemento raiz de uma mensagem de consulta é <Query>.

Ao determinar quais IDs de hotéis solicitar preços com 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 às mensagens de consulta do Google. O elemento raiz de uma mensagem de transação é <Transaction>. Para mais informações, consulte Modo de entrega de pull.