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 assume um único atributo, id, que define um identificador exclusivo para uma página de destino. Você pode usar o valor de id para filtrar as 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 texto de exibição para agências de viagens on-line (OTAs, na sigla em inglês). Esse elemento assume os seguintes atributos:

  • display_text: contém o texto mostrado em um anúncio ou link sem custo financeiro para reserva. 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 sem custo financeiro para reserva. O valor desse atributo precisa corresponder a um idioma aceito especificado pelo elemento <Match>.

O exemplo a seguir mostra o nome de exibição de uma agência de viagens on-line francesa:

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

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

Observação:para OTAs, se você configurou um nome de exibição padrão com o Suporte do Google, esse campo é opcional. Caso contrário, as OTAs precisam fornecer <DisplayNames>.
<Match> Required

Define filtros para exibir anúncios e links sem custo financeiro para reserva com base em diversas características do usuário ou hotel. Por exemplo, você pode especificar que um anúncio ou link sem custo financeiro para reserva seja exibido somente aos usuários de um determinado país.

Esse elemento assume 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 ser correspondente) ou never (não podem ser correspondentes).
  • country: corresponde ao domínio do Google associado ao usuário e ao hotel. Esse atributo leva um código do 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 sua 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 o usuário visualizou os dados de preço do seu hotel. Esse atributo tem os seguintes valores:
    • localuniversal: o usuário encontrou o anúncio ou o link sem custo financeiro para reserva ao fazer uma pesquisa, geralmente no google.com.
    • mapresults: o usuário encontrou o link para reserva de hotéis pelo maps.google.com.
  • device: corresponde ao tipo de dispositivo que o usuário usa para pesquisar. Esse atributo usa 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 das 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 dele como parâmetros de string de consulta. Por exemplo, você pode 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 exibido para o usuário, o Google substitui a variável PARTNER-HOTEL-ID pelo ID do hotel apropriado. Quando o usuário clica no seu site, ele pode extrair e processar os valores de todos os parâmetros da string de consulta para criar uma experiência do usuário tranquila. Para uma lista completa das 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 rastreamento. 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>.

Só é possível definir um elemento <URL> para cada página de destino.
<LPURL> Optional

Usado para oferecer suporte ao acompanhamento 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 ter escape. Uma configuração correta do ValueTrack no Google Ads faz o escape dele 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 arquivos das páginas de destino define a estrutura e as restrições desse arquivo. Para mais informações, leia Esquemas de anúncios de hotéis.