Publicités pour les hôtels – Tarifs en fonction de la date

Dans un flux statique d’hôtels, vous indiquez un prix unique pour chaque hôtel. Vous ne pouvez pas indiquer de tarifs différents en fonction de la date d’arrivée, de la durée du séjour ou du type de chambre. Si vous souhaitez afficher dans vos publicités des prix plus précis basés sur ces variables, vous pouvez utiliser des tarifs dynamiques (spécifiques à la date) pour indiquer des prix correspondant à différentes dates, différents types de chambre et différentes durées de séjour. Une fois ces éléments fournis, vous pouvez utiliser des balises de modèle d’hôtel pour afficher ces prix dans vos publicités.

L’importation groupée de données concernant les types de chambre et les tarifs vous permet de partager les détails de vos tarifs avec Facebook.

Consultez les paramètres relatifs aux chambres et aux tarifs pour obtenir une explication de l’ensemble des paramètres.

Importation groupée de données concernant les types de chambre et les tarifs

L’importation groupée est composée de deux parties :

  1. Importation des types de chambre
  2. Importation des tarifs

Si vous utilisez l’importation groupée, limitez les importations à 50 Mo par fichier, approximativement 50 000 éléments par fichier. Nous recommandons des mises à jour plus réduites et plus fréquentes pour les variables de tarifs.


Importation des types de chambre

Importez un ou plusieurs fichiers contenant des types de chambre à l’aide de l’API Hotel Rooms Batch.

Remarque : Si vous ne proposez qu’un seul type de chambre, vous pouvez passer cette étape.

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

Format du fichier des types de chambre

Vous pouvez fournir les types de chambre au format XML (voir cet exemple).

Vous devez identifier chaque hôtel par <property> dans le nœud XML <PropertyDataSet> et fournir un type de chambre par <RoomData>. Votre fichier doit commencer par une balise déclarative <?xml.

Pour en savoir plus sur l’importation et la suppression de types de chambre par le biais de l’API Batch, consultez Chambres d’hôtel, référence sur Batch.


Importation des tarifs

Importez un ou plusieurs fichiers contenant les détails des tarifs à l’aide de l’API Pricing Variable Batch. Vous pouvez importer les détails des tarifs avec ou sans les types de chambre.

Remarque : Si vous possédez un nombre très réduit de chambres, vous pouvez également utiliser l’API Hotel Room pour créer des types de chambre et configurer les tarifs.

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

Format du fichier de tarifs

Avant d’importer les types de chambre, vérifiez que les hôtels correspondant à ces chambres existent déjà dans le catalogue. Vous pouvez indiquer des variables de tarifs dans ce format :

Format et exemple de fichierDescription

XML avec types de chambre | Exemple de fichier XML

Vérifiez que les types de chambre pour lesquels vous voulez fournir des tarifs existent déjà.


Précisez les tarifs (<Baserate>) dans chaque type de chambre (<RoomBundle>) en fonction de l’association de la date d’arrivée (<Checkin>) et de la durée du séjour (<Nights>).


Le fichier doit commencer par la balise déclarative <?xml.

XML sans types de chambre | Exemple de fichier XML

Précisez les tarifs (<Baserate>) pour chaque combinaison composée d’un identifiant d’hôtel (<Property>), d’une date d’arrivée (<Checkin>) et d’une durée de séjour (<Nights>).


Le fichier doit commencer par la balise déclarative <?xml.

Pour en savoir plus sur la façon de mettre à jour et supprimer des variables de tarifs par lot, consultez la référence sur l’API Pricing Variable Batch.

Paramètres des chambres et des tarifs

Nom du champ et typeDescription

Property

type : chaîne

Obligatoire. Identifiant unique de l’hôtel fourni par l’annonceur en tant que hotel_id dans le flux d’un hôtel.

RoomID

type : chaîne

Obligatoire. Identifiant unique du type de chambre fourni par l’annonceur.

Name

type : chaîne

Obligatoire. Nom du type de chambre d’hôtel.

Description

type : chaîne

Obligatoire. Description du type de chambre d’hôtel.

BasePrice

type : virgule flottante

Obligatoire. Tarif le plus bas de la chambre d’hôtel. Vous devez ajouter la devise.

Exemple : 159 USD

URL

type : chaîne

Lien vers la page de la chambre d’hôtel.

CheckinDate

type : date

Obligatoire. Date d’arrivée pour ce price. Vous pouvez aller jusqu’à 180 jours à compter de la date d’importation du flux. Utilisez le format ISO 8601 (AAAA‑MM‑JJ).

Nights

type : nombre entier

Obligatoire. Nombre de nuitées dans l’hôtel pour le price. Valeur maximale : 14.

Baserate

type : virgule flottante

Obligatoire. Prix basé sur checkin_date et length_of_stay.

Exemple : 180

Tax

type : virgule flottante

Obligatoire. Valeur des taxes pour le séjour.

OtherFees

type : virgule flottante

Obligatoire. Frais applicables au séjour.

SalePrice

type : virgule flottante

Prix avec remise, le cas échéant.

Exemple : 159

SalePriceTax

type : virgule flottante

Valeur des taxes pour le prix réduit.