Condividi tramite


Creare un file di feed di proprietà CSV (in precedenza feed hotel)

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 file CSV che contiene un elenco di ogni hotel che si vuole pubblicizzare. Un elenco descrive il nome, l'indirizzo, il numero di telefono e le coordinate geografiche dell'hotel.

Per informazioni sulla creazione di un file di feed tramite un documento XML, vedere Creazione di un file di feed di proprietà XML.

Nota

Il feed Proprietà supporta solo la lingua inglese.

Il formato CSV non supporta le immagini. Usare invece il formato XML.

Ottenere i dati corretti

Poiché Microsoft tenta di associare le proprietà del feed proprietà alle aziende di Bing Maps, è importante che i dati forniti sull'hotel siano accurati e completi.

Se l'hotel contiene informazioni mancanti o errate, Microsoft potrebbe non essere in grado di associarla. Se Microsoft non può corrispondere all'hotel, Microsoft non lo pubblicizza. Dopo che il tam ha importato il file del feed di proprietà, invierà un report 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, usare il TAM.

Definizione di un elenco di hotel

La prima riga del file di feed è la riga di intestazione, che contiene i nomi di colonna dei dati dell'hotel nel feed. L'intestazione deve includere i nomi di colonna di tutti gli elementi dati necessari. Includere i nomi delle colonne facoltative solo se si forniscono dati.

Di seguito è riportato l'elenco di colonne che è possibile includere nel feed. Il file di feed può contenere le colonne in qualsiasi ordine e i nomi di colonna non fanno distinzione tra maiuscole e minuscole.

Nome colonna Descrizione Tipo di dati Obbligatorio
id ID opaco definito dall'utente che identifica in modo univoco l'hotel all'interno del feed.

Quando crei il tuo feed price, usa questo ID nell'elemento Property del feed Price per identificare l'hotel.
Stringa
nome Il nome dell'hotel. Il nome può contenere un massimo di 200 caratteri. Stringa
indirizzo Indirizzo dell'hotel con testo in formato libero. Separare ogni componente dell'indirizzo con una virgola e racchiudere l'indirizzo tra virgolette. Ad esempio, "1234 Billings Way, Redmond, WA, 98030".

Utilizzare questa colonna solo se si specifica l'indirizzo usando testo in formato libero; in caso contrario, usare le colonne del componente indirizzo, ad esempio addr1, città e provincia. È preferibile usare le colonne del componente indirizzo invece di usare testo in formato libero.
Stringa
addr1 L'indirizzo dell'hotel. Ad esempio, 1234 Billings Way. L'indirizzo deve essere un indirizzo postale fisico e non una casella postale o un altro indirizzo di sola posta. Stringa
addr2 Seconda linea di indirizzi strada. Stringa No
addr3 Terza linea di indirizzi strada. Stringa No
città Il nome della città in cui si trova l'hotel. Stringa
provincia Nome dello stato, della regione o della provincia in cui si trova l'hotel. Stringa
postal_code Codice postale dell'indirizzo. Stringa
paese Paese o regione in cui si trova l'hotel. Specificare il paese o l'area geografica usando il codice paese ISO 3116 a due lettere. Ad esempio, usare gli Stati Uniti per gli Stati Uniti. Stringa
latitudine La latitudine delle coordinate geografiche dell'hotel.

Note:
  • La latitudine e la longitudine sono necessarie solo se non si specifica phone. È preferibile specificare sia il telefono che le coordinate geografiche.
  • La latitudine deve essere compreso tra -90,0 e 90,0.
  • Usare l'API Posizione o un altro strumento di geocodifica per generare le coordinate da un indirizzo.
Decimale No
longitudine La longitudine delle coordinate geografiche dell'hotel.

Note:
  • La latitudine e la longitudine sono necessarie solo se non si specifica phone. È preferibile specificare sia il telefono che le coordinate geografiche.
  • La longitudine deve essere compreso tra -180,0 e 180,0.
  • Usare l'API Posizione o un altro strumento di geocodifica per generare le coordinate da un indirizzo.
Decimale No
telefono Numero di telefono vocale principale utilizzato dai clienti per contattare l'hotel. Il numero deve essere il numero di telefono della reception e non un numero di telefono centrale per le prenotazioni.

Note:
  • Usare trattini, spazi o parentesi nel numero di telefono per semplificare la lettura. Ad esempio, usare "610-222-3333" o "(610) 222-3333" anziché "6102223333".
  • Specificare un solo numero di telefono; non specificare più numeri, ad esempio 650-123-2222/33.
  • Il numero di telefono può contenere un'estensione fino a 7 cifre. Anteporre le estensioni con una delle abbreviazioni seguenti: "ext", "extn" e "x". Ad esempio, "408-555-1111x12345" o "408-555-1111 x12345".
  • Il numero di telefono potrebbe non includere caratteri alfabetici.
  • Se il numero di telefono include il codice paese, precederlo con un "+". Ad esempio, "+65 6722-2323" per un numero a Singapore dove il codice del paese è 65 o "+001 (408) 555-1111" per un numero negli Stati Uniti dove il codice paese è 001.
Stringa
categoria Categoria che identifica il tipo di hotel. Il formato previsto è vacation_rental o hotel seguito dal carattere della 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.
Stringa No
hotel_brand Il marchio della catena alberghiera. Ad esempio, Fabrikam Residences by Contoso, dove Contoso è il marchio. Stringa No
star_rating La valutazione a stelle dell'hotel. I valori possibili sono compresi tra 1 e 5. Stringa No

Nota

La address colonna e le addrcolonne , addr2, addr3, provincecity, e postal_code si escludono a vicenda. Specificare la address colonna o le colonne del componente indirizzo. È preferibile specificare le colonne del componente indirizzo.

Anche se è possibile specificare coordinate geografiche o un numero di telefono, è necessario specificare entrambi per garantire una migliore probabilità di corrispondenza delle proprietà in Bing Maps.

Per includere una descrizione, immagini e recensioni per un elenco, usare un file di feed XML. Vedere Creare un file di feed di proprietà XML.

Di seguito viene illustrata un'intestazione di esempio in formato CSV. Separare tutte le colonne con una virgola. Includere solo le colonne che contengono valori per almeno un hotel.

id,name,addr1,city,province,postal_code,country,phone

Dopo la riga di intestazione, includere una riga per ogni hotel annunciato. Il feed deve includere annunci per tutti gli hotel. Il processo di feed non supporta gli aggiornamenti parziali. Non includere righe vuote nel feed.

Se un valore contiene una virgola, è necessario racchiudere il valore tra virgolette. Di seguito viene illustrato il contenuto di un file CSV di esempio.

id,name,addr1,city,province,postal_code,country,latitude,longitude,phone
abc123,Great Ambers Getaway,1234 Porter Rd,Goldendale,WA,98234,US,47.694351,-122.451782,123-456-7890

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.

Passaggi successivi

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.