Regole di corrispondenza delle pagine di destinazione

L'API Hotel Prices associa un utente a una pagina di destinazione definita nel file delle pagine di destinazione o in Hotel Center.

Se un utente non corrisponde a nessuna delle pagine di destinazione specificate, l'annuncio non partecipa all'asta. Si tratta pertanto di un'opportunità mancata, che viene stimata in Hotel Center.

Criteri

Google associa un utente alla pagina di destinazione più appropriata sulla base delle regole seguenti:

I criteri di corrispondenza principali sono i seguenti:
1. country*
2. currency*
3. language*
4. device
5. google site
Il criterio delle impostazioni internazionali cerca prima di trovare una corrispondenza per l'utente. Se non esiste una corrispondenza, vengono usate le impostazioni internazionali (paese, valuta, lingua) dell'hotel ricercato per trovare una corrispondenza.
Se un criterio non viene dichiarato, corrisponde implicitamente a tutti i valori disponibili.
Tutti e quattro i criteri della pagina di destinazione (valuta, paese, dispositivo, lingua) devono corrispondere prima che un hotel venga abbinato all'utente.
Se corrispondono più definizioni di pagina di destinazione, vengono applicate le seguenti regole:
- Viene utilizzata la pagina di destinazione con la qualità della corrispondenza migliore. Per ulteriori informazioni, consulta la sezione Priorità per pagine di destinazione multiple.
- Per corrispondenze di qualità simile, viene utilizzata quella che compare per prima nel file delle pagine di destinazione.

Configurazione della corrispondenza

Ogni criterio può stabilire una corrispondenza in tre modi:

Non specificato (*): corrispondenza per tutti i valori applicabili.
Consentito (yes): corrispondenza per i valori elencati, nessuna corrispondenza per tutti i valori applicabili.

L'impostazione dello stato su yes per un valore di country, currency o language non comporta l'esclusione di altri valori idonei. Devi impostare gli altri valori esplicitamente come non consentiti.
Non consentito (never): nessuna corrispondenza per i valori elencati, corrispondenza per tutti gli altri valori applicabili.

Corrispondenze implicite ed esplicite

Corrispondenze implicite: 1 e 3 sono idonei per le corrispondenze implicite quando vengono utilizzati i valori applicabili.
Corrispondenze esplicite: 2 e 3 sono idonei per le corrispondenze esplicite per i valori elencati.

Se vuoi escludere valute, lingue o paesi specifici devi impostare esplicitamente il relativo stato di corrispondenza su never. Puoi combinare 2 e 3 per descrivere le capacità del tuo sito web. Consulta la sezione Esempi.

Corrispondenza dei dispositivi

Per evitare confusione, ti consigliamo di utilizzare la corrispondenza dei dispositivi per una pagina di destinazione:

mobile: La pagina viene visualizzata su un dispositivo mobile, ma non su un computer o un tablet.
desktop: la pagina viene visualizzata su computer e tablet, ma non su dispositivi mobili, anche se hai esplicitamente impostato il valore "tablet" come non consentito. Un modo per aggirare il problema è impostare un moltiplicatore di offerta negativo elevato per i tablet.
tablet: la pagina viene visualizzata sui computer, a meno che non sia esplicitamente vietata, ma non viene mostrata sui dispositivi mobili.

Fonti Google

Per impostazione predefinita, la maggior parte dei partner attiva i seguenti canali Google in ogni pagina di destinazione:

Local Universal (prezzi nei risultati di ricerca di Google)
Risultati mappa

Esempi

Questa sezione mostra alcuni esempi comuni di definizioni di pagine di destinazione di base.

Standard

<PointOfSale id="pos-usd">
  <!-- Explicitly allow US Dollars -->
  <Match status="yes" currency="USD"/>
  <URL>www.google.com/?hotel-id=34876&amp;checkin-date=2023-05-23&amp;checkout-date=2023-05-28&amp;num-adults=2</URL>
</PointOfSale>

Multiplo

