L'elenco di hotel contiene tutte le proprietà e le informazioni sulla proprietà che un partner vuole mostrare su Google. I partner forniscono i dati di origine tramite un file CSV o XML contenente gli attributi fisici della proprietà, come nome, indirizzo, posizione geocodificata, numeri di telefono e URL di siti web.
Prima di iniziare
Requisiti per gli hotel
Per essere visualizzata su Google, una proprietà nell'elenco di hotel deve soddisfare i requisiti per gli hotel. Alcuni esempi di proprietà non idonee sono appartamenti, strutture per soggiorni di lunga durata (più di 30 giorni) e case vacanze. Se vuoi aggiungere case vacanze al tuo elenco di proprietà, consulta la Guida introduttiva per i partner VR.
Puoi inviare proprietà stagionali o chiuse temporaneamente per la scheda, ma le proprietà chiuse definitivamente non sono idonee.
Qualità dei dati
Perché vengano pubblicati, i dati dell'elenco di hotel devono corrispondere alle informazioni presenti nell'elenco di attività di proprietà di Google Maps. Fornisci sempre nel modo più accurato possibile le informazioni delle proprietà, tra cui numeri di telefono, latitudine e longitudine. Inoltre, assicurati che le informazioni fornite sull'hotel corrispondano a quelle presenti su Google Maps e Profilo dell'attività su Google.
Se la tua proprietà contiene informazioni mancanti o errate potrebbe non essere trovata e non potrai pubblicizzarla. Puoi visualizzare un elenco di hotel corrispondenti e con problemi relativi ai dati nella pagina "Proprietà". Scopri di più sulla risoluzione dei problemi di corrispondenza delle proprietà con la corrispondenza manuale
Per i partner nuovi e quelli in fase di onboarding: un tasso di corrispondenza basso è normale durante la procedura di onboarding. Google consiglia di caricare inizialmente tutti gli hotel e di selezionare una parte degli hotel associati correttamente per cui iniziare a inviare i prezzi. Oltre a verificare la configurazione del feed del prezzo, continua a migliorare il tuo tasso di corrispondenza dell'elenco di hotel. Anche se non è obbligatorio, Google consiglia di raggiungere un tasso di corrispondenza a lungo termine superiore al 90%.
Istruzioni
1. Scegliere come inviare l'elenco di hotel
Puoi utilizzare il caricamento dell'elenco di hotel per caricare manualmente il tuo elenco di hotel come file CSV o XML oppure puoi utilizzare il pull dell'elenco di hotel (in precedenza noto come feed elenco hotel) per ospitare file XML sul tuo server. Il caricamento dell'elenco di hotel supporta l'invio manuale di singoli file con dimensioni generalmente inferiori a 50.000 proprietà. Per questi file, Google consiglia di utilizzare la sintassi CSV per le integrazioni con i contenuti di base degli hotel elencati in una sola lingua.
Per contenuti più dettagliati, puoi utilizzare la sintassi XML. Se prevedi di aggiornare le informazioni sugli hotel di rado, fornire contenuti in una sola lingua e avere meno di 50.000 proprietà in Hotel Center, Google consiglia di utilizzare il caricamento manuale dell'elenco di hotel.
Nota: se prevedi di aggiornare l'elenco di hotel di frequente o hai bisogno di contenuti in più lingue, ti consigliamo vivamente di implementare il pull dell'elenco con Google ospitando un file XML sul tuo server. Google estrarrà spesso i file più recenti disponibili e pubblicherà o aggiornerà automaticamente i contenuti sul tuo account. Questo semplificherà tutte le fasi manuali necessarie per caricare e pubblicare i file ogni volta che sarà richiesto un aggiornamento.
Se vuoi implementare il pull di un elenco hotel, contatta il team di assistenza di Hotel Ads.
2. Creare l'elenco di hotel
Dopo aver scelto la modalità di invio per la configurazione del tuo elenco di hotel, crea i file CSV o XML.
File CSV
Un elenco di hotel in formato CSV è costituito da una sola riga di intestazione con i nomi delle colonne e da una riga aggiuntiva per ogni hotel nel feed.
La prima riga specifica i nomi delle colonne da utilizzare nel feed. Ad esempio:
id,name,addr1,addr2,addr3,city,province,postal_code,country,phone,latitude,longitude
Non tutti i campi sono obbligatori. La tabella seguente descrive ciascuno dei campi disponibili:
Colonna | Obbligatorio? | Descrizione |
---|---|---|
id |
Obbligatorio | Un identificativo univoco dell'hotel. Questo valore deve essere univoco nel sito. |
name |
Obbligatorio | Il nome dell'hotel. Ad esempio "Hotel Miramare". |
address |
Obbligatorio* |
L'indirizzo completo dell'hotel in formato libero. Ad esempio "Via Verdi 66, 6° piano, Suite 610, Roma, Lazio, 00100". Nota: se hai già compilato i campi |
addr1 |
Obbligatorio | L'indirizzo principale dell'hotel. Ad esempio "Via Verdi 66". Caselle postali e altri indirizzi solo postali non sono considerati indirizzi fisici completi. |
addr2 |
Facoltativo | Indirizzo secondario e facoltativo dell'hotel. Ad esempio "6° piano". |
addr3 |
Facoltativo | Terza parte facoltativa dell'indirizzo dell'hotel. Ad esempio "Suite 610". |
city |
Obbligatorio | La città dell'hotel. Ad esempio "Roma". |
province |
Obbligatorio | La provincia o la regione dell'hotel. Ad esempio "Roma" o "Lazio". |
postal_code |
Obbligatorio | Il codice postale dell'hotel. Ad esempio "00100". |
country |
Obbligatorio | Il paese dell'hotel. Il valore deve essere un codice ISO 3116 del paese composto da due lettere maiuscole. Ad esempio "US" per gli Stati Uniti e "IT" per l'Italia. |
phone |
Obbligatorio* | Il numero di telefono principale dell'hotel. Ad esempio "+39 06 12 345 678". |
latitude |
Obbligatorio* | La latitudine corrispondente alla posizione dell'hotel. Ad esempio "37.423738". |
longitude |
Obbligatorio* | La longitudine corrispondente alla posizione dell'hotel. Ad esempio "-122.090101". |
category |
Facoltativo | La categoria dell'hotel. Ad esempio "Hotel", "Bed and breakfast" o "Motel". |
star_rating |
Facoltativo | La categoria hotel in termini di valutazione a stelle. Il valore deve essere un numero intero compreso tra 1 e 5 o vuoto. Ad esempio "1" per un hotel a una stella, "5" per un hotel a cinque stelle o "" per una valutazione a stelle sconosciuta. |
hotel_brand |
Facoltativo | Il brand a cui appartiene l'hotel. Ad esempio "Marriott" o "Hilton". |
alternate_hotel_id |
Facoltativo | Un identificatore alternativo per la tua proprietà. La presenza di ID separati è utile nei casi in cui tu possa avere identificatori di proprietà diversi per le informazioni dei feed e per il motore di prenotazione. |
custom_0 |
Facoltativo | Qualsiasi attributo personalizzato di tipo stringa. Questi attributi non verranno mostrati agli utenti. |
custom_1 |
Facoltativo | |
custom_2 |
Facoltativo | |
custom_3 |
Facoltativo | |
custom_4 |
Facoltativo | |
*È obbligatorio specificare le coordinate di latitudine e longitudine o un numero di telefono. Si consiglia di specificare entrambi. |
Quando specifichi i dati nel feed, tieni presente le seguenti linee guida:
- Google consiglia di modificare i dati con Fogli Google, Excel o altre applicazioni di fogli di lavoro ed esportare il file in formato CSV.
- Le colonne possono essere disposte nell'ordine che preferisci, ma i nomi delle colonne devono corrispondere ai valori indicati in precedenza.
- Tutte le colonne devono essere separate da una virgola.
- Se uno dei valori contiene una virgola, devi racchiuderlo tra virgolette. Ad esempio "Hotel Pane, Amore e Fantasia".
- Se nessun hotel contiene un valore per una determinata colonna, puoi lasciarla vuota (a meno che non sia obbligatoria).
Indirizzi in formato libero
Anziché utilizzare colonne separate per ogni parte di un indirizzo, puoi utilizzare la colonna address
per specificare un indirizzo in "formato libero". È preferibile tuttavia utilizzare indirizzi strutturati.
Quando specifichi valori di indirizzo in formato libero, separa ogni elemento con una virgola (ad es. "Corso Italia 76, Frascati, Roma, 00044").
La colonna address
sostituisce le colonne addr1
, addr2
, addr3
, city
, province
e postal_code
. Se specifichi un indirizzo in formato libero, devi comunque immettere un valore nella colonna country
.
Esempi CSV
L'esempio seguente mostra un elenco semplice con un solo hotel che include i valori per il numero di telefono e le coordinate: id,name,addr1,city,provincia,CAP_code,country,phone,latitude,longitude
123abc,Belgrave House,76 Buckingham Palace Road,London,Greater London,SW1W 9TQ,UK,123-456-7890,35.070374,-106.213648
L'esempio seguente mostra un hotel che include solo i valori delle coordinate, senza numero di telefono:
id,name,addr1,city,province,postal_code,country,latitude,longitude
123abc,Belgrave House,76 Buckingham Palace Road,London,Greater London,SW1W 9TQ,UK,35.070374,-106.213648
L'esempio seguente mostra un hotel il cui indirizzo è in formato libero:
id,name,address,country,phone,latitude,longitude
123abc,Belgrave House,"76 Buckingham Palace Road, London, Greater London, SW1W 9TQ",UK,123-456-7890,35.070374,-106.213648
File XML
Per maggiori dettagli sulla creazione di un file XML per l'elenco di hotel, consulta la pagina di riferimento sul file XML dell'elenco di hotel.
3. Ospitare o caricare l'elenco di hotel
Per ospitare l'elenco di hotel e utilizzare il pull dell'elenco, consulta Ospitare sul server il feed XML. In alternativa, per accedere a Hotel Center e caricarlo manualmente, procedi come segue:
- Nel tuo account Hotel Center, seleziona Proprietà dal menu "Navigazione".
- Fai clic su Impostazioni.
- I nuovi utenti devono rispondere alle domande di configurazione, tra cui il formato che si vuole utilizzare per l'elenco di hotel.
- Verifica che i contenuti o lo schema dell'elenco di hotel corrispondano ai criteri di formattazione, quindi carica il file CSV o XML. Nota: il caricamento del file potrebbe richiedere fino a un'ora.
- Se il file non è valido, riceverai un messaggio di errore. Apporta le modifiche necessarie e ripeti il caricamento.
- Riceverai un'email di conferma quando il file verrà caricato su Hotel Center. Una volta confermato il caricamento, torna alla pagina "Impostazioni proprietà" per pubblicare l'elenco di hotel. Puoi modificare le impostazioni di notifica nella pagina "Impostazioni account" selezionando la categoria "Avvisi".
4. Pubblicare l'elenco di hotel (solo per caricamento dell'elenco di hotel)
Dopo aver caricato almeno un elenco di hotel, puoi scegliere quale impostare come versione attiva.
Per scegliere l'elenco di hotel attivo:
- Nel tuo account Hotel Center, seleziona Proprietà dal menu "Navigazione".
- Fai clic su Impostazioni.
- Nella scheda "Pubblica", fai clic su Pubblica per attivare l'elenco. L'elaborazione della pubblicazione può richiedere un giorno lavorativo.
Dopo aver pubblicato l'elenco di hotel, consulta la pagina "Proprietà" in Hotel Center per vedere quali hotel non corrispondono, se necessario. Scopri come risolvere i problemi di corrispondenza delle proprietà con la corrispondenza manuale
Puoi ripristinare i caricamenti precedenti passando il mouse sopra il nome del file e facendo clic su "Ripubblica questo file".
5. Aggiornare l'elenco di hotel esistente (solo per caricamento dell'elenco di hotel)
Una volta pubblicato un elenco di hotel, puoi aggiornarlo caricando un elenco modificato per sovrascrivere la versione precedente.
Per aggiornare un elenco di hotel:
- Scarica l'elenco di hotel che vuoi aggiornare. Gli elenchi di hotel caricati di recente sono riportati nella colonna "Caricati in precedenza".
- Modifica l'elenco di hotel cambiando ciò che vuoi.
- Ricarica l'elenco di hotel nella pagina "Impostazioni proprietà".
- Per caricare il nuovo file, consulta le istruzioni precedenti nella sezione Ospitare o caricare l'elenco di hotel.