Creare un feed pagine di destinazione (in precedenza feed pos)

Per fornire a Bing i dati delle pagine di destinazione, creare un documento XML contenente un punto vendita (POS) per ogni sito di prenotazione supportata. Un POS descrive il nome visualizzato, l'URL e i criteri del POS per associare l'utente a un POS.

Il documento deve usare la codifica UTF-8 e deve essere conforme a PointsOfSale XSD.

Elemento di primo livello nel feed

Il feed Pagine di destinazione contiene un singolo elemento PointsOfSale di primo livello. L'elemento PointsOfSale richiede un elemento figlio PointOfSale per ogni sito che gli utenti possono usare per prenotare una stanza.

<?xml version="1.0" encoding="UTF-8"?>
<PointsOfSale xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <PointOfSale>
    . . .
  </PointOfSale>
  ...
</PointsOfSale>

L'elemento PointOfSale descrive il nome visualizzato, l'URL e i criteri del POS per associare l'utente a un POS. Per informazioni sulla definizione di un POS, vedere Definizione di un punto vendita.

Definizione di un punto vendita

L'elemento PointsOfSale contiene un elenco di elementi PointOfSale , uno per ogni sito POS che gli utenti possono usare per prenotare le sale. L'elenco deve contenere pagine di destinazione per un singolo partner.

Di seguito vengono illustrati PointOfSale gli elementi che definiscono le pagine di destinazione per gli utenti di lingua inglese. Il primo PointOfSale elemento definisce un POS per gli utenti finali di lingua inglese su qualsiasi dispositivo e il secondo PointOfSale elemento definisce un POS per gli utenti finali di lingua inglese nei dispositivi mobili. L'URL POS include dettagli sulla transazione, ad esempio le date di check-in e check-out, l'ID hotel e la lingua dell'utente. Bing usa il nome visualizzato e l'URL POS per creare un collegamento ipertestuale aggiunto all'annuncio. Quando l'utente fa clic sul collegamento, viene indirizzato al sito di prenotazione. Se si usano modelli di rilevamento per il rilevamento delle prestazioni, l'elemento LPURL url pagina di destinazione deve essere configurato nel file del feed POS per consentire il funzionamento del rilevamento. Bing usa il nome visualizzato e l'URL POS o LPURL per creare un collegamento ipertestuale aggiunto all'annuncio. Quando l'utente fa clic sul collegamento, viene indirizzato al sito di prenotazione.

  <PointOfSale id="English">
    <DisplayNames display_text="ContosoTravel.com" display_language="en" />
    <Match status="yes" language="en" />
    <URL>http://contoso.com/landing?hid=(PARTNER-HOTEL-ID)&amp;checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&amp;checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&amp;language=(USER-LANGUAGE)</URL>
    <LPURL>http://contoso.com/landing?hid=(PARTNER-HOTEL-ID)&amp;checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&amp;checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&amp;language=(USER-LANGUAGE)</LPURL>
  </PointOfSale>
  <PointOfSale id="English-Mobile">
    <DisplayNames display_text="ContosoTravel.com" display_language="en" />
    <Match status="yes" language="en" device="mobile" />
    <URL>http://mobile.contoso.com/landing?hid=(PARTNER-HOTEL-ID)&amp;checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&amp;checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&amp;language=(USER-LANGUAGE)</URL>
    <LPURL>http://mobile.contoso.com/landing?hid=(PARTNER-HOTEL-ID)&amp;checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&amp;checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&amp;language=(USER-LANGUAGE)</LPURL>
  </PointOfSale>

Includere l'elemento DisplayNames solo per le agenzie di viaggio online. Non includere per i DisplayNames fornitori del sistema di prenotazione centrale (CRS) (noti anche come partner di integrazione) e i fornitori diretti (ad esempio proprietari di hotel o catene). Per i fornitori CRS e i fornitori diretti, Bing utilizza il nome dell'hotel dal feed di proprietà.

