着陆页文件语法

着陆页文件的根元素是 <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 找到了酒店预订链接。
  • 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>”中使用。 如需了解详情，请参阅 为酒店广告系列设置动态跟踪。

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