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 de um hotel correspondente. Para 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 para reserva sem custo financeiro. 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 para reserva sem custo financeiro. O valor desse atributo precisa corresponder a um idioma compatível especificado pelo elemento <Match>.

O exemplo a seguir mostra um nome de exibição para uma OTA francesa:

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

Exclua o elemento <DisplayNames> para fornecedores de sistemas centrais de reservas (CRS), 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 atualizações OTA, 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 que seus anúncios e links sem custo financeiro para reserva sejam mostrados com base em várias características do usuário ou do hotel. Por exemplo, você pode especificar que um anúncio ou link sem custo financeiro para reserva seja mostrado apenas para usuários em 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 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ê tiver URLs diferentes para seus mecanismos de reserva ou várias marcas.
  • currency: corresponde à moeda do país do usuário ou 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 aceita os seguintes valores:
    • localuniversal: o usuário encontrou o anúncio ou o link para reserva sem custo financeiro por uma pesquisa, geralmente no google.com.
    • mapresults: o usuário encontrou o link para reserva de hotel em maps.google.com.
    • OBSERVAÇÃO:não é permitido definir todos os tipos de site como never. Isso fará com que sitetype seja ignorado.

  • 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, 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 adequado. Quando o usuário clica no seu site, ele pode extrair e processar os valores de todos os parâmetros de string de consulta para criar uma experiência do usuário tranquila. Para 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 não rastreado 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, que estão 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 do 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 hotel