酒店列表中包含合作伙伴希望在 Google 上展示的所有房源和房源信息。合作伙伴以 CSV 或 XML 文件提供来源数据,其中包含房源的实际属性(例如名称、地址、地理编码位置、电话号码和网站网址)。
准备工作
房源商家信息要求
酒店列表中的房源必须符合房源商家信息要求才能在 Google 上显示。常见的不符合条件的房源示例包括:公寓、长租房(超过 30 天)和民宿。如果想要向房源列表添加民宿,请参阅 VR 合作伙伴:入门指南。
您可以发送季节性营业或暂停营业的房源作为房源商家信息,但已永久停业的房源不符合条件。
数据质量
酒店列表数据必须与 Google 地图专有商家列表中的信息一致,才能成功发布。请始终提供尽可能准确的房源信息(包括电话号码以及经度和纬度坐标),并确保所提供的信息与 Google 商家资料和 Google 地图上显示的酒店信息一致。
如果您的房源缺失信息或信息不正确,则系统可能不会匹配您的房源,并且您将无法为其投放广告。“房源”页面中会列出匹配的酒店和存在数据问题的酒店。详细了解如何通过手动匹配的方式解决房源匹配问题
对于新入门和开始上手使用的合作伙伴:在新手入门的过程中,匹配率较低通常是正常现象。Google 建议您先上传所有酒店,然后选择一部分匹配酒店以开始为其发送价格。在验证价格 Feed 设置的同时,请继续提高您的酒店列表匹配率。虽然不是强制性要求,但 Google 建议您尽量实现超过 90% 的长期匹配率。
说明
1. 选择酒店列表的传送方式
您可以使用酒店列表上传功能以 CSV 或 XML 文件格式手动上传酒店列表,或者使用酒店列表拉取功能(以前称为“酒店列表 Feed”)在服务器上托管 XML 文件。酒店列表上传传送模式支持手动上传单个文件(通常包含不超过 5 万个房源)。对于此类文件,Google 建议您使用 CSV 语法与单一语言下列出的基本酒店内容进行集成。
对于更详细的酒店内容,您可以使用 XML 语法。如果您计划降低酒店信息更新频率,并以单一语言提供酒店内容信息,且拥有的房源少于 5 万个,Google 建议您使用酒店列表上传传送模式在 Hotel Center 中上传酒店列表。
注意:如果您预计会更频繁地更新酒店列表或需要提供多语言版本的内容,强烈建议您在自己的服务器上托管 XML 文件,以借助 Google 实现酒店列表拉取。Google 会频繁提取可用的最新文件,并自动将内容发布或更新到您的帐号上。这样做可以简化每次需要更新时上传和发布文件所需的手动步骤。
如果您想实现酒店列表拉取功能,请联系酒店广告支持团队。
2. 创建酒店列表
在选择传送模式以设置酒店列表后,请创建 CSV 或 XML 文件。
CSV 文件
CSV 文件格式的酒店列表中包含一个标注列名称的标题行,此外还针对 Feed 中每个酒店额外增加了一行。
第一行用于指定 Feed 中使用的列名称。例如:
id,name,addr1,addr2,addr3,city,province,postal_code,country,phone,latitude,longitude
并非所有字段均为必填字段。下表逐一说明了各个可用字段:
列 | 是否必填? | 说明 |
---|---|---|
id |
必填 | 酒店的唯一标识符。在您的网站中,此值必须是唯一的。 |
name |
必填 | 酒店的名称,例如:“Mabel's Gabels”。 |
address |
必填* |
酒店的完整地址(格式不限),例如:“66 Acacia Avenue, 6th Floor, Suite 610, Boston, Massachusetts, 02467”。 注意:如果您已提供 |
addr1 |
必填 | 酒店的主要街道地址,例如:“66 Acacia Avenue”。请注意,邮政信箱或其他仅限邮寄的地址不属于完整的实际地址。 |
addr2 |
可选 | 酒店的次要街道地址,例如:“6th Floor”。 |
addr3 |
可选 | 酒店街道地址的第三部分(可选)。例如:“Suite 610”。 |
city |
必填 | 酒店所在的城市,例如:“London”。 |
province |
必填 | 酒店所在的州、省级行政区或地区,例如:“Greater London”或“Massachusetts”。 |
postal_code |
必填 | 酒店的邮政编码,例如“90210”。 |
country |
必填 | 酒店所在的国家/地区。该值必须是由两个大写字母组成的 ISO 3116 标准国家/地区代码。例如美国为“US”,加拿大为“CA”。 |
phone |
必填* | 酒店使用的主要语音电话号码,例如“617-867-5309”。 |
latitude |
必填* | 与商家信息中所列位置对应的纬度,例如“37.423738”。 |
longitude |
必填* | 与商家信息中所列位置对应的经度,例如“-122.090101”。 |
category |
可选 | 酒店的类别,例如:“Hotel”“Bed and Breakfast”或“Motel”。 |
star_rating |
可选 | 酒店星级评分。该值必须是介于 1(含)到 5(含)之间的整数,也可以留空。例如,“1”表示一星级酒店,“5”表示五星级酒店,留空则表示星级未知。 |
hotel_brand |
可选 | 此酒店所属品牌,例如:“Marriott”或“Hilton”。 |
alternate_hotel_id |
可选 | 房源的备用标识符。在 Feed 信息和预订引擎可能具有不同的房源标识符的情况下,提供单独的 ID 会非常有用。 |
custom_0 |
可选 | 任何字符串类型的自定义属性。这些属性不会向用户显示。 |
custom_1 |
可选 | |
custom_2 |
可选 | |
custom_3 |
可选 | |
custom_4 |
可选 | |
*电话号码或经纬度坐标二者必填其一。最好两项都填写。 |
在 Feed 中指定数据时,请谨记以下准则:
- Google 建议您使用 Google 表格、Excel 或其他电子表格应用修改数据,并将文件导出为 CSV 文件。
- 这些列可以按您选择的任意顺序排列,但列名称必须与上述值保持一致。
- 所有列必须用英文逗号分隔。
- 如有某个值本身包含英文逗号,则必须用英文引号括住该值。例如:"Emerson, Lake, and Powell Hotel"。
- 如果没有任何房源商家信息包含某个特定列的值,您可以将该列留空(必填列除外)。
不限格式的地址
您可以使用 address
列来指定“自由格式”的地址,而不必分多列来输入地址的各个部分。不过,最好是采用结构化地址。
在指定不限格式的地址值时,请使用英文逗号分隔各个元素(例如:"76 Buckingham Palace Road, London, Greater London, SW1W 9TQ")。
address
列会取代 addr1
、addr2
、addr3
、city
、province
和 postal_code
列。即使您指定了自由格式的地址,仍须指定 country
列。
CSV 示例
以下是一个简单的酒店列表示例,该酒店同时包含电话号码和坐标值:id,name,addr1,city,province,postal_code,country,phone,latitude,longitude
123abc,Belgrave House,76 Buckingham Palace Road,London,Greater London,SW1W 9TQ,UK,123-456-7890,35.070374,-106.213648
以下是仅包含坐标值(没有电话号码)的酒店列表示例:
id,name,addr1,city,province,postal_code,country,latitude,longitude
123abc,Belgrave House,76 Buckingham Palace Road,London,Greater London,SW1W 9TQ,UK,35.070374,-106.213648
以下是采用自由格式地址的酒店列表示例:
id,name,address,country,phone,latitude,longitude
123abc,Belgrave House,"76 Buckingham Palace Road, London, Greater London, SW1W 9TQ",UK,123-456-7890,35.070374,-106.213648
XML 文件
如需详细了解如何使用 XML 创建酒店列表文件,请参阅酒店列表 XML 参考文件。
3. 上传或托管酒店列表
如需托管您自己的酒店列表并利用酒店列表拉取功能,请参阅在服务器上托管 XML Feed。或者,如需访问 Hotel Center 并使用酒店列表上传功能手动上传酒店列表,请按以下步骤操作:
- 在您的 Hotel Center 帐号中,从“导航”菜单中选择房源。
- 点击设置。
- 首次设置的用户必须先回答几个设置问题,包括要用于酒店列表的文件类型。
- 验证您的酒店列表内容或架构是否符合我们的格式标准,然后上传您的 CSV 或 XML 文件。(注意:文件上传最长可能需要一小时才能完成)。
- 如果文件无效,您会收到一条错误消息。进行必要的更改,然后重新上传。
- 您的文件在 Hotel Center 中成功上传后,您会收到一封确认电子邮件。确认上传后,返回“Property Settings”(房源设置)页面以发布酒店列表。您可以在“帐号设置”页面上选择“提醒”类别,以调整通知设置。
4. 发布您的酒店列表(仅上传酒店列表)
如果您上传了至少一个酒店列表,则可选择要使用哪一个列表作为实际发布的版本。
如需选择要实际发布的酒店列表,请执行以下操作:
- 在您的 Hotel Center 帐号中,从“导航”菜单中选择房源。
- 点击设置。
- 在“发布”标签页上,点击发布,以实际发布该列表。发布过程可能需要一个工作日才能完成。
发布酒店列表后,请查看 Hotel Center 中的“房源”页面,看看哪些酒店(如有)不匹配。了解如何通过手动匹配的方式解决房源匹配问题
通过将鼠标指针悬停在文件名上并点击“Republish this file”(重新发布此文件),即可恢复之前上传的文件。
5. 更新现有酒店列表(仅上传酒店列表)
酒店列表成功发布后,您可以通过上传修改后的列表进行更新,以覆盖之前的版本。
如需更新酒店列表,请执行以下操作:
- 下载要更新的酒店列表。最近上传的酒店列表将列在“Previously Uploaded”(之前上传)列下。
- 在酒店列表中进行所需的更改。
- 在“Property Settings”(房源设置)页面上重新上传酒店列表。
- 按照上述上传或托管酒店列表部分的说明上传新文件。