Creare un file di feed di proprietà XML (in precedenza feed Hotel)
Nota
A partire dal 9 aprile, non avrai più accesso completo all'Hotel Center. Non vediamo l'ora di presentarti Property Center, che fornirà interessanti funzionalità self-service. Grazie per aver atteso pazientemente mentre aggiorniamo il contenuto della guida con le nuove funzionalità. Nel frattempo, è possibile leggere queste modifiche imminenti e come rendere il processo di migrazione più fluido.
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.
Il feed di proprietà e la documentazione sono soggetti a modifiche.
Per fornire a Microsoft le inserzioni dell'hotel, creare un documento XML contenente un elenco di ogni hotel che si desidera pubblicizzare. Un elenco descrive il nome, l'indirizzo, il numero di telefono, le coordinate geografiche, i servizi e altro ancora dell'hotel.
Il documento deve usare la codifica UTF-8 e deve essere conforme a Hotel XSD.
Per informazioni sulla creazione di un file di feed usando il formato di file CSV o TSV, vedere Creazione di un file di feed di proprietà CSV.
Nota
Microsoft non supporta tutti gli elementi XSD. Microsoft ignora qualsiasi elemento o attributo nel documento che non supporta. Il riferimento al feed di proprietà include solo gli elementi e gli attributi supportati da Microsoft.
Nota
Il documento deve specificare gli elementi nell'ordine definito in Hotel XSD (e come illustrato nel riferimento).
Ottenere i dati corretti
Poiché Microsoft tenta di associare le proprietà nel feed di proprietà alle aziende di Bing Maps, è importante che i dati forniti sull'hotel siano accurati e completi.
Se un hotel dispone di informazioni mancanti o errate, Microsoft potrebbe non essere in grado di associarla. Se Microsoft non può corrispondere all'hotel, Microsoft non lo pubblicizza. Sarà possibile visualizzare un report corrispondente nel centro dell'hotel che indica gli hotel corrispondenti o non corrispondenti a Microsoft. Se Microsoft non corrisponde all'hotel, il report include il messaggio Non è possibile associare l'hotel a una proprietà di Bing. Per migliorare la frequenza delle corrispondenze, assicurarsi che siano disponibili nelle posizioni Bing per le aziende.
Elemento di primo livello nel feed
Il feed di proprietà contiene un singolo elemento listato di primo livello. L'elemento listings contiene due elementi figlio obbligatori: language e listing.
<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<language>en</language>
<listing>
. . .
</listing>
...
</listings>
Nota
Attualmente supportiamo i dati dei feed solo in inglese.
L'elemento language specifica la lingua in cui vengono scritti i dati nel feed. Per specificare la lingua, usare il codice iso 639 a due lettere. Ad esempio, usare en per l'inglese .
L'elemento listing contiene informazioni sull'hotel, ad esempio nome, indirizzo e numero di telefono. Per informazioni sulla definizione di un elenco, vedere Definizione di un elenco di hotel.
Definizione di un elenco di hotel
L'elemento listing definisce un hotel. È necessario specificare un listing elemento per ogni hotel annunciato. L'esempio seguente mostra gli elementi minimi che è necessario specificare per un elenco. L'eccezione è che è possibile specificare le coordinate geografiche o un numero di telefono. Anche se è possibile specificare le coordinate o il numero di telefono, è consigliabile specificare entrambi per garantire una migliore probabilità di corrispondenza delle proprietà in Bing Maps.
<listing>
<id>abc123</id>
<name>Great Ambers Getaway</name>
<address>
<component name="addr1">1234 Porter Road</component>
<component name="city">Goldendale</component>
<component name="province">WA</component>
<component name="postal_code">98234</component>
</address>
<country>US</country>
<latitude>47.694351</latitude>
<longitude>-122.451782</longitude>
<phone type="main">123-456-7890</phone>
</listing>
L'ID nell'elemento id è definito dall'utente e deve essere univoco all'interno del feed.
L'indirizzo nell'elemento address è l'indirizzo dell'hotel. L'indirizzo deve essere un indirizzo e non una casella postale. È possibile specificare l'indirizzo dell'hotel usando l'elemento component visualizzato nell'esempio precedente o usando una stringa in formato libero illustrata nell'esempio seguente. La preferenza consiste nell'usare component gli elementi .
<address>1234 Porter Road, Goldendale, WA, 98234</address>
L'elemento latitude e longitude specifica le coordinate geografiche dell'hotel. Usare un'API di geocodifica, ad esempio l'API Posizione , per generare le coordinate da un indirizzo.
L'elenco deve specificare almeno il numero di telefono principale dell'hotel. Il numero principale deve essere il numero di telefono della reception e non un numero di telefono centrale per le prenotazioni. Maggiore è il numero di telefono di contatto che fornisci meglio è. L'esempio seguente mostra le altre opzioni del telefono.
<phone type="main">123-456-7890</phone>
<phone type="tollfree">800-456-7890</phone>
<phone type="fax">123-456-7890</phone>
<phone type="tdd">123-456-7890</phone>
<phone type="mobile">123-456-7890</phone>
Per altre informazioni su come specificare i numeri di telefono, vedere l'elemento phone .
Specifica dei campi di elenco di hotel facoltativi
L'esempio seguente mostra gli elementi facoltativi che è possibile includere nell'elenco. Anche se facoltativo, è necessario includere il maggior numero possibile di informazioni per supportare scenari di utilizzo correnti e futuri.
<listing>
. . .
<category>hotel | inn</category>
<content>
<text type="description">
<body>This element contains the hotel's description.</body>
</text>
<review type="user">
<body>This element contains a review of the hotel.</body>
<date month="2" day="24" year="2018" />
<link>https://contoso.com/reviews/hotels?id=sd87s90</link>
<rating>8.5</rating>
</review>
<attributes>
<website>https://contoso.com</website>
<attr name="air_conditioned">Yes</attr>
<attr name="has_airport_shuttle">Yes</attr>
<attr name="parking_type">No payment required</attr>
</attributes>
<image type="photo" url="https://contoso.com/photos?id=345k43llj" width=800 height=600>
<date month="3" day="3" year="2018" />
<link>https://contoso.com/...</link>
<title>Hotel entrance</title>
</image>
<neighborhoods>
<neighborhood>Sodo District</neighborhood>
</neighborhoods>
<brand>Contoso</brand>
</content>
</listing>
Il category formato previsto dell'elemento è vacation_rental o hotel seguito dal carattere di pipe e da un valore personalizzato. Ad esempio, vacation_rental | 'valore personalizzato' o hotel | 'valore personalizzato'
Per un elenco di valori personalizzati, vedere Categorie di proprietà Di alloggio.
L'elemento text contiene una descrizione dell'hotel. È necessario specificare l'elemento body , che contiene la descrizione effettiva. A seconda della lunghezza della descrizione, può essere troncata quando viene visualizzata. Se si includono gli link elementi e title , l'URL del collegamento punta alla descrizione online.
L'elemento review contiene una recensione utente o una recensione editoriale. Una recensione editoriale è una recensione professionale eseguita da un'autorità di revisione come un blogger di viaggi. Puoi includere qualsiasi numero di recensioni, ma a seconda del numero di recensioni inviate, potrebbero non essere tutte visualizzate. È necessario specificare l'elemento body , che contiene la revisione. A seconda della lunghezza della recensione, può essere troncata quando viene visualizzata. Se includi l'elemento link , punta all'elenco completo delle recensioni online.
L'elemento attributes contiene un elenco di servizi forniti dall'hotel, come l'aria condizionata, una piscina e la colazione gratuita. Per un elenco dei servizi possibili, vedere Attributo. Se non si specifica un servizio, si presuppone che l'hotel non lo fornisca.
L'elemento image contiene un'immagine dell'hotel. È possibile includere un numero qualsiasi di immagini, ma a seconda del numero di immagini inviate, potrebbero non essere tutte visualizzate. La razione di aspetto consigliata è 4:3 e la larghezza minima è di 720 pixel. Le immagini devono essere fotografie originali e potrebbero non essere screenshot. Si noti che l'URL link deve essere accessibile dal crawler AdIdxBot. Se il sito include il file robots.txt, deve includere:
- User-Agent: AdIdxBot
- Permettere:/
L'elemento neighborhood identifica il quartiere in cui si trova l'hotel. È possibile specificare più quartieri se l'hotel si trova in posizione centrale tra diversi quartieri.
L'elemento brand identifica il marchio dell'hotel. Ad esempio, Fabrikam Residences by Contoso, dove Contoso è il marchio.
Cosa accade se il contenuto dell'hotel cambia?
Se si modifica uno dei valori di proprietà dell'hotel tra le esecuzioni di feed (ad esempio, il nome, l'indirizzo, il telefono e così via), Microsoft Advertising può trattarlo come una nuova proprietà dell'hotel e creare una nuova inserzione. Se Microsoft crea una nuova inserzione, la cronologia delle prestazioni precedente per il vecchio hotel rimane disponibile per un massimo di 36 mesi. Si noti che le offerte e i moltiplicatori del vecchio hotel non verranno trasferiti alla nuova entità dell'hotel.
Se si rimuove un hotel e lo si aggiunge di nuovo in un feed successivo con gli stessi valori di proprietà di prima, Microsoft lo considera come una nuova inserzione. Inoltre, il report sulle prestazioni lo mostrerà come due elenchi separati.
Regole generali
Usare l'XSD hotel per convalidare il file del feed di proprietà prima di inviarlo a Microsoft.
Il documento del feed di proprietà deve usare la codifica UTF-8.
Il feed deve includere annunci per tutti gli hotel. Il processo di feed non supporta gli aggiornamenti parziali.
Microsoft ignora qualsiasi elemento o attributo che non supporta.
Gli elementi devono essere nell'ordine specificato in Hotel 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 specificano le coordinate geografiche per un hotel, non includere elementi vuoti <di latitudine> e <longitudine> .
Non usare HTML negli elementi XML.
Passaggi successivi
Dopo aver creato il file di feed, usare l'XSD hotel per convalidarlo.
Chiedere al gestore account di importare il file di feed.
Assicurarsi di importare anche i dati delle pagine di destinazione. Per informazioni sulla creazione del file di feed pagine di destinazione, vedere Feed pagine di destinazione.
Dopo che Microsoft ha importato correttamente i dati ed è in grado di associare gli hotel alle proprietà in Bing Maps, è possibile iniziare a inviare i dati relativi ai prezzi e alla disponibilità degli hotel. Per informazioni, vedere Feed di prezzi.