Inserzioni per hotel: prezzi specifici per data

In un elenco statico di hotel, devi indicare un singolo prezzo per ciascun hotel. Non puoi indicare prezzi diversi in base alla data del check-in, alla durata del soggiorno o alla tipologia di camera. Per mostrare nelle inserzioni prezzi più accurati in base a queste variabili, puoi usare i prezzi dinamici (specifici per data) per indicare il costo in base alla data, al tipo di camera e alla durata del soggiorno. Dopo averli forniti, puoi utilizzare i modelli di tag per gli hotel per usare questi prezzi nelle inserzioni.

Utilizza il caricamento in gruppo dei dati su tipologia di camera e prezzi per condividere i dettagli sui prezzi con Facebook.

Per una spiegazione di tutti i parametri, consulta i parametri relativi a camere e prezzi.

Caricamento in gruppo dei dati su tipologia di camera e prezzi

Il caricamento in gruppo è suddiviso in due parti:

  1. Caricamento delle tipologie di camera
  2. Caricamento dei prezzi

Se usi il caricamento in gruppo, il limite è di 50 MB per file (circa 50 000 voci per file). Per le variabili di prezzo, sono consigliati aggiornamenti più frequenti e di minori dimensioni.


Caricamento delle tipologie di camera

Carica uno o più file con le tipologie di camera mediante l'API Hotel Rooms Batch.

Nota: se non hai tipologie di camera diverse, puoi saltare questo passaggio.

curl \
  -X POST \
  -F file=@hotel_rooms_data_xml.xml \
  -F "access_token=<ACCESS_TOKEN>" \
  https://graph.facebook.com/<API_VERSION>/<PRODUCT_CATALOG_ID>/hotel_rooms_batch

Formato del file delle tipologie di camera

Puoi indicare le tipologie di camera in formato XML; consulta l'esempio.

Devi identificare ciascun hotel con <property> nel nodo XML <PropertyDataSet> e indicare le tipologie di camera con <RoomData>. Il file deve iniziare con il tag dichiarativo <?xml.

Per ulteriori dettagli su aggiornamento ed eliminazione delle tipologie di camera mediante l'API batch, consulta Camere di hotel, Riferimento batch.


Caricamento dei prezzi

Carica uno o più file con i dettagli sui prezzi mediante l'API Pricing Variable Batch. Puoi caricare i dettagli sui prezzi con o senza le tipologie di camera.

Nota: se disponi solo di un numero molto limitato di camere, puoi anche utilizzare l'API Hotel Room per creare le tipologie di camera e configurare i prezzi.

curl \
  -X POST \
  -F file=@pricings_data_xml.xml \
  -F "access_token=<ACCESS_TOKEN>" \
  https://graph.facebook.com/<API_VERSION>/<PRODUCT_CATALOG_ID>/pricing_variables_batch

Formato del file dei prezzi

Prima di caricare le tipologie di camera, assicurati che gli hotel relativi a queste camere siano già presenti nel catalogo. Puoi indicare le variabili di prezzo in questo formato:

Formato del file ed esempioDescrizione

XML con tipologie di camera | XML di esempio

Assicurati che le tipologie di camera per cui desideri indicare i prezzi siano già esistenti.


Specifica il prezzo (<Baserate>) all'interno di ciascuna tipologia di camera (<RoomBundle>) in base alla combinazione di data di check-in (<Checkin>) e durata del soggiorno (<Nights>).


Il file deve iniziare con il tag dichiarativo <?xml.

XML senza tipologie di camera | XML di esempio

Specifica il prezzo (<Baserate>) per ciascuna combinazione di ID hotel (<Property>), data di check-in (<Checkin>) e durata del soggiorno (<Nights>).


Il file deve iniziare con il tag dichiarativo <?xml.

Per ulteriori dettagli sulla modalità di aggiornamento ed eliminazione in gruppo delle variabili di prezzo, consulta il Riferimento per operazioni in gruppo su variabili di prezzo.

Parametri relativi a camere e prezzi

Nome e tipo di campoDescrizione

Property

tipo: stringa

Obbligatorio. Un identificativo unico dell'hotel indicato dall'inserzionista come hotel_id nell'elenco degli hotel.

RoomID

tipo: stringa

Obbligatorio. Un identificativo unico della tipologia di camera indicato dall'inserzionista.

Name

tipo: stringa

Obbligatorio. Nome della tipologia di camera dell'hotel.

Description

tipo: stringa

Obbligatorio. Descrizione della tipologia di camera dell'hotel.

BasePrice

tipo: float

Obbligatorio. Il prezzo più basso per la camera dell'hotel. Devi includere la valuta.

Esempio: 159 USD

URL

tipo: stringa

Link alla pagina della camera dell'hotel.

CheckinDate

tipo: data

Obbligatorio. Data di check-in per il valore di price. Sono supportati massimo 180 giorni dalla data di caricamento dell'elenco. Usa il formato ISO‑8601 (AAAA‑MM‑GG).

Nights

tipo: int

Obbligatorio. Numero di notti del soggiorno in hotel per il valore di price. Valore massimo: 14

Baserate

tipo: float

Obbligatorio. Prezzo in base a checkin_date e length_of_stay.

Esempio: 180

Tax

tipo: float

Obbligatorio. Valore delle imposte per il soggiorno.

OtherFees

tipo: float

Obbligatorio. Commissioni applicabili per il soggiorno.

SalePrice

tipo: float

Il prezzo scontato, se applicabile.

Esempio: 159

SalePriceTax

tipo: float

Valore delle imposte per il prezzo scontato.