Creare un feed punti vendita

Nota

Questa versione beta di Hotel Price Ads è disponibile solo per selezionare i partecipanti. Per informazioni sulla partecipazione al programma di versione beta, contattare il proprio account manager o registrarsi qui.

Per fornire a Bing i dati dei punti vendita, 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.

Nota

Bing non supporta tutti gli elementi XSD. Bing ignora qualsiasi elemento o attributo nel documento che non supporta. Il riferimento ai punti vendita include solo gli elementi e gli attributi supportati da Bing.

Nota

Il documento deve specificare gli elementi nell'ordine definito in PointsOfSale XSD (o come illustrato nel riferimento).

Elemento di primo livello nel feed

Il feed punti vendita 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 punti vendita per un singolo partner.

Di seguito sono riportati PointOfSale gli elementi che definiscono i punti vendita 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 dell'hotel.

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 associa gli utenti a un POS, vedere Corrispondenza dei punti vendita. 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.

Nota

Se si specifica il criterio di corrispondenza tra lingua e paese, è necessario impostarlo solo su en e US .

Di seguito viene illustrato un documento XML completo sui punti vendita.

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

Punti vendita corrispondenti

I punti vendita 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 ai punti vendita. 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ù punti vendita, Bing usa il POS con la migliore qualità di corrispondenza. Se più punti vendita 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à i punti vendita dalla considerazione che non corrispondono in modo esplicito a tutti i criteri, ma viene data 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.

