Sintaxe do arquivo de páginas de destino

O elemento raiz do arquivo de páginas de destino é <PointsOfSale>, que usa um elemento filho, <PointOfSale>, e não tem atributos. Um arquivo de páginas de destino pode ter vários elementos filhos <PointOfSale>.

Cada página de destino definida no arquivo de páginas de destino é incluída em um elemento <PointOfSale>. Esse elemento usa um único atributo, id, que define um identificador exclusivo para uma página de destino. Você pode usar o valor de id para filtrar páginas de destino qualificadas para um hotel correspondente. Para fazer isso, use o elemento <AllowablePointsOfSale> em <Transaction>.

Sintaxe

<?xml version="1.0" encoding="UTF-8"?>
<PointsOfSale>
  <PointOfSale id="landing_page_id">
    <DisplayNames display_text="landing_page_display_name" display_language="language_code"/>
    <Match status="[yes|never]"
      country="country_code"
      language="language_code"
      brand="booking_engine or brand"
      currency="currency_code"
      sitetype="[localuniversal|mapresults]"
      device="[desktop|mobile|tablet]"/>
    <!-- The dynamic landing page URL -->
    <URL>landing_page_url</URL>
  </PointOfSale>
</PointsOfSale>

A tabela a seguir descreve os elementos filhos do elemento <PointOfSale>:

Elemento Obrigatório Descrição
<DisplayNames> Optional

Contém o texto de exibição para agências de viagens on-line (OTAs). Esse elemento usa os seguintes atributos:

  • display_text: contém o texto mostrado em um anúncio ou link de reserva gratuita. Ele precisa ser o nome do parceiro.
  • display_language: um código de idioma de duas letras especifica o idioma de exibição do anúncio ou do link de reserva gratuita. O valor desse atributo precisa corresponder a um idioma com suporte especificado pelo elemento <Match>.

O exemplo a seguir mostra um nome de exibição para uma OTA em francês:

  <DisplayNames
    display_text="TravelAgency.com.fr"
    display_language="fr"
  />

Exclua o elemento <DisplayNames> para fornecedores do sistema de reservas central (CRS, na sigla em inglês), também conhecidos como "parceiros de integração", e fornecedores diretos, como proprietários ou redes de hotéis. Para esses tipos de parceiros, o texto do anúncio e do link para reserva sem custo financeiro é extraído do elemento <Name> do hotel na Lista de hotéis.

Observação:para OTAs, se você tiver configurado um nome de exibição padrão com o Suporte do Google, esse campo será opcional. Caso contrário, o OTA precisa fornecer <DisplayNames>.

<Match> Required

Define filtros para determinar se seus anúncios e links sem custo financeiro para reserva são exibidos com base em várias características do usuário ou do hotel. Por exemplo, é possível especificar que um anúncio ou link para reserva sem custo financeiro seja mostrado apenas para usuários de um determinado país.

Esse elemento usa os seguintes atributos:

  • status: determina se uma correspondência inclui ou exclui resultados para o critério especificado. Os valores válidos são yes (precisa corresponder) ou never (não precisa corresponder).
  • country: correspondências no domínio do Google associado ao usuário e ao hotel. Esse atributo usa um código de país de duas letras. Por exemplo, US ou FR.
  • language: corresponde ao idioma do usuário e do hotel. Esse atributo recebe um código de idioma de duas letras. Por exemplo, en ou fr.
  • brand: corresponde ao valor do atributo hotel_brand especificado na lista de hotéis. Esse filtro pode ser útil se você tiver URLs diferentes para seus mecanismos de reserva ou várias marcas.
  • currency: corresponde à moeda do usuário ou do país do hotel. Esse atributo usa um código de moeda de três letras. Por exemplo, USD ou EUR.
  • sitetype: corresponde à propriedade do Google em que um usuário visualizou os dados de preços do seu hotel. Esse atributo usa os seguintes valores:
    • localuniversal: o usuário encontrou o anúncio ou o link de reserva gratuita em uma pesquisa, geralmente no google.com.
    • mapresults: o usuário encontrou o link de reserva de hotel em maps.google.com.
  • device: corresponde ao tipo de dispositivo que o usuário usa para pesquisar. Esse atributo recebe mobile, desktop ou tablet.

    Observação:não é possível definir status como never se device estiver definido como tablet.

Exemplo:

<PointOfSale id="test1">
  <Match status="yes" country="US"/>
  <Match status="yes" currency="USD"/>
  <Match status="yes" device="mobile"/>
  <Match status="yes" language="en"/>
  <URL>www.google.com</URL>
</PointOfSale>

É possível combinar atributos do elemento <Match> para simplificar as regras de correspondência, como mostra o exemplo a seguir:

<PointOfSale id="test1">
  <Match
    status="yes"
    country="US"
    language="en"
    currency="USD"
    device="mobile"/>
  <URL>www.google.com</URL>
</PointOfSale>

Para mais informações, consulte Regras de correspondência de páginas de destino.

<URL> Required Define um link para seu site em que o usuário pode reservar um quarto. É possível inserir informações dinâmicas sobre o usuário e o itinerário como parâmetros de string de consulta. Por exemplo, é possível incluir o ID do hotel usando a variável PARTNER-HOTEL-ID no URL:
http://partner.com/landing?hid=(PARTNER-HOTEL-ID)

Quando esse link é criado e mostrado ao usuário, o Google substitui a variável PARTNER-HOTEL-ID pelo ID do hotel apropriado. Quando o usuário clica no site, ele pode extrair e processar os valores de todos os parâmetros da string de consulta para criar uma experiência de usuário tranquila. Para conferir uma lista completa de variáveis permitidas no URL da página de destino, consulte Como usar variáveis e condições.

Ao usar o acompanhamento, especifique o URL completo, incluindo os componentes necessários para o acompanhamento. Exemplo:

https://example.tracker.com?campaign_id=(CAMPAIGN-ID)&amp;t_url=
http://partner.com/landing%3Fhid%3D(PARTNER-HOTEL-ID)

Não é possível usar parâmetros ValueTrack em <URL>.

É possível definir apenas um elemento <URL> para cada página de destino.

<LPURL> Optional

Usado para oferecer suporte ao rastreamento dinâmico no URL da página de destino. Especifica o segmento sem rastreamento do URL definido no elemento <URL>. Os segmentos de acompanhamento do URL da página de destino precisam ser especificados usando os modelos de acompanhamento do Google Ads, disponíveis na sua conta do Google Ads, e o sufixo do URL final. Se os URLs de rastreamento não estiverem presentes no Google Ads, o elemento <LPURL> será ignorado.

O valor <LPURL> não precisa de escape. Uma configuração correta do ValueTrack no Google Ads faz o escape automaticamente. Exemplo:

http://partner.com/landing?hid=(PARTNER-HOTEL-ID)

Não é possível usar parâmetros ValueTrack em <LPURL>. Para mais informações, consulte Configurar o acompanhamento dinâmico para uma campanha de hotel.

O esquema de arquivo de páginas de destino define a estrutura e as restrições de um arquivo de páginas de destino. Para mais informações, leia Esquemas de anúncios de hotéis.