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. 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 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 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>

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 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 um ú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 origens dos valores das 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:

Variável Recomendada/opcional Descrição
ADVANCE-BOOKING-WINDOW Optional O número de dias de antecedência com que a reserva é feita antes da data de 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 de atributo é especificado no seu feed de lista de hotéis. Ter IDs separados é útil se você precisa de um identificador de propriedade para as informações do seu feed e outro identificador de propriedade do seu mecanismo de reserva.
CAMPAIGN-ID Recommended O ID da campanha do Google Ads que você quer associar ao URL. Este campo ficará em branco se o clique não estiver associado a uma conta do Google Ads. campanha.
CHECKINDAY Recommended O dia de 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 <Checkin> do Feed de preços para hotéis. Por exemplo, 05.
CHECKINYEAR Recommended O ano com quatro dígitos definido no <Checkin> do Feed de preços para hotéis. Por exemplo, 2023.
CHECKOUTDAY Recommended O dia com dois dígitos calculado a partir de <Nights> e <Checkin> elementos do Feed de preços para hotéis. Por exemplo, 26.
CHECKOUTMONTH Recommended O mês de dois dígitos calculado com base nos elementos <Nights> e <Checkin> do feed de preços para hotéis. Por exemplo, 05.
CHECKOUTYEAR Recommended O ano com quatro dígitos calculado do <Nights> e elementos <Checkin> do Feed de preços para hotéis. Por exemplo, 2023.
CHILD-AGE Recommended (must be provided for child occupancy pricing) A idade máxima de cada criança, 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ório, 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 listagem de um padrão diária.
  • room: o usuário clicou na listagem de uma sala Grupo
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 as tarifas que foram indisponível, mas poderia estar disponível se o usuário tivesse realizado uma pequenas ações. Os IDs de regras de tarifas para tarifas exclusivas são sempre preenchidos aqui quando um tratamento de IU correspondente é 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 do produto, consulte Visão geral de 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 data fornecida na pesquisa. Os valores possíveis são:
  • default: o usuário clicou em um anúncio de hotel ou em um anúncio sem custo financeiro link para reserva em que as datas padrão foram usadas.
  • selected: o usuário clicou em um anúncio de hotel ou em um anúncio sem custo financeiro link 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 origem na Pesquisa Google, e não no Google Ads, esse parâmetro vai estar vazio.
GOOGLE-SITE Optional A propriedade do Google em que um usuário visualizou os dados de preço do seu hotel. Os valores possíveis são:
  • localuniversal: o usuário encontrou o link para reserva de hotel pela pesquisa google.com.
  • mapresults: o usuário encontrou o link para reserva de hotel em maps.google.com.
  • verification: o Google usa esse valor ao realizar testes automatizados de qualidade de dados no seu site. Você não é cobrado por essas consultas. 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 de reserva gratuita por uma fonte indeterminada.
LENGTH Recommended A duração da estadia em termos do número de noites definido pelo <Nights> no Feed de preços para 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 adultos especificados para o itinerário pelo usuário. Essa variável deve ser usada em conjunto com NUM-CHILDREN, FOR-EACH-CHILD-AGE ou ambos.
NUM-CHILDREN Recommended O número de 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 é a soma Valores NUM-ADULTS e NUM-CHILDREN. Para maximizar a participação, é altamente recomendável utilizar NUM-ADULTS e NUM-CHILDREN.
PACKAGE-ID Recommended (applies if you use Room Bundles) O identificador exclusivo do pacote no feed de preços de hotéis. Para um pacote padrão, o ID do pacote é o valor do atributo Elemento <PackageID> em um <Result> bloco de recursos dependente. Para um pacote de quarto, o ID do pacote é o valor do elemento <PackageID> nos 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 <id> no feed de lista de hotéis.
PARTNER-ROOM-ID Recommended (applies if you use Room Bundles) O identificador único do quarto no Feed de preços para hotéis. Para um quarto padrão, o ID do quarto é um valor do Elemento <RoomID> no <Result> bloco de recursos dependente. Para uma Categoria de quarto, o ID do quarto é o valor atribuído à <RoomID> no elemento Blocos <RoomBundle> ou <RoomData> na Mensagem de transação.
PAYMENT-ID Optional (only applies to Ads) É resolvido 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 ao usuário no moeda local. O valor de PRICE-DISPLAYED-TOTAL é o soma de <Baserate>, <Tax> e <OtherFees> elementos do Feed de preços para hotéis. Por exemplo, "152,13".
PROMO-CODE (Optional)

