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 seguenti regole:
I criteri di corrispondenza principali sono i seguenti:
country*currency*language*devicegoogle 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 cercato per trovare una corrispondenza.
Se un criterio non viene dichiarato, corrisponderà implicitamente a tutti i valori disponibili.
Affinché un hotel venga associato a un utente, è necessario che tutti e quattro i criteri della pagina di destinazione (valuta, paese, dispositivo e lingua) corrispondano.
Se corrispondono più definizioni di pagina di destinazione, vengono applicate le seguenti regole:
Viene utilizzata la pagina di destinazione con la qualità di 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 delle corrispondenze
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
yesper un valorecountry,currencyolanguagenon 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, se 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. Fai riferimento alla sezione degli esempi.
Corrispondenza dei dispositivi
Per evitare confusione, consigliamo di utilizzare la corrispondenza dei dispositivi per una pagina di destinazione:
mobile: la pagina viene visualizzata sul dispositivo mobile, ma non su computer o tablet.desktop: la pagina viene visualizzata su computer e tablet, ma non sui 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 visualizzata 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&checkin-date=2023-05-23&checkout-date=2023-05-28&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&checkin-date=2023-05-23&checkout-date=2023-05-28&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&checkin-date=2023-05-23&checkout-date=2023-05-28&num-adults=2</URL>
</PointOfSale>
Paese
Pubblica i tuoi 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&checkin-date=2023-05-23&checkout-date=2023-05-28&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 corrisponde a un valore solo se è definito esplicitamente.
<PointOfSale id='pos-mobile'>
<!-- Explicitly match on mobile only -->
<Match status='yes' device="mobile"/>
<URL>www.google.com/?hotel-id=34876&checkin-date=2023-05-23&checkout-date=2023-05-28&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&checkin-date=2023-05-23&checkout-date=2023-05-28&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&checkin-date=2023-05-23&checkout-date=2023-05-28&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 potrebbero essere abbinati a 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&checkin-date=2023-05-23&checkout-date=2023-05-28&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&checkin-date=2023-05-23&checkout-date=2023-05-28&num-adults=2</URL>
</PointOfSale>
Priorità per più pagine di destinazione
Più definizioni di pagina di destinazione possono corrispondere in base ai criteri. In questo caso, Google le classifica in base alle seguenti regole:
È preferibile una corrispondenza della condizione per l'utente 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:
- Paese
- Valuta
- Brand
- Lingua
- Dispositivo
- 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, come paese e lingua, e la lingua è specificata, la lingua dell'utente deve corrispondere esplicitamente. 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 a questo esempio di definizione multipla.
Per la configurazione di un file della pagina di destinazione, se due definizioni hanno le stesse priorità, 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 determinato 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
effettuare 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 sono idonee alla corrispondenza.
Puoi anche utilizzare l'elemento <AllowablePointsOfSale> se vuoi attivare o disattivare la pubblicazione di hotel specifici nella pagina di destinazione Click-to-call.