酒店廣告 - 特定日期價格

靜態的酒店摘要中,您可以為每間酒店提供單一價格。您無法根據入住日期、住宿天數或房型提供不同的價格。如要根據這些變數在廣告中展示更準確的價格,您可以使用靈活的(特定日期)定價,按照不同日期、房型及住宿天數來提供相應價格。提供價格後,您可以使用酒店範本標籤,在廣告中使用這些價格。

使用批量上載房型與定價數據,與 Facebook 分享定價詳情。

參閱客房與價格參數,了解所有參數的相關說明。

批量上載房型與定價數據

批量上載共有兩個部分:

  1. 上載房型
  2. 上載定價

如果您使用批量上載,請將每個上載檔案的大小限制在 50 MB,每個檔案約可包含 50,000 個項目。我們建議您多為定價參數執行小型更新。


上載房型

使用酒店客房批量 API 上載一個或多個包含房型的檔案。

請注意:若您並無提供不同房型,可略過此步驟。

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

房型檔案格式

您可以提供 XML 格式的房型檔案;請參閱範例

請在 <PropertyDataSet> XML 節點以 <property> 標明每間酒店,並以 <RoomData> 提供房型。您的檔案必須以 <?xml 宣告標籤開首。

如要進一步了解如何使用批量 API 更新與刪除房型,請參閱酒店客房,批量參考資料


上載定價資料

使用定價變數批量 API 上載一個或多個包含定價詳情的檔案。您上載的定價詳情可以包含或不包含房型。

請注意:如果您提供的房間數量不多,則也可以使用酒店客房 API 來建立房型及設定定價。

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

定價檔案格式

上載房型前,請確保這些客房所在的酒店已列於目錄中。您可以透過下列格式提供定價變數:

檔案格式及範例描述

包含房型的 XML | XML 範例

請確保您要提供定價的房型已經存在。


根據入住日期 (<Checkin>) 與住宿天數 (<Nights>) 的組合,在每個房型 (<RoomBundle>) 當中指定定價 (<Baserate>)。


檔案必須以 <?xml 宣告標籤開首。

不包含房型的 XML | XML 範例

根據酒店編號 (<Property>)、入住日期 (<Checkin>) 與住宿天數 (<Nights>) 的組合,指定每個組合的定價 (<Baserate>)。


檔案必須以 <?xml 宣告標籤開首。

如要進一步了解如何批量更新與刪除定價變數,請參閱定價變數批量參考資料

客房與定價參數

欄位名稱與類型描述

Property

類型:字串

此為必要項目。酒店的不重複識別資料,由廣告客戶提供,並會以 hotel_id 形式顯示於酒店摘要中。

RoomID

類型:字串

此為必要項目。房型的不重複識別資料,由廣告客戶提供。

Name

類型:字串

此為必要項目。酒店房型名稱。

Description

類型:字串

此為必要項目。酒店房型說明。

BasePrice

類型:浮點數

此為必要項目。酒店客房的最低價格。請加入貨幣。

範例:159 USD

URL

類型:字串

酒店客房頁面的連結。

CheckinDate

類型:日期

此為必要項目。與 price 對應的入住日期。支援輸入摘要上載日期之後的 180 天。請使用 ISO‑8601 格式 (YYYY‑MM‑DD)。

Nights

類型:整數

此為必要項目。與 price 對應的酒店住宿天數。最大值:14

Baserate

類型:浮點數

此為必要項目。根據 checkin_datelength_of_stay 所定的價格。

範例:180

Tax

類型:浮點數

此為必要項目。住宿的稅額。

OtherFees

類型:浮點數

此為必要項目。住宿的適用費用。

SalePrice

類型:浮點數

折扣價格(如適用)。

範例:159

SalePriceTax

類型:浮點數

折扣價格的稅額。