<PointOfSale id="pos-us">
  <!-- Explicitly allow US and Dollars -->
  <Match status="yes" currency="USD"/>
  <Match status="yes" country="US"/>
  <URL>www.google.com/?hotel-id=34876&amp;checkin-date=2023-05-23&amp;checkout-date=2023-05-28&amp;num-adults=2</URL>
</PointOfSale>

<PointOfSale id="pos-uk">
  <!-- Explicitly allow GB and Pounds -->
  <Match status="yes" currency="GBP"/>
  <Match status="yes" country="GB"/>
  <URL>www.google.com/?hotel-id=34876&amp;checkin-date=2023-05-23&amp;checkout-date=2023-05-28&amp;num-adults=2</URL>
</PointOfSale>

Paese

Mostra gli annunci solo in Giappone. Tutti gli altri paesi corrispondono implicitamente, a meno che non siano esplicitamente impostati come non consentiti.

<PointOfSale id='pos-jp'>
  <!-- Explicitly match on Japan -->
  <Match status='yes' country='JP'/>

  <!-- List common countries to exclude -->
  <Match status='never' country='US'/>
  <Match status='never' country='FR'/>
  ...

  <URL>www.google.com/?hotel-id=34876&amp;checkin-date=2023-05-23&amp;checkout-date=2023-05-28&amp;num-adults=2</URL>
</PointOfSale>

Quando definisci una pagina di destinazione in modo che corrisponda a un singolo paese, in genere escludi da 10 a 20 paesi che generano il maggior numero di impressioni, come mostrato in Hotel Center, e includi solo quelli per cui vuoi stabilire una corrispondenza.

Dispositivo

Mostra gli annunci solo sui dispositivi mobili. Il criterio device stabilisce una corrispondenza per un valore solo se questo è stato definito esplicitamente.

<PointOfSale id='pos-mobile'>
  <!-- Explicitly match on mobile only -->
  <Match status='yes' device="mobile"/>

  <URL>www.google.com/?hotel-id=34876&amp;checkin-date=2023-05-23&amp;checkout-date=2023-05-28&amp;num-adults=2</URL>
</PointOfSale>

Valuta

Mostra gli annunci per gli utenti la cui valuta è l'euro, ma esclude quelli che usano il dollaro statunitense. Tutte le altre valute corrispondono implicitamente, a meno che non siano esplicitamente impostate come non consentite.

<PointOfSale id="pos-eur">
  <!-- Explicitly allow Euros -->
  <Match status="yes" currency="EUR"/>

  <!-- Explicitly disallow US dollars -->
  <Match status="never" currency="USD"/>

  <URL>www.google.com/?hotel-id=34876&amp;checkin-date=2023-05-23&amp;checkout-date=2023-05-28&amp;num-adults=2</URL>
</PointOfSale>

Lingua

Mostra gli annunci solo per gli utenti che preferiscono l'inglese.

<PointOfSale id='pos-en'>
  <!-- Explicitly match on English -->
  <Match status='yes' language='en'/>

  <!-- List common languages to exclude -->
  <Match status='never' language='es'/>
  <Match status='never' language='fr'/>
  <Match status='never' language='jp'/>
  ...

  <URL>www.google.com/?hotel-id=34876&amp;checkin-date=2023-05-23&amp;checkout-date=2023-05-28&amp;num-adults=2</URL>
</PointOfSale>

Quando definisci una pagina di destinazione in modo che corrisponda a una singola lingua, in genere escludi da 10 a 20 lingue che generano il maggior numero di impressioni, come mostrato in Hotel Center, e includi solo quelle per cui vuoi stabilire una corrispondenza.

Più paesi

Mostra gli annunci preferibilmente in US e GB, ma potrebbe stabilire una corrispondenza con un altro paese se non sono presenti altre definizioni della pagina di destinazione.

<PointOfSale id='pos-us-uk'>
  <!-- Explicitly match on the US and/or GB -->
  <Match status='yes' country='US'/>
  <Match status='yes' country='GB'/>

  <URL>www.google.com/?hotel-id=34876&amp;checkin-date=2023-05-23&amp;checkout-date=2023-05-28&amp;num-adults=2</URL>
</PointOfSale>

Paese + Lingua