Se você usar as promoções ARI, o valor dessa variável será atribuído ao atributo id do <Promotion> aplicado. Se várias promoções são aplicadas, é uma lista separada por vírgulas de códigos de promoção em ordem arbitrária.

Se você usar regras de tarifação, o valor dessa variável será atribuído ao elemento PromoCode se a regra de tarifação correspondente for aplicada.
RATE-PLAN-ID Recommended (only applies if you use RoomBundles) O ID definido pelo elemento <RatePlanID> no bloco <RoomBundle> de um feed de preços. O <RatePlanID> representa o identificador exclusivo. para uma combinação de dados de quartos e pacotes. Para mais informações, consulte Pacotes de quartos.
RATE-RULE-ID Recommended (only applies if you use conditional rates or private rates) O ID, conforme definido pelo atributo rate_rule_id em um bloco de <Rate> do 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. Isso informações são extraídas das configurações de cliente do usuário. Para exemplo, US ou FR.
USER-CURRENCY Recommended Um código de moeda de três letras que indica o local do usuário moeda. O valor da variável USER-CURRENCY é das configurações de 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 configurações de 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 de USER-LANGUAGE é inferida a partir das 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 o usuário informações imprecisas ou inadequadas. As listas de público-alvo são usadas como base para como definir o lance ajustes automáticos. Se o usuário fizer parte de várias listas de público-alvo, o lista de público-alvo com o maior ajuste de lance é selecionada. Amarra 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 ou validação automatizada. Será true se o link tiver sido gerado. pelo Google para teste ou validação automatizada. Caso contrário, o atributo 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 condicionalmente.

A lógica condicional oferece suporte às 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:

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 tiver origem em um link de reserva gratuito.
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 Resolve como true se a o usuário clicou em uma listagem de um Categoria de quarto. Caso contrário, é resolvido como false.
IF-CLOSE-RATE-RULE-IDS Optional Resolve para true se uma ou mais tarifas condicionais não estiverem disponíveis porque o usuário não está qualificado. Caso contrário, vai resolver para false. Por padrão, é true se um tarifa exclusiva o tratamento da interface foi mostrado ao usuário.
IF-DEFAULT-RATE Optional É resolvido como true se o usuário clicou em uma ficha de hotel. em que datas padrão foram usadas. Caso contrário, retorna false.
IF-HOTEL-CAMPAIGN Optional É resolvido como true se o clique do usuário é originado de um campanha de hotel. Caso contrário, será 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 taxa que é com base em uma promoção ARI ou em uma regra de tarifação com um determinado PromoCode; caso contrário, será 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 Resolve para true se o usuário selecionou uma tarifa condicional . Caso contrário, será resolvido como false.
IF-USER-LIST-ID (definido no Google Ads) Optional Resolve para true se o usuário for membro de um ID da lista de clientes do Google Ads especificado ao definir multiplicadores de lances para listas de público-alvo. Caso contrário, vai para false.
IF-VERIFICATION Optional É resolvido como true se o link foi gerado pelo Google para ou validação automatizada. Caso contrário, será 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) É executado uma vez para cada <Child "age"> no feed de preços. Para exemplo, se <OccupancyDetails> incluir os dois <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 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 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 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 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 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 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 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 gratuitos para reserva)

É 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 clicar no URL de uma campanha de hotel, o resultado será 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 dos cliques da campanha de hotel dos outros cliques.

CAMPAIGN-IDs em branco com cliques 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 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 foi atribuído ao Google:
    https://partner.com?hid=123&amp;booking_source=commissions
  • Se um número IATA tiver sido atribuído ao Google:
    https://partner.com?hid=123&amp;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 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 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. 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 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 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>

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

É 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 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 para 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 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 seguintes regras gerais se aplicam ao definir URLs construídos 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 caractere & é um caractere especial no XML e o formato do arquivo de páginas de destino é XML. Portanto, você deve usar a entidade codificada "&amp;" no lugar. 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:

    • 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 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 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>

    Esse 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 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.

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