着陆页文件语法

着陆页文件的根元素为 <PointsOfSale>，它包含一个子元素 <PointOfSale>，且没有属性。着陆页文件可以有多个 <PointOfSale> 子元素。

您在着陆页文件中定义的每个着陆页都包含在 <PointOfSale> 元素中。此元素接受单个属性 id，用于定义着陆页的唯一标识符。您可以使用 id 的值过滤出匹配酒店的符合条件的着陆页。您可以使用 <Transaction> 中的 <AllowablePointsOfSale> 元素执行此操作。

语法

<?xml version="1.0" encoding="UTF-8"?>
<PointsOfSale>
  <PointOfSale id="landing_page_id">
    <DisplayNames display_text="landing_page_display_name" display_language="language_code"/>
    <Match status="[yes|never]"
      country="country_code"
      language="language_code"
      brand="booking_engine or brand"
      currency="currency_code"
      sitetype="[localuniversal|mapresults]"
      device="[desktop|mobile|tablet]"/>
    <!-- The dynamic landing page URL -->
    <URL>landing_page_url</URL>
  </PointOfSale>
</PointsOfSale>

下表介绍了 <PointOfSale> 元素的子元素：

元素 必填 说明
<DisplayNames> Optional

包含在线旅行社 (OTA) 的显示文本。 此元素具有以下属性：

  • display_text：包含广告或免费的预订链接中显示的文本。应为合作伙伴的名称。
  • display_language： 双字母语言代码，用于指定广告或免费的预订链接的显示语言。此属性的值必须与 <Match> 元素指定的受支持语言一致。

以下示例展示了法语 OTA 的显示名称：

  <DisplayNames
    display_text="TravelAgency.com.fr"
    display_language="fr"
  />

请为集中预订系统 (CRS) 供应商（也称为“集成合作伙伴”）以及直接供应商（例如酒店所有者或连锁酒店）排除 <DisplayNames> 元素。对于这类合作伙伴，广告和免费的预订链接文字取自酒店列表中的酒店 <Name> 元素。

注意：对于 OTA，如果您已通过 Google 支持团队配置了默认显示名称，则此字段为可选字段。否则，OTA 必须提供 <DisplayNames>。
<Match> Required

定义过滤条件，以便根据用户或酒店的各种特征确定是否展示您的广告和免费的预订链接。例如，您可以指定仅向某个国家/地区的用户展示广告或免费的预订链接。

此元素具有以下属性：

  • status：确定匹配是包含还是排除指定条件的结果。有效值为 yes（必须匹配）或 never（不得匹配）。
  • country：与用户和酒店关联的 Google 网域中的匹配项。此属性采用两个字母的国家/地区代码。例如 US 或 FR。
  • language：匹配用户和酒店的语言。此属性接受 两个字母的语言代码。例如 en 或 fr。
  • brand：根据酒店列表中指定的 hotel_brand 属性的值进行匹配。如果您为预订引擎或各种品牌使用不同的网址，此过滤条件会很有用。
  • currency：与用户或酒店所在国家/地区使用的币种匹配。 此属性采用由三个字母组成的货币代码。例如 USD 或 EUR。
  • sitetype：在用户查看了您的酒店价格数据的 Google 产品/服务中进行匹配。此属性采用以下值：
    • localuniversal：用户是通过搜索（通常是在 google.com 上搜索）找到的广告或免费的预订链接。
    • mapresults：用户通过 maps.google.com 找到了酒店预订链接。

      • 注意：不允许将所有网站类型设置为 never。这会导致 sitetype 被忽略。

  • device：根据用户用于搜索的设备类型进行匹配。此属性采用 mobile、desktop 或 tablet。

    注意：如果 device 设置为 tablet，则无法将 status 设置为 never。

例如：

<PointOfSale id="test1">
  <Match status="yes" country="US"/>
  <Match status="yes" currency="USD"/>
  <Match status="yes" device="mobile"/>
  <Match status="yes" language="en"/>
  <URL>www.google.com</URL>
</PointOfSale>

您可以组合使用 <Match> 元素的属性来简化匹配规则，如以下示例所示：

<PointOfSale id="test1">
  <Match
    status="yes"
    country="US"
    language="en"
    currency="USD"
    device="mobile"/>
  <URL>www.google.com</URL>
</PointOfSale>

如需了解详情，请参阅着陆页匹配规则。
<URL> Required 指定指向您网站的链接，供用户预订客房。您可以将有关用户及其行程的动态信息插入为查询字符串参数。例如，您可以在网址中使用 PARTNER-HOTEL-ID 变量添加酒店 ID： 
http://partner.com/landing?hid=(PARTNER-HOTEL-ID)

构建此链接并将其显示给用户时，Google 会将 PARTNER-HOTEL-ID 变量替换为相应的酒店 ID。当用户点击到您的网站后，您的网站就可以提取并处理所有查询字符串参数的值，以打造顺畅的用户体验。如需查看着陆页网址中允许使用的变量的完整列表，请参阅 使用变量和条件。

使用跟踪功能时，请指定完整网址，包括跟踪所需的组件。例如：

https://example.tracker.com?campaign_id=(CAMPAIGN-ID)&amp;t_url=
http://partner.com/landing%3Fhid%3D(PARTNER-HOTEL-ID)

ValueTrack 参数不能在 <URL> 中使用。

您只能为每个着陆页定义一个 <URL> 元素。
<LPURL> Optional

用于支持着陆页网址中的动态跟踪。指定 <网址> 元素中定义的网址的非跟踪部分。 您必须使用 Google Ads 账号中提供的 Google Ads 跟踪模板和最终到达网址后缀来指定着陆页网址的跟踪部分。如果 Google Ads 中没有跟踪网址，系统会忽略 <LPURL> 元素。

<LPURL> 值无需转义。只要在 Google Ads 中正确配置了 ValueTrack，系统就会自动对其进行转义，用户无需再执行转义操作。例如：

http://partner.com/landing?hid=(PARTNER-HOTEL-ID)

ValueTrack 参数不能在 <LPURL> 中使用。 如需了解详情，请参阅 为酒店广告系列设置动态跟踪。

着陆页文件架构定义了着陆页文件的结构和约束条件。如需了解详情，请参阅酒店广告架构