Variáveis e condições

Os anúncios de hotel e os links sem custo financeiro 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 todas as informações adicionais sobre o usuário e o itinerário dele. Por exemplo, é possível incluir informações como o ID do hotel, idioma, códigos de moeda e datas do 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 aparece, 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 a seguinte sintaxe:

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

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

<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 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 para o hotel 42, o Google vai renderizar o link anterior da seguinte maneira:

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 em seu Feed de preços para hotéis, Feed de lista de hotéis e 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 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 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 da 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. O nome do 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 feed e outro identificador de propriedade para 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 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, em que o check-in é realizado, 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 com dois dígitos calculado a partir dos elementos <Nights> e <Checkin> do Feed de preços para 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 com quatro dígitos calculado a partir dos elementos <Nights> e <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 filho, conforme especificado nos elementos <Child "age"> do feed de preços. Essa variável precisa ser usada em conjunto 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 infantil e idade da criança especificadas 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 nas informações de uma tarifa de hotel padrão ou de uma Categoria de quarto. Os valores possíveis são:
  • hotel: o usuário clicou na listagem de uma diária de quarto padrão.
  • room: o usuário clicou nas informações 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 não estavam disponíveis, mas poderiam estar disponíveis se o usuário tivesse realizado uma pequena ação. Os IDs de regras de tarifação para tarifas exclusivas são sempre preenchidos aqui quando um tratamento de IU correspondente é exibido 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 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 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 link sem custo financeiro para reserva com as datas definidas.
GOOGLE-SITE Optional A propriedade do Google em que o 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 do hotel usando a pesquisa de google.com.
  • mapresults: o usuário encontrou o link para reserva do hotel pelo app maps.google.com.
  • verification: o Google usa esse valor ao realizar testes automatizados de qualidade de dados no seu site. Você não recebe cobrança por essas consultas. O Google Analytics pode usar esse parâmetro e o valor dele para identificar o tráfego de verificação automatizada dos Anúncios de hotéis.
  • unknown: o usuário encontrou o anúncio ou o link sem custo financeiro para reserva usando uma origem indeterminada.
LENGTH Recommended A duração da estadia em termos do número de diárias definida pelo elemento <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 ocupantes adultos especificado para o itinerário pelo usuário. Essa variável precisa ser usada com NUM-CHILDREN, FOR-EACH-CHILD-AGE ou ambos.
NUM-CHILDREN Recommended O número de ocupantes menores de 0 a 17 anos especificados no itinerário pelo usuário. NUM-CHILDREN, FOR-EACH-CHILD-AGE ou ambos são necessários para participar de itinerários com ocupantes menores.
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 exclusivo 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 código 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 ID do quarto é um valor do elemento <RoomID> dentro do bloco <Result>. Para uma Categoria de quarto, o código do quarto é o valor atribuído ao elemento <RoomID> dentro dos blocos <RoomBundle> ou <RoomData> na Mensagem de transação.
PAYMENT-ID Optional (only applies to Ads) Resolve 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 alterar a formatação do número IATA ou string predefinida, entre em contato com seu Gerente técnico de contas (TAM).
PRICE-DISPLAYED-TAX (Optional) O valor dos tributos exibido ao 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 é mostrado 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ê usar promoções ARI, o valor dessa variável será atribuído ao atributo id do <Promotion> aplicado. 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 as 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, 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 quartos e pacotes. Para mais informações, consulte Categorias 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.
USER-COUNTRY Recommended Um código do país de duas letras que indica a localização do usuário. Essas informações são extraídas das configurações de 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 é deduzido 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 é deduzido das 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 sem custo financeiro para reserva. O valor da variável USER-LANGUAGE é deduzido 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 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, aquela 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. true se o link foi gerado pelo Google para teste ou validação automática. 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 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:

