Anuncios sobre hoteles: precios para fechas concretas

En una lista de hoteles estática, se proporciona un solo precio para cada hotel. No puedes proporcionar un precio diferente según la fecha de entrada, la duración de la estancia o el tipo de habitación. Para mostrar precios más exactos en tus anuncios basados en estas variables, puedes utilizar precios dinámicos (específicos de la fecha) a fin de ofrecer precios de fechas, tipos de habitaciones y duraciones de estancia diferentes. Después de proporcionarlos, puedes utilizar etiquetas de plantilla de hotel para utilizar estos precios en tus anuncios.

Utiliza la subida por lotes de datos sobre tipos de habitación y precios para compartir la información sobre precios con Facebook.

Consulta los parámetros de habitaciones y precios para obtener una explicación de todos los parámetros.

Subida por lotes de datos sobre tipos de habitación y precios

La subida por lotes consta de dos partes:

  1. Subida de tipos de habitación
  2. Subida de precios

Si utilizas la subida por lotes, limita las subidas a 50 MB por archivo (aproximadamente, 50 000 elementos por archivo). Para las variables de precios, se recomienda realizar actualizaciones más pequeñas y frecuentes.


Subida de tipos de habitación

Sube uno o más archivos con los tipos de habitación mediante la API por lotes de habitaciones de hotel.

Nota: Si no tienes distintos tipos de habitación, 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 con tipos de habitación

Puedes proporcionar los tipos de habitación en formato XML. Consulta este ejemplo.

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

Para obtener más información sobre la actualización y eliminación de tipos de habitación mediante la API por lotes, consulta la referencia sobre los lotes de habitaciones de hotel.


Subida de precios

Sube uno o más archivos con detalles de precios mediante la API por lotes de las variables de precios. Puedes subir los detalles de los precios con o sin los tipos de habitación.

Nota: Si tienes pocas habitaciones, también puedes utilizar la API para habitaciones de hotel para crear tipos de habitación 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 habitación, comprueba que el catálogo incluye los hoteles correspondientes a estas habitaciones. Puedes proporcionar variables de precios en este formato:

Formato de archivos y ejemploDescripción

XML con tipos de habitación | Ejemplo de XML

Comprueba que los tipos de habitación para los que quieres proporcionar precios existen.


Especifica los precios (<Baserate>) de cada tipo de habitación (<RoomBundle>) según la combinación de 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 habitación | Ejemplo de XML

Especifica los precios (<Baserate>) de cada combinación de identificador del 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 obtener más información sobre cómo actualizar y eliminar las variables de precios por lotes, consulta la referencia de variables de precios por lotes.

Parámetros de las habitaciones y los precios

Nombre y tipo del campoDescripción

Property

Tipo: cadena

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

RoomID

Tipo: cadena

Obligatorio. Identificador único del tipo de habitación proporcionado por 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ínimo de la habitación del hotel. Debes incluir la divisa.

Ejemplo: 16000 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 a partir de la fecha de subida de la lista. Utiliza el formato ISO-8601 (AAAA-MM-DD).

Nights

Tipo: entero

Obligatorio. Cantidad de noches de alojamiento en el hotel por el precio indicado en price. Valor máx.: 14

Baserate

Tipo: flotante

Obligatorio. Precio basado en checkin_date y length_of_stay.

Ejemplo: 180

Tax

Tipo: flotante

Obligatorio. Valor de los impuestos aplicables a la estancia.

OtherFees

Tipo: flotante

Obligatorio. Tasa aplicable a la estancia.

SalePrice

Tipo: flotante

Precio con descuento, si procede.

Ejemplo: 159

SalePriceTax

Tipo: flotante

Valor de los impuestos del precio con descuento.