Se si include DisplayNames, è necessario includere un Match elemento con il criterio del linguaggio impostato sulla stessa lingua.

Bing usa il POS che meglio corrisponde all'utente in base ai criteri di corrispondenza del POS. In base ai criteri di corrispondenza precedenti, gli utenti sui dispositivi mobili useranno il POS English-Mobile e tutti gli altri useranno il POS inglese. Per informazioni sul modo in cui Bing corrisponde agli utenti a un POS, vedere Corrispondenza delle pagine di destinazione. Per un elenco dei criteri su cui è possibile trovare la corrispondenza, vedere l'elemento Match .

L'elemento URL specifica il collegamento al sito in cui l'utente può prenotare la sala. L'esempio mostra l'uso di parametri di query dinamici. Bing sostituisce i valori per le variabili dinamiche in fase di esecuzione. Per informazioni sull'uso di parametri di query dinamiche, vedere Uso dei parametri di query dinamica.

Di seguito viene illustrato un documento XML completo delle pagine di destinazione.

<?xml version="1.0" encoding="UTF-8"?>
<PointsOfSale xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
  <PointOfSale id="English">
    <DisplayNames display_text="ContosoTravel.com" display_language="en" />
    <Match status="yes" language="en" />
    <URL>http://contoso.com/landing?hid=(PARTNER-HOTEL-ID)&amp;checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&amp;checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&amp;language=(USER-LANGUAGE)</URL>
  </PointOfSale>
  <PointOfSale id="English-Mobile">
    <DisplayNames display_text="ContosoTravel.com" display_language="en" />
    <Match status="yes" language="en" device="mobile" />
    <URL>http://mobile.contoso.com/landing?hid=(PARTNER-HOTEL-ID)&amp;checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&amp;checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&amp;language=(USER-LANGUAGE)</URL>
  </PointOfSale>
</PointsOfSale>

Corrispondenza delle pagine di destinazione

Le pagine di destinazione includono un Match elemento che contiene i criteri usati da Bing per associare un utente a un POS. Di seguito è riportato il criterio usato da Bing per associare gli utenti alle pagine di destinazione. L'elenco è in ordine di preferenza.

• paese
• valuta
• Lingua
• dispositivo
• sitetype

Bing usa le regole seguenti per trovare la migliore corrispondenza POS.

• Bing offre la preferenza più alta per le corrispondenze dei paesi e la preferenza minima per le corrispondenze dei dispositivi.

• Se Match non specifica uno dei criteri, Bing corrisponde in modo implicito a tutti i valori per il criterio. Ad esempio, se Match specifica la lingua e la valuta, Bing corrisponde in modo implicito a qualsiasi paese e dispositivo.

• Se Match specifica uno o più criteri, Bing usa il POS con le corrispondenze più esplicite.

• Se l'utente corrisponde a più pagine di destinazione, Bing usa il POS con la migliore qualità di corrispondenza. Se più pagine di destinazione hanno la stessa qualità di corrispondenza, Bing usa il primo POS trovato con tale qualità di corrispondenza. La qualità della corrispondenza è basata su:

  • Corrisponde alla preferenza più alta. Ad esempio, se un POS corrisponde solo alla valuta dell'utente e un altro corrisponde solo nel dispositivo dell'utente, Bing usa il POS corrispondente alla valuta dell'utente perché è superiore nell'ordine preferito.
  • Le corrispondenze esplicite sono preferibili rispetto alle corrispondenze implicite. Ad esempio, se un POS corrisponde in modo esplicito al paese dell'utente e un altro corrisponde in modo implicito al paese dell'utente, Bing usa il POS che corrisponde in modo esplicito.

L'attributo Match di stato dell'elemento determina se includere o escludere il POS in base alla corrispondenza. Se lo stato non è mai e Bing corrisponde a tutti i criteri, Bing non userà il POS. Per escludere un POS, tutti i criteri devono corrispondere. Nell'esempio seguente Bing esclude in modo esplicito il POS se l'utente proviene dagli Stati Uniti o dalla Francia e lo include in modo implicito se l'utente proviene da qualsiasi altro paese.

