要在 Facebook 推广酒店库存,必须与 Facebook 分享您的酒店信息。方法是:创建酒店目录,然后填写酒店信息。您可通过以下 2 种方式填写和更新目录:
您可以在电商管理工具中创建和管理酒店目录。
如需使用此 API 管理目录,请按照以下步骤操作:
酒店信息库是一份包含酒店库存的文件。此文件中的每一行或每一个项目均代表一家酒店。您可以使用一个或多个酒店信息库,前提是您的全部酒店库存都包含在这些信息库中。
CSV 示例 | TSV 示例(平展) | TSV 示例(JSON 格式)
"
"
将该字段括起来。 address
、neighborhood
或 image
)可使用 JSON 编码值表示,也可以通过由 JSON 路径语法标记的一组“平展”纯文本列表示(例如:address.city
、neighborhood[0]
、image[0].url
、image[0].tag[0]
和 image[0].tag[1]
)。您可以在同一个文件中交替使用这两种惯例做法。<listings>
XML 节点可包含一组 <listing>
节点,其中的每个节点均代表一个酒店。<?xml
声明标签开头。 信息库解析器会自动检测 UTF8
、UTF16
或 UTF32
文本编码,并在遇到陌生字节串时默认使用 LATIN1
。您可以使用任何语言添加字段值文本,不过字段名称必须使用英文严格按下方所示填写。
以下支持的字段可用于要添加到商品目录中的项目。
有关本地化目录,请参阅酒店广告支持的字段。
字段和类型 | 描述 |
---|---|
类型:字符串 | 必要。 字符数上限:100 目录中酒店的唯一标识符。这一编号将匹配 示例: |
类型:字符串 | 如要添加酒店客房信息,则为必要项。 输入酒店客房类型的唯一编号。字符数量限制:100 示例: |
类型:字符串 | 必要。 酒店最常用的名称。 示例: |
类型:字符串 | 必要。 字符数上限:5,000 酒店简介。 示例: |
类型:字符串 | 如要添加酒店客房信息,则为必要项。 酒店入住日期。自信息库上传之日起,您最多可以添加 180 天的适用期。采用 ISO-8601 标准 ( 示例: |
类型:字符串 | 如要添加酒店客房信息,则为必要项。 酒店入住天数。 示例: |
类型:字符串 | 如要添加酒店客房信息,则为必要项。 酒店客房每晚的基本价格。请务必为价格添加货币类型(例如,USD 代表美元)。将价格的格式设置为价格数值后加 ISO 货币代码,价格数值与货币单位之间应留有一个空格。 示例: |
类型:字符串 | 如要添加酒店客房信息,则为必要项。 酒店入住总价格,以 示例: |
类型:字符串 | 如要添加酒店客房信息,则为必要项。 客房价格适用的税率。将价格的格式设置为价格数值后加 ISO 货币代码,价格数值与货币单位之间应留有一个空格。 示例: |
类型:字符串 | 如要添加酒店客房信息,则为必要项。 客房价格适用的费用。将价格的格式设置为价格数值后加 ISO 货币代码,价格数值与货币单位之间应留有一个空格。 示例: |
类型:字符串 | 必要。 外部网站客房预订页面的链接。您也可以使用 示例: |
类型:对象 | 请参阅图片对象参数。 |
类型:对象 | 请参阅图片对象参数。 |
类型:字符串 | 必要。 连锁酒店的品牌名称。 示例: |
类型:对象 | 请参阅地址对象参数。 |
类型:字符串 | 必要。 社区数量限制:20 酒店所在的社区。如果不止一个社区,则应为各个社区添加额外的栏,并在各个栏名称中使用 JSON 路径语法标明社区编号。 示例: |
类型:浮点数 | 必要。 酒店所在地的纬度。 示例: |
类型:浮点数 | 必要。 酒店所在地的经度。 示例: |
类型:字符串 | 非必要。 酒店入住每晚的优惠价格,以 示例: |
类型:对象 | 请参阅客人评分对象参数。 |
类型:对象 | 请参阅客人评分对象参数。 |
类型:浮点数 | 请参阅客户评级对象参数。 |
类型:字符串 | 非必要。 入住此酒店可获得积分的忠诚度计划。 示例: |
类型:整数 | 非必要。 酒店盈利能力指标,其值介于 1 - 10 之间。 示例: |
类型:字符串 | 非必要。 酒店的主要电话号码。 示例: |
类型:对象 | 非必要。 使用应用链接可直接定向至移动应用中酒店详情页面的深度链接。您可以使用下列方法之一指定深度链接(按降序从高到低): 详细了解商品深度链接。 |
类型:整数 | 非必要。 酒店优先级指标,其值范围为 0 - 5(从最低优先级到最高优先级)。示例: |
类型:字符串 | 非必要。 房产类型。可以是内部描述所需的任何类型。示例: |
类型:整数 | 非必要。 此酒店清单中的客房或套房总数。 示例: |
类型:字符串 | 控制目录中的商品是在展示中还是已归档。仅展示中的商品可对您的广告受众以及店铺或其他任何渠道的用户显示。支持的值: 示例: 注意:部分合作伙伴平台(如 Shopify)将商品同步到您的目录时可能附带 staging 状态,其作用与 此字段之前被称为 |
类型:字符串 | 字符数上限:100 最多五个自定义字段,用于在创建商品系列时输入所需的任何附加信息,以作为商品筛选依据。例如,您可以使用一个自定义字段来表示构成某次夏季促销一部分的所有客房,然后将这些商品筛选到一个系列中。此字段支持输入任何文本值,包括数字。 示例: 补充信息库支持此字段。 |
类型:整数 | 此自定义字段包含任何数字相关附加信息,您最多可添加 5 个此类字段;在创建商品系列时,您可将这些字段的信息作为商品筛选依据。通过此字段,您可以在创建商品系列时按数字大小范围(大于和小于)进行筛选。例如,您可以使用此字段来表示一个酒店的开业年份,然后将特定年份范围内的商品筛选到一个系列中。 此字段支持 0 到 4294967295 之间的整数,不支持负数(例如:-2)、小数(例如:5.5)或逗号形式(例如:10,000)。 示例: |
字段名称和类型 | 描述 |
---|---|
类型:字符串 | 必要。 项目数量上限:20。 广告商品图片的网址链接。请遵循以下图片规格:
示例: 示例: |
类型:字符串 | 非必要。 附加到图片上的标签,用于说明图片内容。一张图像可以关联多个标签。 示例:
|
嵌套字段或多值字段(如 address
)可使用 JSON 编码值表示,也可以通过由 JSON 路径语法标记的一组“平展”纯文本列表示,如 address.region
。您可以在同一个文件中交替使用这两种惯例做法。
字段名称和类型 | 描述 |
---|---|
类型:对象 | 必要。 酒店的主要街道地址。 示例: |
类型:对象 | 非必要。 酒店的二级街道地址。 示例: |
类型:对象 | 非必要。 酒店的三级街道地址。 示例: |
类型:字符串 | 非必要。 在广告创意中为深度链接网址 示例: |
类型:字符串 | 必要。 酒店所在的城市。 示例: |
类型:字符串 | 必要。 酒店所在的州、县、省。 示例: |
类型:字符串 | 必要。 酒店所在的国家/地区。 示例: |
类型:字符串 | 有邮编系统的国家/地区必需提供。 酒店的邮编。 示例: |
字段名称和类型 | 描述 |
---|---|
类型:对象 | 非必要。 评论过您酒店的总人数。如果已指定,您还必须提供 示例: |
| 非必要。 为此酒店评分的用户总数。 示例: |
类型:字符串 | 非必要。 客户评分系统。 示例: |
类型:整数 | 必要。 酒店评分的最大值。必须大于或等于 0,同时小于或等于 100。 示例: |
您可以在目录中使用酒店 API 直接添加、修改和删除酒店。如需详细了解如何使用 API 管理酒店,请参阅酒店 API 参考文档。
以下部分仅适用于使用此 API 管理目录的情况。
酒店目录是一份包含酒店库存的文件。如要使用目录 API,请确保您拥有适当的市场营销 API 访问权限级别,并已通过在商务管理平台中创建首个目录接受服务条款。
如需为酒店广告创建酒店目录,请将 vertical
设置为 hotels
:
curl -X POST \ -F 'name="Test Hotel Catalog"' \ -F 'vertical="hotels"' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v10.0/BUSINESS_ID/owned_product_catalogs
目录创建完成后,您必须将酒店信息库上传到 Facebook。使用 API 为要上传的每个信息库创建一个信息库对象。我们支持定时上传和直接上传。
酒店系列属于目录的子集。您需要拥有酒店系列才能设置酒店广告。因此您需要至少创建一个酒店系列。
酒店系列由应用于酒店目录的筛选条件来定义。例如,您可以将 star_rating
高于 3 的所有酒店创建为一个酒店系列。注意:不使用任何筛选条件,您也可以创建酒店系列。在这种情况下,酒店系列将包含目录中所有的酒店。
如要将包含 brand
字段中提到的“示例品牌”的所有酒店创建为一个酒店系列:
curl -X POST \
-F 'name="Test Hotel Set"' \
-F 'filter={
"brand": {
"i_contains": "sample brand"
}
}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/<PRODUCT_CATALOG_ID>/product_sets
filter
参数由以下运算符与数据组成:
运算符 | 筛选的类型 |
---|---|
| 包含子字符串。运算符不分大小写。 |
| 不包含子字符串。运算符不分大小写。 |
| 包含子字符串。运算符不分大小写。 |
| 不包含子字符串。运算符不分大小写。 |
| 等于。运算符不分大小写。 |
| 不等于。运算符不分大小写。 |
| 小于。仅限数字型字段。 |
| 小于或等于。仅限数字型字段。 |
| 大于。仅限数字型字段。 |
| 大于或等于。仅限数字型字段。 |
数据 | 筛选的数据。 |
---|---|
| 目录中酒店的唯一标识符。 |
| 连锁酒店的品牌。 |
| 此酒店每晚的基础价格。价格以美分为单位(4999 表示 49.99 美元)。 |
| 此酒店每晚的优惠价。价格以美分为单位(4999 表示 49.99 美元)。 |
| 货币 |
| 酒店所在的城市。 |
| 酒店所在的国家/地区。 |
| 酒店最常用的名称。 |
| 酒店星级评定。有效值为 1 - 5,且必须为 0.5 的倍数。 |