Mostra gli annunci solo in Giappone per gli utenti che preferiscono l'inglese. Tutti i paesi e le lingue corrispondono implicitamente, a meno che non siano esplicitamente impostati come non consentiti.

<PointOfSale id='pos-jp-en'>
  <!-- Explicitly match on Japan -->
  <Match status='yes' country='JP'/>

  <!-- List common countries to exclude -->
  <Match status='never' country='US'/>
  <Match status='never' country='FR'/>
  ...

  <!-- Explicitly match on English -->
  <Match status='yes' language='en'/>

  <!-- List common languages to exclude -->
  <Match status='never' language='jp'/>
  <Match status='never' language='fr'/>
  ...

  <URL>www.google.com/?hotel-id=34876&amp;checkin-date=2023-05-23&amp;checkout-date=2023-05-28&amp;num-adults=2</URL>
</PointOfSale>

Priorità per pagine di destinazione multiple

Più definizioni di pagina di destinazione possono corrispondere ai criteri. In questo caso, Google le classifica in base a queste regole:

Una corrispondenza della condizione per l'utente ha la precedenza rispetto a una corrispondenza della condizione per l'hotel. Ad esempio, se una pagina di destinazione corrisponde solo alla valuta dell'utente, ma un'altra corrisponde solo alla valuta dell'hotel, Google sceglie la pagina di destinazione corrispondente alla valuta dell'utente.
Ordine dei criteri, come segue:
1. Paese
2. Valuta
3. Brand
4. Lingua
5. Dispositivo
6. Origine Google
Ad esempio, se una pagina di destinazione corrisponde solo alla valuta dell'utente, ma un'altra corrisponde solo al dispositivo dell'utente, Google sceglie la pagina di destinazione corrispondente alla valuta dell'utente.
È preferibile usare una corrispondenza esplicita rispetto a una implicita. Ad esempio, se una pagina di destinazione corrisponde esplicitamente al paese dell'utente, ma un'altra corrisponde solo implicitamente, Google sceglie la pagina di destinazione che corrisponde esplicitamente. Inoltre, se sono definiti più criteri per gli utenti, ad esempio paese e lingua, e la lingua è specificata, la lingua dell'utente deve corrispondere in modo esplicito. In caso contrario, la pagina di destinazione non verrà selezionata.

Ti consigliamo di stabilire una corrispondenza per lo stesso insieme di criteri in ogni pagina di destinazione nella tua configurazione. In questo modo viene ridotta al minimo la complessità nel determinare il motivo per la corrispondenza di una tra più pagine di destinazione. Fai riferimento all'esempio di definizione multipla.

Per la configurazione di un file delle pagine di destinazione, se due definizioni con le stesse priorità corrispondono, Google sceglie quella che compare per prima nel file.

Filtrare le pagine di destinazione

Per filtrare un sottoinsieme di pagine di destinazione idonee per un particolare hotel, puoi utilizzare l'elemento <AllowablePointsOfSale> in un messaggio Transaction. Per ulteriori informazioni, consulta la sezione Riferimento XML per prezzi e inventario delle camere (messaggi Transaction).

Il seguente esempio di un messaggio Transaction consente all'hotel di stabilire una corrispondenza solo per pos-mobile e pos-en:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2023-05-24T20:44:56-04:00" id="42">
  <Result>
    <Property>052213</Property>
    ...
    <-- Allow pos-mobile and pos-en to match. All others will not match. -->
    <strong><AllowablePointsOfSale>
      <PointOfSale id="pos-mobile"/>
      <PointOfSale id="pos-en"/>
    </AllowablePointsOfSale></strong>
  </Result>
</Transaction>

Le pagine di destinazione non elencate nel blocco <AllowablePointsOfSale> non corrisponderanno. Se escludi il blocco <AllowablePointsOfSale> dal messaggio Transaction, tutte le pagine di destinazione saranno idonee alla corrispondenza.

Puoi anche utilizzare l'elemento <AllowablePointsOfSale> se vuoi attivare o disattivare hotel specifici per l'esecuzione nella pagina di destinazione Click-to-call.