着陆页文件语法

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

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