着陆页文件语法

着陆页文件的根元素是 <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)

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

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

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

<LPURL> 值不需要转义。Google Ads 中有正确的 ValueTrack 配置会自动对其进行转义。例如：

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

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

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