创建 XML 属性源文件

项目
11/13/2024

注意

从 4 月 9 日起，您将无法再完全访问酒店中心。我们期待将你介绍到 Property Center，它将提供令人兴奋的自助服务功能。感谢耐心等待，因为我们使用新功能更新帮助内容。同时，可以阅读有关这些即将进行的更改以及如何使迁移过程更流畅的信息。

若要提供酒店列表Microsoft，请创建一个 XML 文档，其中包含要播发的每个酒店的列表。列表描述了酒店的名称、地址、电话号码、地理坐标、设施等。

文档必须使用 UTF-8 编码，并且必须符合 Hotel XSD。

有关使用 CSV 或 TSV 文件格式创建源文件的信息，请参阅创建 CSV 属性源文件。

注意

Microsoft不支持所有 XSD 元素。 Microsoft忽略文档中它不支持的任何元素或属性。属性源引用仅包括Microsoft支持的那些元素和属性。

注意

文档必须按照 Hotel XSD (中定义的顺序指定元素，如参考) 所示。

正确获取数据

由于Microsoft尝试将属性源中的属性与必应地图的企业进行匹配，因此您提供的有关酒店的数据必须准确且完整。

如果某家酒店的信息缺失或不正确，Microsoft可能无法与之匹配。如果Microsoft无法与酒店匹配，Microsoft不会对其进行播发。你将能够在酒店中心查看匹配报表，该报表指示哪些酒店Microsoft匹配或不匹配。如果Microsoft与酒店不匹配，则报告将包含消息“ 无法将此酒店与必应中的属性匹配”。若要帮助提高匹配率，请确保它们可用于必应营业场所。

源中的顶级元素

属性源包含单个顶级列表元素。元素 listings 包含两个必需的子元素： language 和 listing。

<?xml version="1.0" encoding="UTF-8"?>
<listings  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <language>en</language>
  <listing>
    . . .
  </listing>
  ...
</listings>

注意

我们目前支持本地语言的源数据。

元素 language 指定写入源中的数据时使用的语言。若要指定语言，请使用双字母 ISO 639 语言代码。例如，使用 en 表示英语。

列表元素包含有关酒店的信息，例如酒店的名称、地址和电话号码。有关定义列表的信息，请参阅定义酒店一览。

定义酒店列表

元素 listing 定义酒店。必须为播发的每个酒店指定一个 listing 元素。以下示例显示了必须为列表指定的最小元素。例外情况是可以指定地理坐标或电话号码。虽然可以指定坐标或电话号码，但应同时指定这两者，以确保在必应地图中匹配属性的可能性更高。

  <listing>
    <id>abc123</id>
    <name>Great Ambers Getaway</name>
    <address>
      <component name="addr1">1234 Porter Road</component>
      <component name="city">Goldendale</component>
      <component name="province">WA</component>
      <component name="postal_code">98234</component>
    </address>
    <country>US</country>
    <latitude>47.694351</latitude>
    <longitude>-122.451782</longitude>
    <phone type="main">123-456-7890</phone>
  </listing>

元素中的 id ID 是用户定义的，在源中必须是唯一的。

元素中的 address 地址是酒店的街道地址。该地址必须是街道地址，而不是邮政信箱。可以使用上述示例中所示的元素或使用以下示例中显示的自由格式字符串来指定酒店地址 component 。首选项是使用 component 元素。

<address>1234 Porter Road, Goldendale, WA, 98234</address>

latitude和 longitude 元素指定酒店的地理坐标。使用地理编码 API（如位置 API ）从街道地址生成坐标。

该列表必须至少指定酒店的main电话号码。 main号码应是前台的电话号码，而不是中央预订电话号码。提供的联系人电话号码越多越好。以下示例显示了其他手机选项。

    <phone type="main">123-456-7890</phone>
    <phone type="tollfree">800-456-7890</phone>
    <phone type="fax">123-456-7890</phone>
    <phone type="tdd">123-456-7890</phone>
    <phone type="mobile">123-456-7890</phone>

有关指定电话号码的详细信息，请参阅 phone 元素。

指定可选的酒店列表字段

