Esta página foi traduzida pela API Cloud Translation.

Variáveis e condições

Os anúncios de hotéis e os links gratuitos 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 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 real:

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 dos 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 criar o URL da página de destino:

Variável	Recomendada/opcional	Descrição
ADVANCE-BOOKING-WINDOW	Optional	O número de dias de reserva antecipada antes da data do check-in no fuso horário do hotel no momento da reserva. Por exemplo, `36`.
ALTERNATE-HOTEL-ID	Recommended (if you have separate IDs to identify properties versus booking engines)	Um identificador alternativo para sua propriedade. Esse nome do atributo é especificado no seu feed de lista de hotéis. Esses IDs são úteis quando você precisa de um identificador de propriedade para as informações do feed e outro para o mecanismo de reservas.
CAMPAIGN-ID	Recommended	O ID da campanha do Google Ads que você quer associar ao URL. Ele ficará em branco se o clique não estiver associado a uma campanha do Google Ads.
CHECKINDAY	Recommended	O dia com dois dígitos definido no elemento `<Checkin>` do Feed de preços para hotéis. Por exemplo, `20`.
CHECKINDAY-OF-WEEK	Optional	O dia da semana (de `Monday` a `Sunday`), quando o check-in ocorre, no fuso horário do hotel. Por exemplo, `Tuesday`.
CHECKINMONTH	Recommended	O mês com dois dígitos definido no elemento `<Checkin>` do Feed de preços para hotéis. Por exemplo, `05`.
CHECKINYEAR	Recommended	O ano com quatro dígitos definido no elemento `<Checkin>` do Feed de preços para hotéis. Por exemplo, `2023`.
CHECKOUTDAY	Recommended	O dia de dois dígitos calculado com base nos elementos `<Nights>` e `<Checkin>` do feed de preços de hotéis. Por exemplo, `26`.
CHECKOUTMONTH	Recommended	O mês com dois dígitos calculado a partir dos elementos `<Nights>` e `<Checkin>` do Feed de preços para hotéis. Por exemplo, `05`.
CHECKOUTYEAR	Recommended	O ano de quatro dígitos calculado com base nos elementos `<Nights>` e `<Checkin>` do feed de preços de hotéis. Por exemplo, `2023`.
CHILD-AGE	Recommended (must be provided for child occupancy pricing)	A idade máxima de cada filho, conforme especificada nos elementos `<Child "age">` do feed de preços. Essa variável precisa ser usada com um bloco condicional `FOR-EACH-CHILD-AGE`.
CHILD-INDEX	Optional	Uma variável de loop com índice 0 que representa um contador para cada ocupante e idade da criança especificada no itinerário. Embora não seja obrigatória, essa variável só pode ser usada em conjunto com um bloco condicional `FOR-EACH-CHILD-AGE`.
CLICK-TYPE	Optional	Indica se o usuário clicou na listagem de uma tarifa de hotel padrão ou em uma Categoria de quarto. Os valores possíveis são: `hotel`: o usuário clicou na ficha da empresa para pagar uma diária padrão. `room`: o usuário clicou na listagem de uma Categoria de quarto.
CLOSE-RATE-RULE-IDS	Optional (only applies if you are using conditional or private rates)	Uma lista separada por vírgulas de IDs de regras de tarifação para tarifas que estavam indisponíveis, mas que poderiam estar disponíveis se o usuário tivesse realizado uma pequena ação. Os IDs de regras de tarifação para tarifas exclusivas sempre serão preenchidos aqui quando um tratamento de interface correspondente for mostrado ao usuário.
CUSTOM[1-5]	Optional	Os valores dos campos personalizados definidos no elemento `<Result>` com limite de 200 caracteres por campo personalizado. Para mais informações, consulte Visão geral das Mensagens de transação. Os campos personalizados não estão disponíveis ao usar o ARI.
DATE-TYPE	Optional	Indica se o usuário selecionou a data padrão ou uma data específica fornecida na pesquisa. Os valores possíveis são: `default`: o usuário clicou em um anúncio de hotel ou em um link sem custo financeiro para reserva em que as datas padrão foram usadas. `selected`: o usuário clicou em um anúncio de hotel ou em um link sem custo financeiro para reserva com as datas definidas.
GOOGLE-ADS-CLICK-SOURCE	Optional	Indica que o Google Ads foi a origem do clique. Os valores possíveis são: `bl`: links pagos para reserva `tpa`: anúncios de promoções de viagem `tfsa`: feeds de viagem nos anúncios de pesquisa `pm`: campanhas Performance Max ou Performance Max para metas de turismo. Observação:se o clique tiver sido originado da Pesquisa Google e não do Google Ads, esse parâmetro estará vazio
GOOGLE-SITE	Optional	A propriedade do Google em que um usuário visualizou os dados de preços do seu hotel. Os valores possíveis são: `localuniversal`: o usuário encontrou o link de reserva de hotel pela pesquisa `google.com`. `mapresults`: o usuário encontrou o link para reserva de hotel pelo `maps.google.com`. `verification`: o Google usa esse valor ao realizar testes automatizados de qualidade de dados no seu site. Essas consultas não são cobradas. O Google Analytics pode usar esse parâmetro e o valor dele para identificar o tráfego de verificação automatizada de anúncios de hotéis. `unknown`: o usuário encontrou o anúncio ou o link sem custo financeiro para reserva por uma origem indeterminada.
LENGTH	Recommended	A duração da estadia em termos do número de noites definido pelo elemento `<Nights>` no feed de preços de hotéis. Por exemplo, `3`.
NUM-ADULTS	Recommended (must be used with the `NUM-CHILDREN` or `FOR-EACH-CHILD-AGE` condition)	O número de ocupantes adultos especificado pelo usuário para o itinerário. Essa variável precisa ser usada com `NUM-CHILDREN`, `FOR-EACH-CHILD-AGE` ou ambos.
NUM-CHILDREN	Recommended	O número de ocupantes crianças (0 a 17 anos) especificado no itinerário pelo usuário. `NUM-CHILDREN`, `FOR-EACH-CHILD-AGE` ou ambos são necessários para participar de itinerários com crianças.
NUM-GUESTS	Recommended (if you don't send child occupancy pricing)	O número total de ocupantes, adultos e crianças, especificado pelo usuário para o itinerário. Esse valor é uma soma dos valores `NUM-ADULTS` e `NUM-CHILDREN`. Para maximizar a participação, é altamente recomendável usar `NUM-ADULTS` e `NUM-CHILDREN`.
PACKAGE-ID	Recommended (applies if you use Room Bundles)	O identificador único do pacote no Feed de preços para hotéis. Para um pacote padrão, o ID do pacote é o valor do elemento `<PackageID>` em um bloco `<Result>`. Para uma Categoria de quarto, o ID do pacote é o valor do elemento `<PackageID>` dentro dos blocos `<RoomBundle>` ou `<PackageData>` da Mensagem de transação.
PARTNER-CURRENCY	Optional	O código da moeda de três letras definido pelo atributo `currency` do elemento `<Baserate>` no Feed de preços para hotéis. Por exemplo, `USD` ou `CAD`.
PARTNER-HOTEL-ID	Recommended	O identificador exclusivo do hotel definido pelo elemento `<id>` no feed de lista de hotéis.
PARTNER-ROOM-ID	Recommended (applies if you use Room Bundles)	O identificador exclusivo do quarto no Feed de preços para hotéis. Para um quarto padrão, o código do quarto é um valor do elemento `<RoomID>` dentro do bloco `<Result>`. Para um pacote de quartos, o ID do quarto é o valor atribuído ao elemento `<RoomID>` nos blocos `<RoomBundle>` ou `<RoomData>` na mensagem de transação.
PAYMENT-ID	Optional (only applies to Ads)	Resolve como uma string predefinida `commission` ou o número IATA atribuído pelo Google (por exemplo, "01234567"), se você usa uma agência de cobrança de comissões. Para mudar a formatação do número IATA ou da string predefinida, entre em contato com o Gerente técnico de contas (TAM).
PRICE-DISPLAYED-TAX	(Optional)	O valor do imposto exibido para o usuário na moeda local dele. O valor de `PRICE-DISPLAYED-TAX` é o valor do elemento `<Tax>` no feed de preços para hotéis. Por exemplo, "3,14".
PRICE-DISPLAYED-TOTAL	(Optional)	O custo total do quarto que é exibido para o usuário na moeda local dele. O valor de `PRICE-DISPLAYED-TOTAL` é a soma dos elementos `<Baserate>`, `<Tax>` e `<OtherFees>` do Feed de preços para hotéis. Por exemplo, "152,13".
PROMO-CODE	(Optional)	Se você usa promoções de ARI (link em inglês), o valor dessa variável é atribuído ao atributo `id` da `<Promotion>` aplicada. Se várias promoções forem aplicadas, será uma lista separada por vírgulas de IDs de promoção em uma ordem arbitrária. Se você usar regras de taxa, o valor dessa variável será atribuído ao elemento `PromoCode` se a regra de taxa correspondente for aplicada.
RATE-PLAN-ID	Recommended (only applies if you use RoomBundles)	O ID, conforme definido pelo elemento `<RatePlanID>` no bloco `<RoomBundle>` de um feed de preços. O `<RatePlanID>` representa o identificador exclusivo de uma combinação de dados de quarto e pacote. Para mais informações, consulte Pacotes de quarto.
RATE-RULE-ID	Recommended (only applies if you use conditional rates or private rates)	O ID, conforme definido pelo atributo `rate_rule_id` no bloco `<Rate>` de um feed de preços. Para mais informações, consulte Tarifas condicionais. Observação: somente as tarifas condicionais ou exclusivas que não estão ocultas são mostradas.
USER-COUNTRY	Recommended	Um código de país de duas letras que indica a localização do usuário. Essas informações são extraídas das configurações do cliente do usuário. Por exemplo, `US` ou `FR`.
USER-CURRENCY	Recommended	Um código de moeda de três letras que indica a moeda local do usuário. O valor da variável `USER-CURRENCY` é inferido das configurações do cliente do usuário. Por exemplo, `USD` ou `CAD` .
USER-DEVICE	Recommended	O tipo de dispositivo do usuário. O valor de `USER-DEVICE` pode ser um dos seguintes: `mobile` `tablet` `desktop` `unknown` O valor da variável `USER-DEVICE` é inferido das configurações do cliente do usuário.
USER-LANGUAGE	Recommended	Um código de idioma ISO 639-1 de duas letras que especifica o idioma de exibição do anúncio ou do link gratuito para reserva. O valor da variável `USER-LANGUAGE` é inferido com base nas configurações de cliente do usuário. Por exemplo, `en` ou `fr`.
USER-LIST-ID (definido no Google Ads)	Optional (only applies if you use Audience Lists in Google Ads)	O ID da lista de usuários do Google Ads que contém a lista de público-alvo ou as informações do usuário. As listas de público-alvo são usadas como base para definir ajustes de lance. Se o usuário fizer parte de várias listas de público-alvo, a lista com o maior ajuste de lance será selecionada. Os vínculos entre os públicos-alvo com o maior ajuste de lance são decididos aleatoriamente.
VERIFICATION	Optional	Um booleano que verifica se o link foi gerado pelo Google para teste ou validação automatizada. Será `true` se o link tiver sido gerado pelo Google para teste ou validação automatizada. Caso contrário, será `false`.

Lógica condicional em URLs

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

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

if_statement: se for 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 repetição FOR que faz a iteração do número de valores fornecidos.

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

Condição	Recomendada/opcional	Descrição
IF-AD-CLICK (somente anúncios de hotel)	Optional	Resolve para `true` se o clique do usuário tiver origem em um anúncio. É resolvido como `false` se o clique do usuário foi originado de um link sem custo financeiro para reserva.
IF-CLICK-TYPE-HOTEL	Optional	É resolvido como `true` se o usuário clicou em uma página de detalhes de um hotel. Caso contrário, é resolvido como `false`.
IF-CLICK-TYPE-ROOM	Optional	É resolvido como `true` se o usuário clicou em uma listagem de um Pacote de quartos. Caso contrário, é resolvido como `false`.
IF-CLOSE-RATE-RULE-IDS	Optional	Vai ser resolvido como `true` se uma ou mais tarifas condicionais não estiverem disponíveis porque o usuário não estava qualificado. Caso contrário, será resolvida como `false`. Por padrão, será `true` se um tratamento de interface com tarifa particular for mostrado ao usuário.
IF-DEFAULT-RATE	Optional	É resolvido como `true` se o usuário clicou em uma listagem de hotéis em que as datas padrão foram usadas. Caso contrário, é resolvido como `false`.
IF-HOTEL-CAMPAIGN	Optional	É resolvido como `true` se o clique do usuário é originado de uma campanha de hotel. Caso contrário, é resolvido para `false`. Essa distinção é útil para parceiros que têm vários tipos de campanha no Google Ads para alocar a atribuição.
IF-PAYMENT-ID (somente anúncios de hotel)	Recommended (if you use pay-per-stay Google Ads campaigns)	É resolvido como `true` para hotéis no programa de comissões de pagamento por estadia (PPS). Caso contrário, é resolvido como `false`.
IF-PROMO-CODE	Optional	É resolvido como `true` se o usuário clicou em uma tarifa baseada em uma promoção ARI ou em uma regra de tarifação com um determinado `PromoCode`. Caso contrário, é resolvida como `false`.
IF-PROMOTED (somente anúncios de hotel)	Recommended (if you use Promoted hotels)	É resolvido como `true` se o usuário clicou em um anúncio de promoção de propriedade. Caso contrário, é resolvido como `false`.
IF-RATE-RULE-ID	Optional	É resolvido como `true` se o usuário selecionou uma tarifa condicional . Caso contrário, é resolvido como `false`.
IF-USER-LIST-ID (definido no Google Ads)	Optional	Vai ser resolvido como `true` se o usuário for membro de um ID da lista de clientes do Google Ads que você especificou ao definir multiplicadores de lance para listas de público-alvo. Caso contrário, será resolvido como `false`.
IF-VERIFICATION	Optional	É resolvido como `true` se o link foi gerado pelo Google para teste ou validação automatizada. Caso contrário, é resolvido como `false`.
ELSE	Recommended (if you use any conditional IF statements)	Se a condição anterior não for atendida, os valores que seguirem essa condição serão inseridos no URL.
END-IF	Optional (required if you have any IF conditional statements)	Encerra o bloco condicional da instrução `IF`.
FOR-EACH-CHILD-AGE	Optional (required for child occupancy pricing)	É executada uma vez para cada elemento de `<Child "age">` no feed de preços. Por exemplo, se a `<OccupancyDetails>` incluir os dois elementos `<Child age="17">` e `<Child age= "17">`, a diretiva será executada duas vezes.
END-FOR-EACH	Optional (required if using FOR-EACH block)	Encerra o bloco condicional da instrução `FOR-EACH`.

Exemplo de IF-AD-CLICK

É possível criar um bloco condicional para verificar se o usuário clicou em um anúncio ou link gratuito 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 clicar no anúncio, o resultado será o seguinte URL:

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

Exemplo de IF-CLICK-TYPE-HOTEL

Você pode 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> no bloco <Room Bundle> de uma mensagem de transação será definido como o preço do pacote de quartos 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 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 Bundle.

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 poderá 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 a seguir, 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 selecionou uma data, o resultado pode ser semelhante ao seguinte 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 (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>

Neste exemplo, se o usuário clica no URL de uma campanha de hotel, o resultado é o seguinte:

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 hotel de outros cliques.

IDs de CAMPANHA em branco com cliques do FBL

Se o clique for de um link gratuito 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 para 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 do PPS. O exemplo abaixo verifica se um clique veio do programa de comissões de 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 para anúncios de hotel)

É possível criar 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 será 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 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, será possível 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. 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 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 será o seguinte URL:

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

Exemplo de FOR-EACH-CHILD-AGE

Você pode construir um bloco condicional que preencha a idade máxima de cada ocupante infantil, 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 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á este 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 URL da página de destino. No entanto, o uso de variáveis para transmitir informações de itinerário e usuário geralmente cria uma experiência melhor e ajuda a cumprir as políticas do Google.

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

Todas as variáveis ficam entre parênteses.
Os parâmetros da string de consulta precisam ser separados por um "e" comercial ("&") na saída final. Porque o símbolo & é um caractere especial no XML e o formato de arquivo das páginas de destino é XML. Portanto, use a entidade codificada "&" no lugar dela. A saída final renderiza um caractere "&" real. Exemplo:
```

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


<URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)&nights=(LENGTH)</URL>
```
Você também precisa codificar caracteres especiais 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;" 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 cria um único parâmetro, checkinDate, a partir 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 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ê transmite são limitados à lista de variáveis disponíveis.
Você pode usar até cinco variáveis personalizadas, além da lista de variáveis disponíveis.