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 definite, 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:
country*currency*language*devicegoogle site
Il criterio delle impostazioni internazionali cerca prima di trovare una corrispondenza per l'utente. Se non viene trovata alcuna corrispondenza, vengono utilizzate le impostazioni internazionali (paese, valuta, lingua) dell'hotel cercato per trovare una corrispondenza.
Se un criterio non viene dichiarato, corrisponde implicitamente a tutti i valori disponibili.
Prima che un hotel venga associato all'utente, devono corrispondere tutti e quattro i criteri della pagina di destinazione: valuta, paese, dispositivo, lingua.
Se corrispondono più definizioni di pagine 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 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.Se imposti lo stato su
yesper un valorecountry,currencyolanguage, non escludi altri valori idonei. Devi escludere esplicitamente gli altri valori.Non consentito (
never): corrispondenza negativa per i valori elencati, positiva 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.
Quando vuoi escludere determinati paesi, valute o lingue, devi impostare esplicitamente lo stato di corrispondenza su never. Puoi combinare 2 e 3 per descrivere le funzionalità del tuo sito web. Consulta la sezione degli 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 sui dispositivi mobili, ma non su computer o tablet.desktop: la pagina viene visualizzata su computer e tablet, ma non su dispositivi mobili, anche se escludi esplicitamente i tablet. Un modo per aggirare il problema è impostare il moltiplicatore di offerta per i tablet su un valore negativo elevato.tablet: la pagina viene visualizzata su computer, a meno che non sia esplicitamente esclusa, 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
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&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 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&checkin-date=2023-05-23&checkout-date=2023-05-28&num-adults=2</URL>
</PointOfSale>
Valuta
Mostra gli annunci agli utenti la cui valuta è l'euro, ma non 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 agli 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 negli US e in GB; ma in assenza di altre definizioni della pagina di destinazione può stabilire una corrispondenza anche per altri paesi.
<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 e solo agli 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 pagine di destinazione multiple
Più definizioni di pagine di destinazione possono corrispondere ai criteri. In questo caso, Google le classifica in base alle seguenti 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:
- 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 che corrisponde 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 l'utente, ad esempio 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. Consulta l'esempio Multiplo.
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 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 <AllowablePointsOfSale> blocco dal tuo Transaction
messaggio, 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.