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 salas. Você pode definir como o Google cria o link para incluir informações adicionais sobre o usuário e seu itinerário. Por exemplo: é possível incluir informações como 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 a atividade 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 da página de destino, use o método seguinte sintaxe:

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

O exemplo a seguir mostra um URL que usa nomes de variáveis do Google em vez de ID do hotel e itinerário:

<URL>https://www.partnerdomain.com?hotelID=(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 de pesquisa, o Google substitui as variáveis pelos valores reais para garantir que o URL inclua os informações dinâmicas. Por exemplo, se o usuário reservar um quarto para 6 noites a partir de 23/05/2023 para o 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 do dados correspondentes em seu Feed de preços para hotéis, Feed de lista de hotéis e configurações de 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 A variável PARTNER-HOTEL-ID é definida no elemento <id> da lista de hotéis Feed 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, o 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 e em outras configurações de cliente do usuário.

Para mais informações sobre as origens dos valores das variáveis, consulte Informações gerais de preços e Lista de hotéis.

Variáveis de URL

A tabela a seguir descreve as variáveis disponíveis que você pode usar para construir 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 é compatível com as seguintes instruções:

• if_statement: se for true, os valores que seguem essa são inseridos no URL. Caso contrário, os valores após a A diretiva ELSE é inserida.

• for_statement: cria uma condição de repetição FOR que se repete. com base 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 que verifica 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 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 bloco condicional que verifica se o usuário selecionou um hotel sem uma Categoria de quarto explícita. O valor do elemento <RatePlanID> na O bloco <Room Bundle> de uma Mensagem de transação será definido como o preço da categoria de quarto associada 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 uma Categoria de quarto, 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 Room. Grupo

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 selecionou uma Categoria de quarto, o resultado é o seguinte URL:

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

Se o usuário tiver selecionado uma Categoria de quarto, o resultado será 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 que seu site poderá 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 selecionou uma data, o resultado pode ser semelhante ao seguinte URL que mostra 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 a este URL: dependendo do itinerário selecionado:

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

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

É possível construir um bloco condicional que verifica se o usuário clicou em um anúncio que originou-se 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 no URL de uma campanha de hotel, o resultado será a seguinte URL:

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

Se o clique não for no URL de uma campanha de hotel (por exemplo, uma campanha de pesquisa normal), o resultado é o seguinte URL:

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

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

IDs de CAMPANHA em branco com cliques do FBL

Se o clique for de um link sem custo financeiro para reserva, IF-HOTEL-CAMPAIGN retorna Os valores TRUE e CAMPAIGN-ID são definidos em branco, conforme mostrado neste URL:

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

Você pode usar a instrução condicional IF-AD-CLICK para evitar que o ID da campanha esteja em branco, como 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-PAYMENT-ID (somente para anúncios de hotéis)

Use a instrução condicional IF-PAYMENT-ID para variar o URL com base em o clique é resultado do programa de comissões de PPS ou não. O exemplo abaixo verifica se um clique veio do programa de comissões de PPS e atribui um valor a o 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 faz parte do Programa de comissões, o resultado é um dos seguintes URLs:

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

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

• Se um número IATA tiver sido 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 hotel)

É possível construir um bloco condicional que verifica 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 tiver selecionado 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 construir um bloco condicional que verifica se o usuário selecionou tarifa condicional e, se esse for o caso, o valor de <RateRuleID> no bloco <Rate> da mensagem de transação é 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 será o seguinte URL:

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

Se o usuário selecionou uma tarifa condicional, o resultado será 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 hotel no Google Ads, você pode usar IF-USER-LIST-ID com USER-LIST-ID para definir um no seu site para um cliente que pertence a uma determinada conta do Google Ads lista de público-alvo. Faça isso para fins de rastreamento ou para personalizar para membros das 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 era membro de uma lista de público-alvo, o resultado é o seguinte URL:

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

Se o usuário fizer parte da lista de público-alvo 12345678, o resultado será o seguinte URL:

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

Exemplo de IF-VERIFICATION

Caso você precise verificar se o Google gerou o URL para teste ou automatizou validação, use IF-VERIFICATION.

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

Nesse exemplo, se o Google não gerou o URL para teste ou validação, o resultado é 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

É possível construir um bloco condicional que preencha a idade máxima de cada ocupante secundário, conforme especificado no Feed de preços para 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 tinha dois adultos e duas crianças com idades de 0 a 17 anos respectivamente, o resultado é 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 para a criação de URLs

Todas as variáveis são opcionais. Não é obrigatório inserir nenhuma variável no seu URL da página de destino. No entanto, usar variáveis para transmitir itinerários e informações geralmente criam uma melhor experiência para o usuário e ajudam você a a conformidade com as políticas do Google.

As regras gerais a seguir se aplicam ao definir URLs criados em uma página de destino arquivo de páginas:

• Todas as variáveis ficam entre parênteses.

• Os parâmetros de string de consulta só podem ser passados após o ponto de interrogação ("?") no URL.

• Os parâmetros da string de consulta devem ser separados por um "e" comercial ("&") no a saída final. Como o E comercial é um caractere especial em XML, o formato de arquivo das páginas de destino é XML. Portanto, você deve usar a entidade codificada "&" no lugar. A saída final renderiza um "&" real caractere. 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 deve codificar os caracteres especiais para URL que podem ser incluídos no URL da página de destino. Exemplo:

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

  Nem todos os caracteres não alfabéticos precisam ser codificados por URL. Por exemplo: Os hifens ("-") não precisam ter codificação de URL. Para uma lista de vulnerabilidades que devem ter codificação de URL, consulte Tabela de codificação de URL.

• Os valores de um único parâmetro podem ser construídos a partir de diversas variáveis. A o exemplo a seguir constrói um único parâmetro, checkinDate, a partir da Variáveis CHECKINDAY, CHECKINMONTH e CHECKINYEAR:

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

  Este exemplo resulta em um URL que pode ser semelhante ao seguinte:

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

• Você pode usar qualquer ID para o nome dos parâmetros da string de consulta. Seu servidor processa esses valores. No entanto, os valores que você passa são limitados ao lista de variáveis disponíveis.

• Você pode usar até cinco variáveis personalizadas além da lista de variáveis disponíveis variáveis.