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 onde os usuários podem reservar quartos. É possível definir como o link é criado pelo Google 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 nomes de variáveis do Google em vez do ID do hotel e do itinerário reais:

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 para 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 feed de preços de hotéis, no feed 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 de 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 correspondeu 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 de 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

Você pode usar diretivas especiais no elemento <URL> de um arquivo de páginas de destino para criar endpoints condicionalmente.

A lógica condicional é compatível com as seguintes instruções:

• if_statement: se true, os valores que seguem essa condição serão inseridos no URL. Caso contrário, os valores que seguem a diretiva ELSE serã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 bloqueio condicional para verificar se o usuário clicou em um anúncio ou link sem custo financeiro para reserva e redirecionar para 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 clicou em um anúncio, o resultado é o seguinte URL:

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

Se o usuário clicou no anúncio, o resultado é o seguinte URL:

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

Exemplo de IF-CLICK-TYPE-HOTEL

É possível criar um bloqueio condicional para verificar se o usuário selecionou um hotel sem um pacote de quarto 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 quarto implicitamente associado 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 bloqueio condicional para verificar se o usuário selecionou um pacote de quartos.

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>

Neste exemplo, se o usuário não selecionar um pacote de quarto, o resultado será 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 que não seja de data e que seu site possa usar para acionar um comportamento personalizado se o usuário não selecionar 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 seguinte URL, 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 seguinte URL, 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 hotel e links sem custo financeiro para reserva)

É possível criar um bloqueio 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>

Neste 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

Quando o clique não é em um URL de campanha de hotel (por exemplo, uma campanha de pesquisa padrão), o resultado é 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 hotel de qualquer outro clique.

IDs de campanha 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 URL a seguir:

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

Você pode usar a instrução condicional IF-AD-CLICK para evitar um ID de campanha em branco, como mostrado no exemplo a seguir:

<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-PROMOTED (somente anúncios de hotéis)

É possível criar um bloqueio 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

Você pode criar um bloco condicional que verifica se o usuário selecionou uma tarifa condicional e, se 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 selecionar uma tarifa condicional, o resultado será 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 lances para listas de público-alvo em uma campanha de hotel no Google Ads, poderá usar IF-USER-LIST-ID 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. Isso pode ser feito 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 fosse membro de uma lista de público-alvo, o resultado seria 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 teste 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 é o seguinte:

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

Exemplo de FOR-EACH-CHILD-AGE

Você pode criar um bloco condicional que preenche a idade máxima de cada ocupante criança, 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 tivesse dois adultos e duas crianças com idades de 0 e 17 anos, respectivamente, o resultado seria o seguinte URL:

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

Se o itinerário tiver 2 adultos e 0 crianças, 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 página de destino. No entanto, usar 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 obedecer às 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 estão entre parênteses de abertura e fechamento.

• Os parâmetros da string de consulta precisam ser separados por um e comercial ("&") na saída final. Porque o e comercial é um caractere especial em XML e o formato de arquivo das páginas de destino é XML. Portanto, use a entidade codificada "&" no lugar dele. 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>
  

  Também é necessário codificar para uso em URL os caracteres especiais que você incluir no URL da página de destino. Exemplo:

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

  Nem todos os caracteres não alfabéticos precisam ser codificados para URL. Por exemplo, hífens ("-") não precisam ser codificados em 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 construídos com várias variáveis. O exemplo a seguir cria um único parâmetro, checkinDate, das variáveis CHECKINDAY, CHECKINMONTH e CHECKINYEAR:

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

  Este exemplo resulta em um URL semelhante a este:

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

• Você pode usar qualquer ID para o nome dos parâmetros de 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.