以下示例显示了可以在列表中包括的可选元素。虽然是可选的，但应包含尽可能多的信息，以支持当前和未来的使用方案。

  <listing>
    . . .
    <category>hotel | inn</category>
    <content>
      <text type="description">
        <body>This element contains the hotel's description.</body>
      </text>
      <review type="user">
        <body>This element contains a review of the hotel.</body>
        <date month="2" day="24" year="2018" />
        <link>https://contoso.com/reviews/hotels?id=sd87s90</link>
        <rating>8.5</rating>
      </review>
      <attributes>
        <website>https://contoso.com</website>
        <attr name="air_conditioned">Yes</attr>
        <attr name="has_airport_shuttle">Yes</attr>
        <attr name="parking_type">No payment required</attr>
      </attributes>
      <image type="photo" url="https://contoso.com/photos?id=345k43llj" width=800 height=600>
        <date month="3" day="3" year="2018" />
        <link>https://contoso.com/...</link>
        <title>Hotel entrance</title>
      </image>
      <neighborhoods>
        <neighborhood>Sodo District</neighborhood>
      </neighborhoods>
      <brand>Contoso</brand>
    </content>
  </listing>

元素 category 预期格式为 vacation_rental 或 hotel ，后跟管道字符和自定义值。例如， vacation_rental |“自定义值” 或 酒店 |“自定义值”

有关自定义值的列表，请参阅住宿属性类别。

元素 text 包含酒店的说明。必须指定 body 包含实际说明的元素。根据说明的长度，它可能会在显示时被截断。如果包括 link 和 title 元素，链接 URL 指向联机说明。

元素 review 包含用户评论或编辑评审。编辑评审是由评审机构（如旅行博客作者）进行的专业评审。你可以包括任意数量的评论，但根据发送的评论数，它们可能不会全部显示。必须指定 body 包含审阅的元素。根据评论的长度，它可能会在显示时被截断。如果包含 link 元素，它将指向在线评论的完整列表。

元素 attributes 包含酒店提供的一系列设施，如空调、游泳池以及免费的早餐。有关可能设施的列表，请参阅属性。如果未指定就医，则假定酒店不提供。

元素 image 包含酒店的图像。可以包含任意数量的图像，但根据发送的图像数量，它们可能不会全部显示。建议的纵横比为 4：3，最小宽度为 720 像素。图像必须是原始照片，不能是屏幕截图。请注意， link 该 URL 必须由 AdIdxBot 爬网程序访问。如果站点包含 robots.txt 文件，则它必须包括以下任一文件：

用户代理：AdIdxBot
允许：/

元素 neighborhood 标识酒店所在的邻域。如果酒店位于多个街区的中心位置，则可以指定多个邻里。

元素 brand 标识酒店品牌。例如，Fabrikam Residences by Contoso，其中 Contoso 是品牌。

如果酒店的内容发生更改，会发生什么情况？

如果在源运行 (（例如，其名称、地址、电话等 ) ）之间更改了酒店的任何属性值，Microsoft广告可能会将其视为新的酒店属性并为其创建新列表。如果Microsoft创建新列表，则旧酒店以前的性能历史记录将保留长达 36 个月。请注意，旧酒店的出价和乘数不会转移到新的酒店实体。

如果删除酒店并将其添加回与之前相同的属性值的后续源中，Microsoft将其视为新列表。此外，性能报告将它显示为两个单独的列表。

常规规则

使用 Hotel XSD 验证属性源文件，然后再将其发送到Microsoft。
属性源文档必须使用 UTF-8 编码。
源必须包含所有酒店的列表- 源过程不支持部分更新。
Microsoft忽略它不支持的任何元素或属性。
元素必须按 Hotel XSD 中指定的顺序排列。
如果数据包含特殊字符（如撇号或引号），请转义它们或使用 CDATA 节。如果对它们进行转义，则可以使用实体代码或字符代码。例如，你可以像保罗&apos 一样逃避保罗的;或 Paul's.
请勿包含不包含数据的元素。例如，如果未提供酒店的地理坐标，请不要包含空 <的纬度> 和 <经度> 元素。
请勿在 XML 元素中使用 HTML。

后续步骤

创建源文件后，使用 Hotel XSD 对其进行验证。

请客户经理导入源文件。

此外，请务必导入登陆页数据。有关创建登陆页源文件的信息，请参阅登陆页源。

Microsoft成功导入数据并能够将你的酒店与必应地图中的酒店相匹配后，你可以开始发送酒店定价和可用性数据。有关信息，请参阅价格源。

通过