Variáveis e condições

Os anúncios de hotéis e os links sem custo financeiro para reserva incluem links para páginas de destino em que os usuários podem reservar quartos. É possível definir como o Google cria o link para incluir todas as informações adicionais sobre o usuário e o itinerário. Por exemplo, é possível incluir informações como o ID do hotel, idioma, códigos de moeda e datas de check-in no URL.

Visão geral

Você define o URL da página de destino no arquivo de páginas de destino. Quando o anúncio ou o link sem custo financeiro para reserva é exibido, as informações dinâmicas no URL são substituídas por valores reais. Para adicionar valores dinâmicos aos URLs das páginas de destino, use a seguinte sintaxe:

<URL>https://partner_url?param_id=(variable_name)</URL>

Os exemplos a seguir mostram um URL que usa os nomes de variáveis do Google em vez do ID e do itinerário do hotel:

Exemplo 1

<URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)
  &amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)
  &amp;checkinYear=(CHECKINYEAR)&amp;nights=(LENGTH)
</URL>

Exemplo 2

<URL>https://www.partnerdomain.com/hotel/(PARTNER-HOTEL-ID)
  &amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)
  &amp;checkinYear=(CHECKINYEAR)&amp;nights=(LENGTH)
</URL>

Quando o link da página de destino é criado para a página de resultados da pesquisa, o Google substitui as variáveis pelos valores reais para garantir que o URL inclua as informações dinâmicas. Por exemplo, se o usuário reservar um quarto por seis noites a partir de 23/05/2023 no hotel 42, o Google vai renderizar o link anterior da seguinte forma:

https://www.partnerdomain.com?hotelID=42&checkinDay=23&checkinMonth=05&checkinYear=2023&nights=6

Os valores que o Google atribui às variáveis na string de consulta dependem dos dados correspondentes no seu feed de preços e de lista de hotéis e nas configurações do usuário.

Por exemplo,o valor da variável LENGTH é atribuído ao elemento <Nights> do feed de preços do itinerário relacionado. Da mesma forma, o valor da variável PARTNER-HOTEL-ID é definido no elemento <id> do feed de lista de hotéis que corresponde aos critérios de pesquisa do usuário.

Algumas variáveis são subconjuntos dos elementos do feed de preços. Por exemplo, as variáveis CHECKINDAY, CHECKINMONTH e CHECKINYEAR são extraídas do único elemento <Checkin> no feed de preços. Outras variáveis são calculadas com base na localidade do usuário e em outras configurações do cliente.

Para mais informações sobre as fontes de valores variáveis, consulte Visão geral de preços e Lista de hotéis.

Variáveis de URL

A tabela a seguir descreve as variáveis disponíveis que podem ser usadas para criar o URL da página de destino:

Lógica condicional em URLs

É possível usar diretivas especiais no elemento <URL> de um arquivo de páginas de destino para criar endpoints condicionalmente.

A lógica condicional oferece suporte às seguintes instruções:

• if_statement: se true, os valores que seguem essa condição são inseridos no URL. Caso contrário, os valores que seguem a diretiva ELSE são inseridos.

• for_statement: cria uma condição de loop FOR que itera no número de valores fornecidos.

As instruções IF e FOR incluem o seguinte:

Exemplo de IF-AD-CLICK

É possível criar um bloco condicional para verificar se o usuário clicou em um anúncio ou link sem custo financeiro para reserva para redirecionar à sua página de destino.

O exemplo a seguir usa essa diretiva em um arquivo de página de destino:

<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)(IF-AD-CLICK)&amp;adType=1(ELSE)&amp;adType=0(ENDIF)</URL>

Neste exemplo, se o usuário não clicar em um anúncio, o resultado será o seguinte URL:

https://www.partner.com?hid=123&adType=0

Se o usuário clicar no anúncio, o resultado será o seguinte URL:

https://www.partner.com?hid=123&adType=1

Exemplo de IF-CLICK-TYPE-HOTEL

É possível criar um bloco condicional que verifica se o usuário selecionou um hotel sem um pacote de quartos explícito. O valor do elemento <RatePlanID> no bloco <Room Bundle> de uma mensagem de transação será definido como o preço do pacote de quartos associado implicitamente que o usuário selecionou.

O exemplo a seguir usa essa diretiva em um arquivo de páginas de destino:

<URL>https://partner.com/(IF-CLICK-TYPE-HOTEL)landing(ELSE)landing_room(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>

Neste exemplo, se o usuário selecionou uma Categoria de quarto, o resultado é o seguinte URL:

https://partner.com/landing_room?hid=123

Se o usuário não selecionar um pacote de quartos, o resultado será o seguinte URL:

https://partner.com/landing?hid=123

Exemplo de IF-CLICK-TYPE-ROOM

É possível criar um bloco condicional que verifica se o usuário selecionou um pacote de quarto.

O exemplo a seguir usa essa diretiva em um arquivo de páginas de destino:

<URL>https://partner.com/(IF-CLICK-TYPE-ROOM)landing_room(ELSE)landing(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>

Nesse exemplo, se o usuário não selecionou um pacote de quartos, o resultado é o seguinte URL:

