飯店廣告 - 特定日期定價

靜態飯店摘要中,您需提供每家飯店的單價,不能根據登記入住日期、住宿天數或房型提供不同的定價。如要在廣告中根據這些變數顯示較準確的價格,可以使用動態(特定日期)定價提供不同日期、不同房型以及不同住宿天數的價格。提供價格之後,您就可以使用飯店範本標籤,在廣告中使用這些價格。

使用批次上傳房型和定價資料與 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(西元年‑月‑日)。

Nights

類型:整數

必要項目。與 price 相對應的飯店入住天數。數值上限:14

Baserate

類型:浮點

必要項目。以checkin_datelength_of_stay為準的價格。

範例:180

Tax

類型:浮點

必要項目。住宿稅額。

OtherFees

類型:浮點

必要項目。住宿相關費用。

SalePrice

類型:浮點

適用的折扣價。

範例:159

SalePriceTax

類型:浮點

折扣價的稅額。