Sintaxe do arquivo de páginas de destino

O elemento raiz do arquivo das 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 a 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 compatível 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 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 é retirado 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, as OTAs precisam fornecer <DisplayNames>.
<Match> Required

Define filtros para exibir seus anúncios e links sem custo financeiro para reserva com base em várias 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 apenas para os 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 corresponder) ou never (não pode corresponder).
  • country: corresponde ao 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 usa 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ê tem URLs diferentes para seus mecanismos de reserva ou várias marcas.
  • currency: corresponde à moeda do país do usuário ou 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ços do seu hotel. Esse atributo aceita os seguintes valores:
    • localuniversal: o usuário encontrou o anúncio ou o link sem custo financeiro para reserva fazendo uma pesquisa, geralmente no google.com.
    • mapresults: o usuário encontrou o link para reserva do hotel pelo app 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>

Você pode combinar atributos do elemento <Match> para simplificar suas regras de correspondência, conforme 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 onde 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, é 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 seu site, o site 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 ele. 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 no <URL>.

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

Usado para ser compatível com o 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 de escape. O escape automático de uma configuração ValueTrack correta no Google Ads faz o escape. Exemplo:

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

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

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