https://partner.com/landing?hid=123

Se o usuário selecionou uma Categoria de quarto, o resultado é o seguinte URL:

https://partner.com/landing_room?hid=123

Exemplo de IF-DEFAULT-DATE

Use a instrução condicional IF-DEFAULT-DATE para definir um parâmetro sem data que seu site possa usar para acionar um comportamento personalizado se o usuário não tiver selecionado uma data.

O exemplo a seguir verifica se a data padrão foi usada:

<URL>https://partner.com?hotelID=(PARTNER-HOTEL-ID)&amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)&amp;checkinYear=(CHECKINYEAR)&amp;nights=(LENGTH)<strong>(IF-DEFAULT-DATE)</strong>&amp;popup_datepicker=true(ELSE)&amp;popup_datepicker=false(ENDIF)</URL>

Neste exemplo, se o usuário não selecionar uma data, o resultado poderá ser semelhante ao URL abaixo, que mostra as seleções de data padrão:

https://partner.com?hotelID=123&checkinDay=23&checkinMonth=05&checkinYear=2023&nights=1&popup_datepicker=true

Se o usuário tiver selecionado uma data, o resultado poderá ser semelhante ao URL a seguir, dependendo do itinerário escolhido:

https://partner.com?hotelID=123&checkinDay=23&checkinMonth=05&checkinYear=2023&nights=2&popup_datepicker=false

Exemplo de IF-HOTEL-CAMPAIGN (cliques em anúncios de hotéis e links para reserva sem custo)

É possível criar um bloco condicional para verificar se o usuário clicou em um anúncio de uma campanha de hotel.

O exemplo a seguir usa essa diretiva em um arquivo de página de destino:

<URL>https://partner.com?hotelID=(PARTNER-HOTEL-ID)(IF-HOTEL-CAMPAIGN)&amp;hotel_campaign=(CAMPAIGN-ID)(ELSE)utm_campaign=(CAMPAIGN-ID)(ENDIF)</URL>

Nesse exemplo, se o usuário clicar em um URL de campanha de hotel, o resultado será o seguinte URL:

https://www.partner.com?hotelID=123&hotel_campaign=12345678

Se o clique não for em um URL de campanha de hotel (por exemplo, uma campanha de pesquisa padrão), o resultado será este URL:

https://www.partner.com?hotelID=123&utm_campaign=87654321

Isso é útil quando você quer distinguir o tráfego de cliques da campanha de hotéis de outros cliques.

CAMPAIGN-IDs em branco com cliques de FBL

Se o clique for de um link sem custo financeiro para reserva, IF-HOTEL-CAMPAIGN vai retornar TRUE e o valor de CAMPAIGN-ID será definido como em branco, conforme mostrado no seguinte URL:

https://www.partner.com?hotelID=123&hotel_campaign=

É possível usar a instrução condicional IF-AD-CLICK para evitar que o ID da campanha fique em branco, como mostrado no exemplo abaixo:

<URL>https://partner.com?hotelID=(PARTNER-HOTEL-ID)(IF-HOTEL-CAMPAIGN)(IF-AD-CLICK)&amp;hotel_campaign=(CAMPAIGN-ID)(ELSE)&amp;FreeBookingLink(ENDIF)(ELSE)utm_campaign=(CAMPAIGN-ID)(ENDIF)</URL>

Exemplo de IF-PAYMENT-ID (somente Anúncios de hotéis)

Use a instrução condicional IF-PAYMENT-ID para variar o URL com base no resultado do clique no programa de comissões PPS. O exemplo abaixo verifica se um clique veio do programa de comissões PPS e atribui um valor ao parâmetro booking_source com base no resultado:

<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)&amp;booking_source=(IF-PAYMENT-ID)(PAYMENT-ID)(ELSE)cpc(ENDIF)</URL>

Se o hotel fizer parte do programa de comissões, o resultado será um dos seguintes URLs:

• Se nenhum número IATA foi atribuído ao Google:

  https://partner.com?hid=123&booking_source=commissions

• Se um número IATA foi atribuído ao Google:

  https://partner.com?hid=123&booking_source=01234567

Caso contrário, o resultado será o seguinte URL:

https://partner.com?hid=123&booking_source=cpc

Exemplo de IF-PROMOTED (somente anúncios de hotéis)

É possível criar um bloco condicional para verificar se o usuário clicou em um anúncio de promoção de propriedade.

O exemplo a seguir usa essa diretiva em um arquivo de páginas de destino:

<URL>https://partner.com/(IF-PROMOTED)1(ELSE)0(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>

Neste exemplo, se o usuário selecionou um anúncio de promoção de propriedade, o resultado é o seguinte URL:

https://partner.com/1?hid=123

Se o usuário não selecionar um anúncio de promoção de propriedade, o resultado será o seguinte URL:

https://partner.com/0?hid=123

Exemplo de IF-RATE-RULE-ID

É possível criar um bloco condicional que verifica se o usuário selecionou uma tarifa condicional. Se esse for o caso, o valor do elemento <RateRuleID> no bloco <Rate> da mensagem de transação será usado.

O exemplo a seguir usa essa diretiva em um arquivo de páginas de destino:

