Sintassi del file delle pagine di destinazione

L'elemento principale del file delle pagine di destinazione è <PointsOfSale>, che utilizza un elemento secondario, <PointOfSale> e non ha attributi. Un file delle pagine di destinazione può avere più elementi secondari <PointOfSale>.

Ogni pagina di destinazione che definisci nel file delle pagine di destinazione è inclusa in un elemento <PointOfSale>. Questo elemento utilizza un singolo attributo, id, che definisce un identificatore univoco per una pagina di destinazione. Puoi utilizzare il valore di id per filtrare le pagine di destinazione idonee per un hotel corrispondente. Puoi farlo utilizzando l'elemento <AllowablePointsOfSale> in <Transaction>.

Sintassi

<?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>

Nella tabella seguente vengono descritti gli elementi secondari dell'elemento <PointOfSale>:

Elemento Obbligatorie Descrizione
<DisplayNames> Optional

Contiene il testo visualizzato per le agenzie di viaggi online. Questo elemento accetta i seguenti attributi:

  • display_text: contiene il testo mostrato in un annuncio o in un link di prenotazione gratuito. Deve essere il nome del partner.
  • display_language: un codice lingua di due lettere specifica la lingua di visualizzazione dell'annuncio o del link di prenotazione gratuito. Il valore di questo attributo deve corrispondere a una lingua supportata specificata dall'elemento <Match>.

L'esempio seguente mostra un nome visualizzato per un'agenzia di viaggi online francese:

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

Escludi l'elemento <DisplayNames> per i fornitori di sistemi di prenotazione centralizzati (CRS), noti anche come "partner di integrazione", e fornitori diretti come proprietari o catene di hotel. Per questi tipi di partner, il testo dell'annuncio e del link di prenotazione gratuito viene recuperato dall'elemento <Name> dell'hotel nell'elenco hotel.

Nota: per gli OTA, se hai configurato un nome visualizzato predefinito con l'Assistenza Google, questo campo è facoltativo. In caso contrario, le OTA devono fornire <DisplayNames>.
<Match> Required

Definisce filtri per visualizzare o meno i tuoi annunci e link di prenotazione gratuiti in base a varie caratteristiche dell'utente o dell'hotel. Ad esempio, puoi specificare che un annuncio o un link di prenotazione gratuito venga mostrato solo agli utenti in un determinato paese.

Questo elemento accetta i seguenti attributi:

  • status: determina se una corrispondenza include o esclude i risultati per il criterio specificato. I valori validi sono yes (deve corrispondere) o never (non deve corrispondere).
  • country: corrisponde al dominio Google associato all'utente e all'hotel. Questo attributo accetta un codice paese di due lettere. Ad esempio, US o FR.
  • language: corrisponde alla lingua dell'utente e dell'hotel. Questo attributo accetta un codice lingua di due lettere. Ad esempio, en o fr.
  • brand: corrisponde al valore dell'attributo hotel_brand specificato nel tuo elenco di hotel. Questo filtro può essere utile se hai URL diversi per i tuoi sistemi di prenotazione o per vari brand.
  • currency: corrisponde alla valuta del paese dell'utente o dell'hotel. Questo attributo accetta un codice valuta di tre lettere. Ad esempio, USD o EUR.
  • sitetype: corrisponde alla proprietà di Google in cui un utente ha visualizzato i tuoi dati sui prezzi dell'hotel. Questo attributo accetta i seguenti valori:
    • localuniversal: l'utente ha trovato l'annuncio o il link di prenotazione gratuito tramite una ricerca, in genere effettuando una ricerca su google.com.
    • mapresults: l'utente ha trovato il link di prenotazione dell'hotel tramite maps.google.com.
  • device: corrisponde al tipo di dispositivo utilizzato dall'utente per la ricerca. Questo attributo richiede mobile, desktop o tablet.

    NOTA: non puoi impostare status su never se device è impostato su tablet.

Ad esempio:

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

Puoi combinare gli attributi dell'elemento <Match> per semplificare le regole di corrispondenza, come illustrato nell'esempio seguente:

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

Per maggiori informazioni, consulta Regole di corrispondenza delle pagine di destinazione.
<URL> Required Definisce un link al tuo sito in cui l'utente può prenotare una camera. Puoi inserire informazioni dinamiche sull'utente e sul suo itinerario come parametri della stringa di query. Ad esempio, puoi includere l'ID hotel utilizzando la variabile PARTNER-HOTEL-ID nell'URL: 
http://partner.com/landing?hid=(PARTNER-HOTEL-ID)

Quando questo link viene creato e mostrato all'utente, Google sostituisce la variabile PARTNER-HOTEL-ID con l'ID hotel appropriato. Quando l'utente fa clic per accedere al sito, quest'ultimo può estrarre ed elaborare i valori di tutti i parametri della stringa di query per creare un'esperienza utente fluida. Per un elenco completo delle variabili consentite nell'URL pagina di destinazione, consulta la sezione Utilizzare variabili e condizioni.

Quando utilizzi il monitoraggio, specifica l'URL completo, inclusi i componenti necessari per il monitoraggio. Ad esempio:

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

Non è possibile utilizzare i parametri ValueTrack nell'elemento <URL>.

Puoi definire un solo elemento <URL> per ogni pagina di destinazione.
<LPURL> Optional

Utilizzato per supportare il monitoraggio dinamico nell'URL pagina di destinazione. Specifica il segmento non di monitoraggio dell'URL definito nell'elemento <URL>. I segmenti di monitoraggio dell'URL pagina di destinazione devono essere specificati utilizzando i modelli di monitoraggio di Google Ads disponibili nel tuo account Google Ads e il suffisso URL finale. Se gli URL di monitoraggio non sono presenti in Google Ads, l'elemento <LPURL> viene ignorato.

Non è necessario inserire caratteri di escape per il valore <LPURL>. Una configurazione ValueTrack corretta in Google Ads esegue automaticamente l'escape. Ad esempio:

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

Non è possibile utilizzare i parametri ValueTrack nell'elemento <LPURL>. Per maggiori informazioni, consulta la pagina Configurare il monitoraggio dinamico per una campagna per hotel.

Lo schema del file delle pagine di destinazione definisce la struttura e i vincoli di un file delle pagine di destinazione. Per ulteriori informazioni, consulta la pagina Schemi di Hotel Ads