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

Visão geral dos modos de transferência

Por padrão, o hotel pode ser consultado com até 330 dias de antecedência sobre a disponibilidade de quartos e estadias de até 30 noites, 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ê aceitar, mais leilões vai participar. No entanto, quanto mais itinerários você tiver, mais dados precisará enviar ao Google para manter os dados de preços precisos.

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

• ARI (Push): um feed de exibição de preços que usa planos de preços, 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 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 taxas, restrições e disponibilidade. Os feeds ARI usam a especificação XML OTA (OTA_HotelRateAmountNotifRQ e OTA_HotelAvailNotifRQ) para definir a disponibilidade e o preço. Entre em contato com o gerente de contas para saber mais sobre o modo de transferência ARI e determinar se esse tipo de feed seria 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 de dados de preços e disponibilidade. Nesse modelo, o Google envia uma solicitação para seu servidor, e este responde com dados atualizados. Esse modelo será melhor se você não souber exatamente quando as informações de preços são alteradas ou se essas informações mudarem de forma irregular ao longo do dia. Os preços permanecem no cache até que os algoritmos do Google determinem que os preços ficaram desatualizados, com base no histórico de alterações de preços anteriores específico do parceiro. Para ver mais informações, consulte Como usar o modo de transferência Pull.

• Preços alterados (anteriormente Pull with Hints): semelhante ao Pull, exceto pelo fato de o Google solicitar dados somente para um subconjunto de propriedades, não para todas as propriedades. Esse modo pode reduzir significativamente o tráfego de rede ao atualizar preços e disponibilidade das suas propriedades. Os preços permanecem no cache por tempo indeterminado até serem atualizados. Para mais informações, consulte Como usar preços alterados.

Além de atualizar 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 atualizações de preço no momento do leilão com as Consultas de preços em tempo real. As Consultas de preços em tempo real são solicitações do Google relacionadas a preços para um leilão atual. Se você responder dentro do prazo especificado, o anúncio vai aparecer 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 pelo cache em vez de enviar outra consulta de preço em tempo real no futuro.

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

Importante :devido à nova experiência de pesquisa, a consulta em tempo real não está mais disponível para usuários no EEE.

Contexto

As consultas de preços pull e alterados geralmente não especificam informações sobre o usuário, porque 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 possíveis contextos do usuário, um recurso está sendo testado 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 cobrir a grande maioria das solicitações. Você pode ver 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 precisa 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 um tráfego menor.

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

Modo de transferência ARI Push

Com o modo de transferência ARI Push, você envia atualizações incrementais para o Google sempre que as tarifas 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 das informações de preços para o Google.

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

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 eles forem alterados. O modo de transferência Push ARI é compatível com vários tipos de mensagens e estratégias de preços. Para informações detalhadas sobre como enviar mensagens, consulte Como usar ARI.

Os preços serão veiculados pelo Google e vão ficar visíveis para os usuários dentro de 15 a 20 minutos após o recebimento da 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 um HTTP 200 OK se a conexão com o servidor for bem-sucedida. Também inclui um corpo com uma mensagem de resposta indicando se as atualizações foram aplicadas com êxito ou que encontrou avisos ou erros do modo de entrega.

Adicionar endereços IP à lista de permissões

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

Atualizar metadados de salas e pacotes com o ARI Push

Use o tipo de mensagem de transação (dados da propriedade) para definir os tipos de quarto e os planos de tarifa (pacotes) ativos para cada propriedade. Envie 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 do modo de transferência devido ao XML incorreto ou incorreto, encontre a resolução recomendada nas 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

Com o 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 do Pull:

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

As seções abaixo 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 o processo 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ê está usando HTTPS, é necessário ter o domínio 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ç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 o uso de Preços alterados.

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

Atualizar metadados de quartos e pacotes

Além de atualizar os dados de preços com Pull, você também pode usar Mensagens de transação para atualizar 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 preços alterados, 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 ao qual o Google envia mensagens de Hint Request, consulte seu Gerente técnico de contas (TAM). Essa configuração foi definida durante a configuração inicial.

Importante :se você não implementar mensagens Hint Response, as mensagens de consulta do Google solicitam dados para propriedades all identificadas em 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 Hint

As mensagens de Hint Request 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 obter 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 ter a assinatura do domínio por uma autoridade de certificação oficial.
• O cabeçalho Content-Type está definido como application/xml.
• Com uma frequência especificada, o Google envia um carimbo de data/hora ao seu servidor para definir a última vez que você respondeu a uma mensagem de Hint Request.
• 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 de mensagens de Hint Request, entre em contato.

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

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 hotéis e os itinerários das propriedades com preços que foram 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 Hint Response e responde com uma Mensagem de consulta, assim como no modo Pull 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 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 às 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.