Condição Recomendada/opcional Descrição
IF-AD-CLICK (somente anúncios de hotel) Optional Retorna para true se o clique do usuário tiver sido originado de um anúncio. Retorna para false se o clique do usuário tiver sido originado de um link sem custo financeiro para reserva.
IF-CLICK-TYPE-HOTEL Optional Resolve como true se o usuário clicou em uma ficha de hotel. Caso contrário, retorna false.
IF-CLICK-TYPE-ROOM Optional Resolve como true se o usuário clicou em uma ficha de uma Categoria de quarto. Caso contrário, retorna false.
IF-CLOSE-RATE-RULE-IDS Optional Retorna true se uma ou mais tarifas condicionais não estiverem disponíveis porque o usuário não tem qualificação. Caso contrário, retorna false. Por padrão, ele será true se um tratamento de IU com tarifa exclusiva for exibido ao usuário.
IF-DEFAULT-RATE Optional Resolve como true se o usuário clicou em uma listagem de hotéis em que as datas padrão foram usadas. Caso contrário, retorna false.
IF-HOTEL-CAMPAIGN Optional Se o clique do usuário tiver sido originado de uma campanha de hotel, será true. Caso contrário, será false. Essa distinção é útil para parceiros que têm vários tipos de campanha presentes 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) Transforma-se em true para hotéis no programa de comissões de pagamento por estadia (PPS, na sigla em inglês) para false.
IF-PROMO-CODE Optional Resolve 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, retorna false.
IF-PROMOTED (somente anúncios de hotel) Recommended (if you use Promoted hotels) Se refere a true, se o usuário clicou em um anúncio de promoção de propriedade. Caso contrário, retorna false.
IF-RATE-RULE-ID Optional Se refere a true se o usuário selecionou uma tarifa condicional . Caso contrário, retorna false.
IF-USER-LIST-ID (definido no Google Ads) Optional Retorna para true se o usuário é 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, retorna false.
IF-VERIFICATION Optional Se o link tiver sido gerado pelo Google para teste ou validação automatizada, será true. Caso contrário, retornará false.
ELSE Recommended (if you use any conditional IF statements) Se a condição anterior não for atendida, os valores que seguem 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 elemento <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 bloqueio 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 da 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 é este URL:

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

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

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

Exemplo de IF-CLIQUE-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 quarto 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 tiver selecionado uma Categoria de quarto, o resultado será este URL:

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

Exemplo de IF-CLICK-TYPE-ROOM

Você pode criar um bloco condicional que verifica se o usuário selecionou um pacote de sala.

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 tiver selecionado uma Categoria de quarto, o resultado será 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 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 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 bloco condicional que verifica se o usuário clicou em um anúncio proveniente de uma campanha de hotel.

O exemplo a seguir usa essa diretiva em um arquivo da 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á este:

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

Se o clique não for no URL de uma campanha de hotel (por exemplo, campanha de pesquisa normal), 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 de outros cliques.

IDs da campanha CAMPAIGN em branco com cliques do 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 ficará 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 um ID da campanha em branco, conforme mostrado neste exemplo:

<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 hotel)

Use a instrução condicional IF-PAYMENT-ID para variar o URL dependendo do clique ser 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 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 destes URLs:

  • Se nenhum número IATA tiver sido 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á este URL:

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

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

É possível criar um bloqueio 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 uma tarifa condicional. Se esse for o caso, será usado o valor do elemento <RateRuleID> no bloco <Rate> da mensagem de transação.

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 tiver selecionado uma tarifa condicional, o resultado será o seguinte URL:

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

Se o usuário tiver selecionado 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)

Ao 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 parâmetro no seu site para um cliente que pertence a uma determinada lista de público-alvo do Google Ads. Convém fazer isso para fins de rastreamento ou personalizar seu site 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 era membro 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

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 tiver gerado o URL para teste ou validação, o resultado será este:

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

Se o Google tiver gerado o URL para teste ou validação, o resultado será este:

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 de idade, 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 tivesse dois adultos e duas crianças com idades de 0 e 17, 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 tivesse dois adultos e nenhuma criança, o resultado seria este 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, o uso de variáveis para transmitir informações de itinerário e do usuário geralmente cria uma experiência melhor e ajuda você a estar em conformidade com as políticas do Google.

As seguintes regras gerais 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 só podem ser enviados depois do ponto de interrogação ("?") no URL.

  • 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 do arquivo das 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)&nights=(LENGTH)</URL>

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

    Também é necessário 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 devem ter codificação de URL. Por exemplo, hifens ("-") não precisam ter codificação de URL. Para ver uma lista de caracteres comuns que precisam ter codificação de URL, consulte a Tabela de codificação de URL.

  • Os valores de um único parâmetro podem ser construídos a partir de diversas variáveis. O exemplo a seguir constrói 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 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.