<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)(IF-RATE-RULE-ID)&amp;customerType=42(ELSE)(ENDIF)</URL>

Neste exemplo, se o usuário não selecionou uma tarifa condicional, o resultado é o seguinte URL:

https://www.partner.com?hid=123

Se o usuário selecionou uma tarifa condicional, o resultado é o seguinte URL:

https://www.partner.com?hid=123&customerType=42

Exemplo de IF-USER-LIST-ID (definido no Google Ads)

Se você definir multiplicadores de lance para listas de público-alvo em uma campanha de hotéis no Google Ads, é possível usar IF-USER-LIST-ID em conjunto com USER-LIST-ID para definir um parâmetro no seu site para um cliente que pertence a uma determinada lista de público-alvo do Google Ads. Você pode fazer isso para fins de rastreamento ou para personalizar seu site para membros de listas de público-alvo.

<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)(IF-USER-LIST-ID)&amp;audience_list=(USER-LIST-ID)(ELSE)(ENDIF)</URL>

Neste exemplo, se o usuário não for membro de uma lista de público-alvo, o resultado será o seguinte URL:

https://www.partner.com?hid=123

Se o usuário era membro da lista de público-alvo 12345678, o resultado é o seguinte URL:

https://www.partner.com?hid=123&audience_list=12345678

Exemplo de IF-VERIFICATION

Se você precisar verificar se o Google gerou o URL para testes ou validação automatizada, use IF-VERIFICATION.

<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)(IF-VERIFICATION)&amp;isgoogle=true(ENDIF)</URL>

Neste exemplo, se o Google não gerar o URL para teste ou validação, o resultado será o seguinte URL:

https://www.partner.com?hid=123

Se o Google gerou o URL para teste ou validação, o resultado será o seguinte URL:

https://www.partner.com?hid=123&isgoogle=true

Exemplo de FOR-EACH-CHILD-AGE

Você pode criar um bloco condicional que preencha a idade máxima de cada ocupante menor, conforme especificado no Feed de preços de hotéis.

O exemplo a seguir usa essa diretiva em um arquivo de páginas de destino:

<URL>https://partner.com?adults=(NUM-ADULTS)&amp;children=(NUM-CHILDREN)(FOR-EACH-CHILD-AGE)&amp;age=(CHILD-INDEX)_(CHILD-AGE)(END-FOR-EACH)&amp;hid=(PARTNER-HOTEL-ID)&amp;</URL>

Neste exemplo, se o itinerário tiver dois adultos e duas crianças com idades de 0 e 17 anos, respectivamente, o resultado será o seguinte URL:

https://www.partner.com?adults=2&children=2&age=0_0age=1_17&hid=123

Se o itinerário tiver dois adultos e nenhuma criança, o resultado será o seguinte URL:

https://www.partner.com?adults=2&children=0&hid=123

Regras gerais ao criar URLs

Todas as variáveis são opcionais. Não é necessário inserir variáveis no URL da sua página de destino. No entanto, o uso de variáveis para transmitir informações de itinerário e do usuário geralmente cria uma experiência melhor para o usuário e ajuda você a se conformar com as políticas do Google.

As seguintes regras gerais se aplicam ao definir URLs construídos em um arquivo de páginas de destino:

• Todas as variáveis são cercadas por parênteses de abertura e fechamento.

• Os parâmetros da string de consulta precisam ser separados por um "&" na saída final. Porque o caractere & é um caractere especial no XML e o formato do arquivo de páginas de destino é XML. Portanto, use a entidade codificada "&" no lugar dela. A saída final renderiza um caractere "&" real. Exemplo:

  <!-- Do this: -->
  <URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)&amp;nights=(LENGTH)</URL>
  
  <!-- Do NOT do this: -->
  <URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)&nights=(LENGTH)</URL>
  

  Você também precisa codificar caracteres especiais que pode incluir no URL da página de destino. Exemplo:

  • space (" "): substitua os caracteres de espaço por "%20;" no elemento <URL>
  • barra ("/"): substitua as barras com "%2F;" no elemento <URL>

  Nem todos os caracteres não alfabéticos precisam ser codificados para uso em URL. Por exemplo, hifens ("-") não precisam ser codificados como URL. Para uma lista de caracteres comuns que precisam ser codificados por URL, consulte Codificação de URL.

• Os valores de um único parâmetro podem ser criados a partir de várias variáveis. O exemplo a seguir constrói um único parâmetro, checkinDate, das variáveis CHECKINDAY, CHECKINMONTH e CHECKINYEAR:

  <URL>https://www.partnerdomain.com?checkinDate=(CHECKINDAY)%2F;(CHECKINMONTH)%2F;(CHECKINYEAR)</URL>
  

  Esse exemplo resulta em um URL semelhante a este:

  https://www.partnerdomain.com?checkinDate=7/23/1971
  

• É possível usar qualquer ID para o nome dos parâmetros da string de consulta. Seu servidor processa esses valores. No entanto, os valores transmitidos são limitados à lista de variáveis disponíveis.

• É possível usar até cinco variáveis personalizadas além da lista de variáveis disponíveis.