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
eOTA_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:
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:
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 comoapplication/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 comoGoogle-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:
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 comoapplication/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 comoGoogle-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.