<PointOfSale id='exclude-example'>
  . . .
  <Match status='never' country='US' />
  <Match status='never' country='FR' />
  . . .
</PointOfSale>

Se lo stato è sì, Bing non eliminerà le pagine di destinazione dalla considerazione che non corrispondono in modo esplicito a tutti i criteri, ma viene data la preferenza al POS che corrisponde al criterio più. Nell'esempio seguente Bing corrisponde in modo esplicito all'utente al POS se il paese dell'utente è la Francia. Se il paese dell'utente non è la Francia, il POS verrà comunque considerato fino a quando non viene trovata una corrispondenza migliore. Se non viene trovata una corrispondenza migliore, Bing userà il POS.

<PointOfSale id='exclude-example'>
  . . .
  <Match status='yes' country='FR' />
  . . .
</PointOfSale>

Bing consiglia di usare gli stessi criteri di corrispondenza per ogni POS. Ciò riduce al minimo la complessità nel determinare il motivo per cui un POS ha confrontato un altro.

Uso di parametri di query dinamici

Un punto vendita (POS) contiene un URL elemento che identifica il sito in cui gli utenti possono prenotare sale. L'URL può contenere parametri di query dinamici, ovvero parametri definiti dall'utente che contengono un token predefinito per il relativo valore. Bing sostituisce quindi il token con un valore prima di aggiungere l'URL all'annuncio. Usando i parametri di query dinamica, è possibile includere l'ID dell'hotel, la data di check-in, la durata del soggiorno e altro ancora nell'URL.

Di seguito viene illustrata la sintassi usata per specificare i parametri di query dinamica nell'URL POS. Poiché i parametri di query dinamici sono parametri di query, devono seguire il simbolo del punto interrogativo (?) nell'URL.

http://domain.com/path?param-name=(dynamic-variable-name)

Di seguito sono riportati i possibili nomi di variabili dinamiche con distinzione tra maiuscole e minuscole che è possibile specificare nell'URL.

Tutte le date, ad esempio CHECKINDAY, si trovano nel fuso orario dell'hotel.

Di seguito viene illustrato un URL di esempio che contiene parametri di query dinamici ed entità codificate.

<URL>http://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)
  &amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)
  &amp;checkinYear=(CHECKINYEAR)&amp;nights=(LENGTH)</URL>

Prima che Bing usi l'URL nell'annuncio, sostituisce i valori con i nomi delle variabili dinamiche. Ad esempio, se l'utente prenota una stanza per 6 notti a partire dal 7/06/2021 per l'hotel n. 42, Bing esegue il rendering dell'URL come segue:

http://www.partnerdomain.com?hotelID=42&checkinDay=07&checkinMonth=05&checkinYear=2021&nights=6

Bing ottiene i valori per i parametri dinamici dal feed prezzi e dal feed proprietà, nonché dalle impostazioni specifiche dell'utente. Ad esempio, il valore della variabile LENGTH proviene dall'elemento Nights nel feed Price e il valore della variabile PARTNER-HOTEL-ID proviene dall'elemento id nel feed Proprietà.

Alcune variabili sono subset di elementi del feed di prezzi. Ad esempio, le variabili CHECKINDAY, CHECKINMONTH e CHECKINYEAR vengono estratte dall'elemento Checkin . Altre variabili vengono calcolate in base alle impostazioni locali dell'utente e ad altre impostazioni client.

Regole URL generali

Di seguito sono riportate le regole generali da seguire quando si usano variabili dinamiche.

• Tutti i parametri dinamici sono facoltativi. Non è necessario inserire parametri dinamici nell'URL POS. Tuttavia, l'uso di variabili per passare informazioni specifiche dell'itinerario e dell'utente in genere crea un'esperienza migliore per l'utente finale.

• Racchiudere i nomi delle variabili dinamiche con parentesi aperte e chiudi.

