Per promuovere il tuo inventario di hotel su Facebook, devi condividere le informazioni sui tuoi hotel con Facebook. A tale scopo, crea un catalogo e compilalo con i tuoi hotel. Esistono due modi per compilare e aggiornare il catalogo:
Puoi creare e gestire il tuo catalogo di hotel in Gestione dei cataloghi.
Per usare l'API per la gestione del catalogo:
Un elenco di hotel è un file con il tuo inventario di hotel. Ogni riga o voce del file rappresenta un singolo hotel. Puoi usare uno o più elenchi di hotel, purché tutti gli elenchi contengano il tuo inventario di hotel completo.
CSV di esempio | TSV di esempio (appiattito) | TSV di esempio (stile JSON)
"
virgolette doppie"
. address
, neighborhood
o image
, possono essere rappresentati usando valori con codifica JSON o tramite una serie di colonne a testo semplice "appiattite", etichettate usando una sintassi con percorso JSON (ad es., address.city
, neighborhood[0]
, image[0].url
, image[0].tag[0]
, image[0].tag[1]
). Entrambe le convenzioni possono essere usate in modo intercambiabile all'interno dello stesso file.<listings>
radice comprende una serie di nodi <listing>
, dove ciascuno rappresenta un hotel.<?xml
valido. Il parser dell'elenco rileva in automatico le codifiche di testo UTF8
, UTF16
o UTF32
e imposta LATIN1
come valore predefinito se individua una sequenza di byte non prevista. Puoi fornire testo nei valori dei campi in qualsiasi lingua, ma i nomi dei campi devono essere indicati come mostrato qui sotto, in inglese.
I seguenti campi supportati sono progettati per le voci che aggiunti al catalogo prodotti.
Per i cataloghi localizzati, vedi i campi supportati per le inserzioni per gli hotel.
Campo e tipo | Descrizione |
---|---|
tipo: stringa | Obbligatorio Lunghezza massima: 100 Il tuo identificativo unico per l'hotel all'interno del catalogo. Tale ID è abbinato a qualsiasi Esempio: |
tipo: stringa | Obbligatorio se si aggiungono informazioni sulle stanze dell'hotel. Immetti un ID unico per il tipo di stanza dell'hotel. Caratteri massimi: 100 Esempio: |
tipo: stringa | Obbligatorio Il nome più comune dell'hotel. Esempio: |
tipo: stringa | Obbligatorio Dimensioni massime: 5000 Breve descrizione dell'hotel. Esempio: |
tipo: stringa | Obbligatorio se si aggiungono informazioni sulle stanze dell'hotel. Data del check-in per la permanenza in hotel. Puoi aggiungere fino a 180 giorni dalla data di caricamento dell'elenco. Usa lo standard ISO-8601 ( Esempio: |
tipo: stringa | Obbligatorio se si aggiungono informazioni sulle stanze dell'hotel. Numero di notti di permanenza in hotel. Esempio: |
tipo: stringa | Obbligatorio se si aggiungono informazioni sulle stanze dell'hotel. Prezzo base della stanza dell'hotel per notte. Assicurati di aggiungere il tipo di valuta al prezzo (ad esempio, USD per i dollari americani). Il prezzo deve avere lo stesso formato del costo, seguito dal codice di valuta ISO, con uno spazio tra costo e valuta. Esempio: |
tipo: stringa | Obbligatorio se si aggiungono informazioni sulle stanze dell'hotel. Prezzo totale della permanenza in hotel, in base a Esempio: |
tipo: stringa | Obbligatorio se si aggiungono informazioni sulle stanze dell'hotel. Aliquota di imposta applicabile al prezzo. Il prezzo deve avere lo stesso formato del costo, seguito dal codice di valuta ISO, con uno spazio tra costo e valuta. Esempio: |
tipo: stringa | Obbligatorio se si aggiungono informazioni sulle stanze dell'hotel. Oneri applicabili al prezzo. Il prezzo deve avere lo stesso formato del costo, seguito dal codice di valuta ISO, con uno spazio tra costo e valuta. Esempio: |
tipo: stringa | Obbligatorio Il link al sito esterno in cui è possibile prenotare una stanza dell'hotel. Puoi specificare anche un URL a livello dell'inserzione usando Esempio: |
tipo: oggetto | Consulta Parametri dell'oggetto immagine. |
tipo: oggetto | Consulta Parametri dell'oggetto image. |
tipo: stringa | Obbligatorio Nome del brand della catena di hotel. Esempio: |
tipo: oggetto | Consulta Parametri dell'oggetto address. |
tipo: stringa | Obbligatorio Voci max. per quartiere: 20 Quartiere in cui è ubicato l'hotel. Se è presente più di un quartiere, aggiungi ulteriori colonne per ognuno di essi e usa una sintassi con percorso JSON nel nome di ciascuna colonna per indicare il numero di quartieri. Esempio: |
tipo: float | Obbligatorio Latitudine dell'hotel. Esempio: |
tipo: float | Obbligatorio Longitudine dell'hotel. Esempio: |
tipo: stringa | Facoltativo. Prezzo di vendita per notte di permanenza nell'hotel, in base a Esempio: |
tipo: oggetto | Consulta Parametri dell'oggetto guest rating. |
tipo: oggetto | Consulta Parametri dell'oggetto guest rating. |
tipo: float | |
tipo: stringa | Facoltativo. Il programma fedeltà che usi per accumulare punti per la permanenza in hotel. Esempio: |
tipo: intero | Facoltativo. Indicatore di redditività dell'hotel; valore da 1 a 10. Esempio: |
tipo: stringa | Facoltativo. Numero di telefono principale dell'hotel. Esempio: |
tipo: oggetto | Facoltativo. Deep link che reindirizza direttamente alla pagina di informazioni dell'hotel nella tua app mobile usando i deep link all'interno dell'app. Puoi specificare i deep link in ordine di precedenza, dalla più alta alla più bassa:
Scopri di più sui deep link dei prodotti. |
tipo: intero | Facoltativo. Un indicatore della priorità dell'hotel; valore da 0 (priorità minima) a 5 (priorità massima). Esempio: |
tipo: stringa | Facoltativo. Il tipo di proprietà. La categoria può essere un tipo qualsiasi di descrizione interna. Esempio: |
tipo: intero | Facoltativo. Numero totale di stanze/unità nell'annuncio di questo hotel. Esempio: |
Tipo: stringa | Controlla se un articolo è attivo o archiviato nel tuo catalogo. Le persone possono vedere solo gli articoli attivi nelle tue inserzioni, nei tuoi shop o in qualsiasi altro canale. Valori supportati: Esempio: Nota: alcune piattaforme partner come Shopify potrebbero sincronizzare gli articoli sul tuo catalogo con uno stato chiamato staging, che si comporta come In precedenza questo campo si chiamava |
Nome e tipo di campo | Descrizione |
---|---|
tipo: stringa | Obbligatorio N. max. di elementi: 20. URL all'immagine dell'elemento che comparirà nelle inserzioni. Segui queste specifiche dell'immagine:
Esempio: Esempio: |
tipo: stringa | Facoltativo. Tag allegato all'immagine a indicare il contenuto dell'immagine. Possono essere presenti più tag associati a un'immagine. Esempi:
|
I campi nidificati o con più valori, ad esempio address
, possono essere rappresentati usando valori con codifica JSON o tramite una serie di colonne a testo semplice senza struttura, etichettate usando una sintassi con percorso in stile JSON come address.region
. Entrambe le convenzioni possono essere usate in modo intercambiabile all'interno dello stesso file.
Nome e tipo di campo | Descrizione |
---|---|
tipo: oggetto | Obbligatorio Indirizzo principale dell'hotel. Esempio: |
tipo: oggetto | Facoltativo. Indirizzo secondario dell'hotel. Esempio: |
tipo: oggetto | Facoltativo. Ulteriore indirizzo dell'hotel. Esempio: |
tipo: stringa | Facoltativo. Valore da usare nell'URL del deep link ( Esempio: |
tipo: stringa | Obbligatorio Città in cui è ubicato l'hotel. Esempio: |
tipo: stringa | Obbligatorio Stato, contea o provincia in cui è ubicato l'hotel. Esempio: |
tipo: stringa | Obbligatorio Paese in cui è ubicato l'hotel. Esempio: |
tipo: stringa | Obbligatorio per i Paesi con un sistema di codici postali. Codice postale o CAP dell'hotel. Esempi: |
Nome e tipo di campo | Descrizione |
---|---|
tipo: oggetto | Facoltativo. Numero totale di persone che hanno recensito l'hotel. Se specificato, devi indicare anche Esempio: |
| Facoltativo. Numero totale di persone che hanno valutato l'hotel. Esempio: |
tipo: stringa | Facoltativo. Sistema che utilizzi per le recensioni degli ospiti. Esempi: |
tipo: int | Obbligatorio Valore massimo per il punteggio delle valutazioni dell'hotel. Deve essere pari o superiore a 0 e pari o inferiore a 100. Esempio: |
Puoi usare l'API Hotel per aggiungere, modificare e rimuovere direttamente gli hotel nel tuo catalogo. Consulta il riferimento all'API Hotel per maggiori informazioni su come gestire gli hotel attraverso l'API.
Le seguenti sezioni sono pertinenti solo per la gestione dei tuoi cataloghi mediante questa API.
Un catalogo di hotel è un contenitore per il tuo inventario di hotel. Per usare l'API Catalog, assicurati di avere il livello di accesso dell'API Marketing corretto e di aver accettato le Condizioni d'uso creando il tuo primo catalogo mediante Business Manager.
Per creare un catalogo di hotel per le inserzioni per gli hotel, imposta vertical
su hotels
:
curl -X POST \ -F 'name="Test Hotel Catalog"' \ -F 'vertical="hotels"' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v10.0/BUSINESS_ID/owned_product_catalogs
Una volta creato il tuo catalogo, devi caricare i tuoi elenchi di hotel su Facebook. Usa l'API per creare un oggetto elenco per ciascun elenco che desideri caricare. Sono supportati caricamenti programmati e diretti.
Un insieme di hotel è un sottoinsieme del tuo catalogo. Per configurare le inserzioni per gli hotel, hai bisogno di un insieme di hotel. Pertanto, ne devi creare almeno uno.
Gli insiemi di hotel sono definiti dai filtri applicati al relativo catalogo. Ad esempio, puoi creare un insieme di hotel con tutti quelli caratterizzati da un valore di star_rating
superiore a 3. Nota: puoi anche creare un insieme di hotel senza filtri. In questo caso, l'insieme di hotel conterrà tutti gli hotel del tuo catalogo.
Per creare un insieme di hotel contenente tutti gli hotel con l'elemento "sample brand" menzionato nel campo brand
:
Il parametro filter
è composto dai seguenti operatori e dati:
Operatori | Il tipo di filtro |
---|---|
| Contiene sottostringhe. L'operatore non distingue tra lettere maiuscole e minuscole. |
| Non contiene sottostringhe. L'operatore non distingue tra lettere maiuscole e minuscole. |
| Contiene sottostringhe. L'operatore non distingue tra lettere maiuscole e minuscole. |
| Non contiene sottostringhe. L'operatore non distingue tra lettere maiuscole e minuscole. |
| Uguale a. L'operatore non distingue tra lettere maiuscole e minuscole. |
| Diverso da. L'operatore non distingue tra lettere maiuscole e minuscole. |
| Minore di. Solo per campi numerici. |
| Minore di o uguale a. Solo per campi numerici. |
| Maggiore di. Solo per campi numerici. |
| Maggiore di o uguale a. Solo per campi numerici. |
Dati | I dati filtrati. |
---|---|
| Il tuo identificativo unico per l'hotel all'interno del catalogo. |
| Il brand della catena di hotel. |
| Il prezzo base per notte per l'hotel. Il prezzo è espresso in centesimi (4999 indica $ 49,99). |
| Il prezzo di vendita per notte per l'hotel. Il prezzo è espresso in centesimi (4999 indica 49,99 dollari). |
| Valuta |
| Città in cui è ubicato l'hotel. |
| Paese in cui è ubicato l'hotel. |
| Il nome più comune dell'hotel. |
| Numero di stelle dell'hotel. I valori validi sono compresi tra 1 e 5 e devono essere un multiplo di 0,5. |