Quảng cáo khách sạn - Định giá theo ngày

Trong nguồn cấp dữ liệu tĩnh cho khách sạn, bạn cung cấp một mức gia cho mỗi khách sạn. Bạn không thể cung cấp mức giá khác nhau theo ngày nhận phòng, thời gian lưu trú hoặc loại phòng. Nếu muốn hiển thị mức giá chính xác hơn trong quảng cáo theo những biến này, bạn có thể định giá động (theo ngày) để cung cấp mức giá cho những ngày, loại phòng và thời gian lưu trú khác nhau. Sau khi cung cấp, bạn có thể dùng thẻ mẫu dành cho khách sạn để sử dụng các mức giá này trong quảng cáo.

Sử dụng tính năng tải lên hàng loạt dữ liệu loại phòng và mức giá để chia sẻ chi tiết về giá với Facebook.

Tham khảo phần thông số phòng và mức giá để xem giải thích về tất cả thông số.

Tải lên hàng loạt dữ liệu loại phòng và mức giá

Tính năng tải lên hàng loạt bao gồm 2 phần:

  1. Tải loại phòng lên
  2. Tải mức giá lên

Nếu bạn sử dụng tính năng tải lên hàng loạt, hãy giới hạn dung lượng tải lên là 50 MB mỗi file, khoảng 50.000 mục mỗi file. Bạn nên cập nhật biến định giá thường xuyên hơn với dung lượng nhỏ hơn.


Tải loại phòng lên

Tải lên một hoặc nhiều file có loại phòng bằng API Loạt phòng khách sạn.

Lưu ý: Bạn có thể bỏ qua bước này nếu không có các loại phòng khác nhau.

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

Định dạng file loại phòng

Bạn có thể cung cấp loại phòng ở định dạng XML; hãy xem mẫu.

Bạn nên xác định từng khách sạn bằng <property> trong nút XML <PropertyDataSet> và cung cấp loại phòng bằng <RoomData>. File phải bắt đầu bằng thẻ khai báo <?xml.

Để biết thêm chi tiết về cách cập nhật và xóa loại phòng qua API Loạt, hãy xem Tài liệu tham khảo về API Loạt phòng khách sạn.


Tải mức giá lên

Tải lên một hoặc nhiều file có chi tiết về giá bằng API Loạt biến định giá. Bạn có thể tải chi tiết về giá lên dù có loại phòng hay không.

Lưu ý: Nếu chỉ có rất ít phòng, bạn cũng có thể sử dụng API Phòng khách sạn để tạo loại phòng và thiết lập giá.

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

Định dạng file mức giá

Trước khi tải loại phòng lên, hãy đảm bảo khách sạn có những phòng này đã nằm trong danh mục. Bạn có thể cung cấp biến định giá theo định dạng sau:

Định dạng file và mẫuMô tả

XML có loại phòng | Mẫu XML

Đảm bảo các loại phòng mà bạn muốn đưa ra mức giá đã tồn tại.


Nêu rõ mức giá (<Baserate>) trong từng loại phòng (<RoomBundle>) theo ngày nhận phòng (<Checkin>) và thời gian lưu trú (<Nights>).


File phải bắt đầu bằng thẻ khai báo <?xml.

XML không có loại phòng | Mẫu XML

Nêu rõ mức giá (<Baserate>) cho từng ID khách sạn (<Property>), ngày nhận phòng (<Checkin>) và thời gian lưu trú (<Nights>).


File phải bắt đầu bằng thẻ khai báo <?xml.

Để biết thêm chi tiết về cách cập nhật và xóa biến định giá qua API Loạt, hãy xem Tài liệu tham khảo về API Loạt biến định giá.

Thông số phòng và mức giá

Tên và loại trườngMô tả

Property

loại: chuỗi

Bắt buộc. Thông tin nhận dạng duy nhất của khách sạn do nhà quảng cáo cung cấp làm hotel_id trong nguồn cấp dữ liệu khách sạn.

RoomID

loại: chuỗi

Bắt buộc. Thông tin nhận dạng duy nhất của loại phòng do nhà quảng cáo cung cấp.

Name

loại: chuỗi

Bắt buộc. Tên loại phòng khách sạn.

Description

loại: chuỗi

Bắt buộc. Mô tả loại phòng khách sạn.

BasePrice

loại: nổi

Bắt buộc. Giá thấp nhất của phòng khách sạn. Bạn nên thêm đơn vị tiền tệ.

Ví dụ: 159 USD

URL

loại: chuỗi

Liên kết đến trang phòng khách sạn.

CheckinDate

loại: ngày

Bắt buộc. Ngày nhận phòng đối với price. Chúng tôi hỗ trợ lên đến 180 ngày từ ngày tải nguồn cấp dữ liệu lên. Sử dụng định dạng ngày theo tiêu chuẩn ISO‑8601 (YYYY‑MM‑DD).

Nights

loại: số nguyên

Bắt buộc. Số đêm lưu trú tại khách sạn đối với price. Giá trị tối đa: 14

Baserate

loại: nổi

Bắt buộc. Giá theo checkin_datelength_of_stay.

Ví dụ: 180

Tax

loại: nổi

Bắt buộc. Giá trị thuế đối với thời gian lưu trú.

OtherFees

loại: nổi

Bắt buộc. Phí áp dụng đối với thời gian lưu trú.

SalePrice

loại: nổi

Giá chiết khấu nếu có.

Ví dụ: 159

SalePriceTax

loại: nổi

Giá trị thuế đối với giá chiết khấu.