• Usare le entità codificate per i caratteri speciali. Sostituire ad esempio e commerciale (&) con &, spazio con %20 e barra (/) con %2F.

• I valori per un singolo parametro possono essere costruiti da più variabili. È ad esempio possibile costruire il valore di un parametro di query checkinDate dalle variabili CHECKINDAY, CHECKINMONTH e CHECKINYEAR.

  <URL>http://www.partnerdomain.com?checkinDate=(CHECKINDAY)%2F;(CHECKINMONTH)%2F;(CHECKINYEAR)</URL>  
  

• Per le variabili dinamiche riconosciute ma non supportate da Bing, Bing sostituisce la stringa di variabile con una stringa vuota.

• Poiché i parametri di query dinamici sono parametri di query, devono seguire il simbolo del punto interrogativo (?) nell'URL.

Uso di direttive condizionali

Oltre alle variabili elencate in precedenza, è anche possibile usare le direttive seguenti per creare la logica condizionale.

• IF-DEFAULT-DATE: si risolve in true se l'utente ha fatto clic su un annuncio dell'hotel che usava le date predefinite (l'utente non ha selezionato le date). Se true, Bing inserisce i valori che seguono questa direttiva nell'URL. In caso contrario, Bing inserisce i valori seguenti alla direttiva ELSE.

• ELSE: se la condizione precedente non viene soddisfatta, Bing inserisce i valori che seguono questa direttiva.

• ENDIF: termina il blocco condizionale.

Ad esempio, l'URL seguente imposta il parametro di query popup_datepicker su true se l'utente ha usato le date predefinite anziché specificare le date.

<URL>http://partner.com?hotelID=(PARTNER-HOTEL-ID)
&amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)&amp;checkinYear=(CHECKINYEAR)
&amp;nights=(LENGTH)(IF-DEFAULT-DATE)&amp;popup_datepicker=true(ELSE)
&amp;popup_datepicker=false(ENDIF)</URL>

Se true, Bing esegue il rendering dell'URL come segue:

http://partner.com?hotelID=123&checkinDay=01&checkinMonth=05&checkinYear=2021&nights=1&popup_datepicker=true

In caso contrario, Bing esegue il rendering dell'URL come segue:

http://partner.com?hotelID=123&checkinDay=23&checkinMonth=05&checkinYear=2021&nights=2&popup_datepicker=false

Regole generali

• Usare PointsOfSale XSD per convalidare il file di feed pagine di destinazione prima di inviarlo a Bing.

• Il documento feed pagine di destinazione deve usare la codifica UTF-8.

• Il feed deve includere pagine di destinazione per tutti i siti usati dagli utenti per prenotare le sale. Il processo di feed non supporta gli aggiornamenti parziali.

• Bing ignora qualsiasi elemento o attributo che non supporta.

• Gli elementi devono essere nell'ordine specificato in PointsOfSale XSD.

• Se i dati includono caratteri speciali, ad esempio apostrofi o virgolette, eseguire il escape o usare le sezioni CDATA. Se si esegue l'escape, è possibile usare codici entità o codici carattere. Ad esempio, puoi sfuggire a Paolo come Paolo' s o Paul's.

• Non includere elementi che non contengono dati. Ad esempio, se non si specifica un nome visualizzato per un hotel, non includere un elemento DisplayNames> vuoto<.

• Non usare HTML negli elementi XML.

Passaggi successivi

Dopo aver creato il file di feed, usare l'XSD PointsOfSale per convalidarlo.

Chiedere al gestore account di importare il file di feed.

Assicurarsi di importare anche i dati dell'hotel. Per informazioni sulla creazione del file del feed di proprietà, vedere Feed proprietà (in precedenza feed hotel).

Dopo aver importato correttamente il feed pagine di destinazione e il feed di proprietà, è possibile iniziare a inviare i dati relativi ai prezzi e alla disponibilità degli hotel. Per informazioni, vedere Feed di prezzi.