酒店广告 - 特定日期定价

使用静态酒店信息库时,您只能为每家酒店提供一种价格。无法根据入住日期、入住时长或客房类型提供不同的价格。如需按这些变量在广告中展示更准确的价格,可以使用动态定价(按日期),根据不同的日期、客房类型和入住时长提供价格。在给出价格后,您可以使用酒店模板标签,在广告中展示这些价格。

使用批量上传客房类型和定价数据,与 Facebook 分享定价详情。

请参阅客房和定价参数,获取所有参数的说明。

批量上传客房类型和定价数据

批量上传包含两部分:

  1. 上传客房类型
  2. 上传定价

如果使用批量上传功能,每个文件最大不能超过 50MB,最多能包含约 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

类型:浮点数

折扣价格的适用税额。