Anuncios de hoteles: precios específicos por fecha

En una lista de hoteles estática, debes proporcionar un precio individual para cada hotel. No puedes usar precios distintos según la fecha de entrada, la duración de la estancia o el tipo de habitación. Si deseas que los precios que se muestran en los anuncios según estas variables sean más precisos, puedes usar precios dinámicos (específicos de fechas) y, de esta manera, proporcionar precios para diferentes fechas, tipos de habitación y duraciones de estancia. Una vez que los hayas establecido, puedes utilizar etiquetas de plantillas de hoteles para usar estos precios en tus anuncios.

Usa los datos de precios y tipos de habitaciones subidos por lotes para compartir detalles de los precios en Facebook.

Consulta en los parámetros de habitaciones y precios las explicaciones de todos los parámetros.

Datos de precios y tipos de habitaciones subidos por lotes

La subida por lotes consta de dos partes:

  1. Subir los tipos de habitaciones
  2. Subir los precios

Si usas la subida por lotes, limítala a 50 MB por archivo, es decir, aproximadamente 50.000 artículos en un archivo. Si optas por las variables de precios, te recomendamos realizar subidas más frecuentes y pequeñas.


Subir los tipos de habitaciones

Sube uno o más archivos con tipos de habitaciones mediante la API de lotes de habitaciones de hotel.

Nota: Si no tienes diferentes tipos de habitaciones, puedes omitir este paso.

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 de archivo de tipos de habitaciones

Puedes proporcionar los tipos de habitaciones en formato XML; consulta un ejemplo.

Debes identificar cada hotel con el valor de <property> en el nodo XML <PropertyDataSet> y proporcionar el tipo de habitación mediante <RoomData>. El archivo debe comenzar con una etiqueta de declaración <?xml.

Para obtener más detalles sobre cómo actualizar y eliminar tipos de habitaciones mediante la API de lotes, consulta la API de lotes de habitaciones de hotel.


Subir los precios

Sube uno o más archivos con información detallada de precios mediante la API de lotes de variables de precios. Puedes subir información detallada de precios con o sin tipos de habitaciones.

Nota: Si solo tienes un número muy reducido de habitaciones, también puedes usar la API de habitaciones de hotel para crear tipos de habitaciones y configurar los precios.

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 de los archivos de precios

Antes de subir los tipos de habitaciones, asegúrate de que los hoteles correspondientes ya existan en el catálogo. Puedes proporcionar las variables de precios en el siguiente formato:

Formato de archivo y muestraDescripción

XML con tipos de habitaciones | XML de ejemplo

Asegúrate de que los tipos de habitaciones para los que quieres proporcionar los precios ya existan.


Especifica el precio (<Baserate>) en cada tipo de habitación (<RoomBundle>) según la combinación de la fecha de entrada (<Checkin>) y la duración de la estancia (<Nights>).


El archivo debe empezar con la etiqueta de declaración <?xml.

XML sin tipos de habitaciones | XML de ejemplo

Especifica el precio (<Baserate>) para las combinaciones de identificador de hotel (<Property>), fecha de entrada (<Checkin>) y duración de la estancia (<Nights>).


El archivo debe empezar con la etiqueta de declaración <?xml.

Para ver más detalles sobre la actualización y eliminación de variables de precios por lotes, consulta la referencia de lotes de variables de precios.

Parámetros de habitaciones y precios

Nombre y tipo de campoDescripción

Property

Tipo: cadena

Obligatorio. Identificador único del hotel que proporciona el anunciante como hotel_id en la lista de hoteles.

RoomID

Tipo: cadena

Obligatorio. Identificador único del tipo de hotel que proporciona el anunciante.

Name

Tipo: cadena

Obligatorio. Nombre del tipo de habitación del hotel.

Description

Tipo: cadena

Obligatorio. Descripción del tipo de habitación del hotel.

BasePrice

Tipo: flotante

Obligatorio. Precio más bajo de la habitación del hotel. Incluye la divisa.

Ejemplo: 159 USD

URL

Tipo: cadena

Enlace a la página de la habitación del hotel.

CheckinDate

Tipo: fecha

Obligatorio. Fecha de entrada para price. Admitimos hasta 180 días desde la fecha en que se subió la lista. Usa ISO‑8601 (AAAA‑MM‑DD).

Nights

Tipo: entero

Obligatorio. Número de noches en el hotel por price. Valor máximo: 14

Baserate

Tipo: flotante

Obligatorio. Precio según checkin_date y length_of_stay.

Ejemplo: 180

Tax

Tipo: flotante

Obligatorio. Valor de los impuestos correspondientes a la estancia.

OtherFees

Tipo: flotante

Obligatorio. Tarifa aplicable correspondiente a la estancia.

SalePrice

Tipo: flotante

Precio con descuento, si corresponde.

Ejemplo: 159

SalePriceTax

Tipo: flotante

Valor de los impuestos del precio con descuento.