Nome	Descrizione
ADGROUP-ID	ID del gruppo di annunci che ha attivato l'annuncio. Si supponga, ad esempio, che l'URL sia www.northwindtraders.com/(ADGROUP-ID). Supponendo che l'ID del gruppo di annunci sia 2410012280, l'URL della pagina di destinazione dell'annuncio sarà www.northwindtraders.com/2410012280.
ANTICIPO-PRENOTAZIONE-FINESTRA	Numero di giorni prima della data di check-in che ha avuto luogo la prenotazione. Ad esempio, 36.
SITO BING	Proprietà Bing che ha originato la richiesta di annuncio. Di seguito sono riportati i valori possibili. localuniversal: l'annuncio ha origine da una pagina dei risultati della ricerca. mapresults: l'annuncio ha origine da un sito di mappe. PropertyPromotionAd: l'annuncio ha avuto origine dalla prima pagina dei risultati visualizzata in una ricerca di mappe. unknown: l'annuncio ha origine da un'origine non determinata. verifica: Bing usa questo valore quando si eseguono test di qualità dei dati nel sito. Queste query non vengono fatturate. Bing Analytics usa questo parametro e il relativo valore per identificare il traffico di verifica di Hotel Price Ads.
CAMPAIGN-ID	ID della campagna che ha attivato l'annuncio. Si supponga, ad esempio, che l'URL sia www.northwindtraders.com/(CAMPAIGN-ID). Supponendo che l'ID campagna sia 2410012280, l'URL della pagina di destinazione dell'annuncio sarà www.northwindtraders.com/2410012280.
CHECKINDAY	Giorno a due cifre specificato nell'elemento Checkin del messaggio di transazione. Ad esempio, 20.
CHECKINDAY-OF-WEEK	Giorno della settimana in cui avviene il check-in. Bing usa le cifre da 0 a 6 per rappresentare il lunedì e la domenica. Ad esempio, 1 è martedì.
CHECKINMONTH	Mese a due cifre specificato nell'elemento Checkin del messaggio Transaction. Bing usa le cifre da 00 a 11 per rappresentare da gennaio a dicembre. Ad esempio, 05 è giugno.
CHECKINYEAR	Anno a quattro cifre specificato nell'elemento Checkin del messaggio Transaction. Ad esempio, 2021.
CHECKOUTDAY	Giorno a due cifre estratto dall'utente. Bing usa gli Nights elementi e Checkin di TransactionMessage per calcolare il giorno. Ad esempio, 23.
CHECKOUTMONTH	Mese a due cifre estratto dall'utente. Bing usa gli Nights elementi e Checkin del messaggio di transazione per calcolare il mese. Ad esempio, 07.
CHECKOUTYEAR	Anno a quattro cifre estratto dall'utente. Bing usa gli Nights elementi e Checkin del messaggio Transaction per calcolare l'anno. Ad esempio, 2021.
CLICK-TYPE	Indica se l'utente ha fatto clic su un annuncio dell'hotel o su un annuncio di aggregazione della camera. Di seguito sono riportati i valori possibili. hotel: l'utente ha fatto clic su un annuncio dell'hotel. room: l'utente ha fatto clic su un annuncio del bundle della stanza. NOTA: Bing non supporta l'opzione room.
CUSTOM[1-5]	Valori dei campi personalizzati , ad esempio Custom1, specificati nell'elemento Result del messaggio Transaction.
TIPO DI DATA	Indica se l'utente ha specificato le date di archiviazione e di estrazione. Di seguito sono riportati i valori possibili. default: l'utente ha fatto clic su un annuncio dell'hotel che usava le date predefinite. selected: l'utente ha fatto clic su un annuncio dell'hotel con date di check-in e check-out specifiche.
HOTELGROUP_ID	Nota: HOTELGROUP_ID è un parametro legacy che fa riferimento a Hotel Center. Usare invece ADGROUP-ID. ID del gruppo di hotel a cui appartiene l'annuncio dell'hotel.
LUNGHEZZA	Lunghezza del soggiorno specificata nell'elemento Nights del messaggio di transazione. Ad esempio, 3.
NETWORK	Tipo di rete pubblicitaria in cui è stato pubblicato l'annuncio. o = proprietà e gestione (risultati della ricerca Bing, AOL e Yahoo) s = syndicated (risultati del sito del partner di ricerca) a = audience (posizionamento di Microsoft Audience Network) Si supponga, ad esempio, che l'URL sia www.northwindtraders.com/network=(NETWORK). Supponendo che la rete (distribuzione degli annunci) sia solo Bing, AOL e Yahoo (di proprietà e gestita), l'URL della pagina di destinazione dell'annuncio sarà www.northwindtraders.com/network=o.
NUM-ADULTS	Il numero di adulti che occupano la stanza. Il valore predefinito è 2.
VALUTA PARTNER	Codice di valuta di tre lettere specificato nell'attributo currency dell'elemento Baserate nel messaggio di transazione. Ad esempio, USD.
PARTNER-HOTEL-ID	ID dell'hotel specificato nell'elemento id del feed dell'hotel.
PARTNER-ROOM-ID	ID che identifica in modo univoco la stanza. Si tratta dell'ID specificato nell'elemento <RoomID> del <blocco Result>, <RoomBundle> o <RoomData> , a seconda dell'utilizzo.
PRICE-DISPLAYED-TAX	Importo dell'imposta nella valuta locale dell'utente. L'importo dell'imposta si basa sull'elemento Tax specificato nel messaggio di transazione. Ad esempio, 3.14.
PRICE-DISPLAYED-TOTAL	Costo totale della stanza nella valuta locale dell'utente. L'importo è basato sulla somma degli Baserateelementi , Taxe OtherFees specificati nel messaggio di transazione. Ad esempio, 152.13.
SLOT_TYPE	Posizionamento dell'annuncio nella pagina dei risultati. Il parametro può contenere i valori possibili seguenti: R: Slot di priorità in cui vengono visualizzati gli annunci nella pagina dei risultati al caricamento. B: slot secondario in cui gli annunci vengono visualizzati solo dopo che l'utente fa clic su Altre tariffe.
SUBACCOUNT_ID	Nota: SUBACCOUNT_ID è un paramater legacy che fa riferimento a Hotel Center. Usare invece CAMPAIGN-ID. ID dell'account secondario a cui appartiene la campagna di annunci sui prezzi dell'hotel.
USER-COUNTRY	Codice paese di due lettere del paese in cui si trova l'utente. Il valore viene estratto dalle impostazioni client dell'utente finale. Ad esempio, Stati Uniti.
USER-CURRENCY	Codice valuta di tre lettere della valuta locale usata dall'utente. Il valore viene dedotto dalle impostazioni client dell'utente finale. Ad esempio, USD.
USER-DEVICE	Tipo di dispositivo dell'utente finale. Di seguito sono riportati i valori possibili. cellulare tavoletta Desktop sconosciuto Il valore viene dedotto dalle impostazioni client dell'utente finale.
LINGUA UTENTE	Codice della lingua di due lettere che specifica la lingua di visualizzazione dell'annuncio. Il valore viene dedotto dalle impostazioni client dell'utente finale. Ad esempio, en.
VERIFICA	Valore booleano che indica se Bing ha generato il collegamento. Se Bing ha generato il collegamento, il valore è true. In caso contrario, false.

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 messaggio della transazione e dal feed hotel, nonché dalle impostazioni specifiche dell'utente. Ad esempio, il valore della variabile LENGTH proviene dall'elemento Nights nel messaggio di transazione e il valore della variabile PARTNER-HOTEL-ID proviene dall'elemento id nel feed hotel.

Alcune variabili sono subset di elementi Transaction Message. 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 del feed Punti vendita prima di inviarlo a Bing.

• Il documento del feed punti vendita deve usare la codifica UTF-8.

• Il feed deve includere punti vendita 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 dell'hotel, vedere Feed hotel.

Dopo aver importato correttamente il feed di punti vendita e il feed dell'hotel, è possibile iniziare a inviare i prezzi e i dati di disponibilità degli hotel. Per informazioni, vedere Messaggi di transazione.