变量和条件

酒店广告和免费的预订链接包含指向着陆页的链接，用户可以在着陆页上预订客房。您可以定义 Google 构建链接的方式，以便在其中添加有关用户及其行程的所有其他信息。例如，您可以在相关网址中添加酒店 ID、语言、币种代码和入住日期等信息。

概览

您可以在着陆页文件中定义着陆页网址。当广告或免费预订链接展示时，网址中的动态信息会被替换为实际值。如需向着陆页网址添加动态值，请使用以下语法：

<URL>https://partner_url?param_id=(variable_name)</URL>

以下示例展示了一个使用 Google 的变量名称而非实际酒店 ID 和行程的网址：

示例 1

<URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)
  &amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)
  &amp;checkinYear=(CHECKINYEAR)&amp;nights=(LENGTH)
</URL>

示例 2

<URL>https://www.partnerdomain.com/hotel/(PARTNER-HOTEL-ID)
  &amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)
  &amp;checkinYear=(CHECKINYEAR)&amp;nights=(LENGTH)
</URL>

在为搜索结果页构建着陆页链接时，Google 会将变量替换为实际值，以确保网址包含动态信息。例如，如果用户预订了 42 号酒店的房间，入住时间为 2023 年 5 月 23 日，入住时长为 6 晚，Google 会将上述链接呈现为以下形式：

https://www.partnerdomain.com?hotelID=42&checkinDay=23&checkinMonth=05&checkinYear=2023&nights=6

Google 为查询字符串中的变量分配的值取决于酒店价格 Feed、酒店列表 Feed 和用户设置中的相应数据。

例如，LENGTH 变量的值会从相关行程的价格 Feed 分配给 <Nights> 元素。同样，PARTNER-HOTEL-ID 变量的值是在与用户搜索条件匹配的酒店列表 Feed 的 <id> 元素中定义的。

某些变量是价格 Feed 元素的子集。例如，CHECKINDAY、CHECKINMONTH 和 CHECKINYEAR 变量是从价格 Feed 中的单个 <Checkin> 元素中提取的。其他变量根据用户的语言区域和其他客户端设置计算得出。

如需详细了解变量值的来源，请参阅价格概览和酒店列表。

网址变量

下表介绍了可用于构建着陆页网址的可用变量：

网址中的条件逻辑

您可以在着陆页文件的 <URL> 元素中使用特殊指令来有条件地构建端点。

条件逻辑支持以下语句：

• if_statement：如果为 true，则将此条件之后的值插入网址中；否则，将 ELSE 指令之后的值插入网址中。

• for_statement：创建一个 FOR 循环条件，该条件会根据提供的值的数量进行迭代。

IF 和 FOR 语句包含以下内容：

IF-AD-CLICK 示例

您可以构建一个条件块，用于查看用户点击的是广告还是免费的预订链接，以便重定向到您的着陆页。

以下示例在着陆页文件中使用此指令：

<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)(IF-AD-CLICK)&amp;adType=1(ELSE)&amp;adType=0(ENDIF)</URL>

在此示例中，如果用户未点击广告，结果将显示为下列网址：

https://www.partner.com?hid=123&adType=0

如果用户点击了广告，则结果将显示为下列网址：

https://www.partner.com?hid=123&adType=1

IF-CLICK-TYPE-HOTEL 示例

您可以构建一个条件块，用于检查用户是否选择了没有明确的客房套装的酒店。交易消息的 <Room Bundle> 块中 <RatePlanID> 元素的值将设置为用户已选择的隐式关联的客房套餐价格。

以下示例在着陆页文件中使用此指令：

<URL>https://partner.com/(IF-CLICK-TYPE-HOTEL)landing(ELSE)landing_room(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>

在此示例中，如果用户选择了房间套装，结果将显示为下列网址：

https://partner.com/landing_room?hid=123

如果用户未选择 Room Bundle，则结果为以下网址：

https://partner.com/landing?hid=123

IF-CLICK-TYPE-ROOM 示例

您可以构建一个条件块，用于检查用户是否选择了客房套餐。

以下示例在着陆页文件中使用此指令：

<URL>https://partner.com/(IF-CLICK-TYPE-ROOM)landing_room(ELSE)landing(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>

在此示例中，如果用户未选择 Room Bundle，结果将显示为下列网址：

https://partner.com/landing?hid=123

如果用户选择的是房间套装，则结果将显示为下列网址：

https://partner.com/landing_room?hid=123

IF-DEFAULT-DATE 示例

使用 IF-DEFAULT-DATE 条件语句设置一个非日期参数，如果用户未选择日期，您的网站随后可以使用该参数触发自定义行为。

以下示例检查是否使用了默认日期：

<URL>https://partner.com?hotelID=(PARTNER-HOTEL-ID)&amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)&amp;checkinYear=(CHECKINYEAR)&amp;nights=(LENGTH)<strong>(IF-DEFAULT-DATE)</strong>&amp;popup_datepicker=true(ELSE)&amp;popup_datepicker=false(ENDIF)</URL>

在此示例中，如果用户未选择日期，结果可能类似于以下显示默认日期选择的网址：

https://partner.com?hotelID=123&checkinDay=23&checkinMonth=05&checkinYear=2023&nights=1&popup_datepicker=true

如果用户选择了日期，则结果可能类似于以下网址，具体取决于用户选择的行程：

https://partner.com?hotelID=123&checkinDay=23&checkinMonth=05&checkinYear=2023&nights=2&popup_datepicker=false

IF-HOTEL-CAMPAIGN 示例（酒店广告和免费预订链接点击）

您可以构建一个条件块，用于查看用户点击的广告是否源自于酒店广告系列。

以下示例在着陆页文件中使用此指令：

<URL>https://partner.com?hotelID=(PARTNER-HOTEL-ID)(IF-HOTEL-CAMPAIGN)&amp;hotel_campaign=(CAMPAIGN-ID)(ELSE)utm_campaign=(CAMPAIGN-ID)(ENDIF)</URL>

在此示例中，如果用户点击酒店广告系列网址，结果将显示为下列网址：

https://www.partner.com?hotelID=123&hotel_campaign=12345678

如果点击的不是酒店广告系列网址（例如常规搜索广告系列），则结果将显示为下列网址：

https://www.partner.com?hotelID=123&utm_campaign=87654321

如果您想区分酒店广告系列点击带来的流量与其他点击带来的流量，此功能会非常有用。

包含 FBL 点击的空白 CAMPAIGN-ID

如果点击来自免费预订链接，则 IF-HOTEL-CAMPAIGN 返回 TRUE，并且 CAMPAIGN-ID 值会设为空白，如以下网址所示：

https://www.partner.com?hotelID=123&hotel_campaign=

您可以使用 IF-AD-CLICK 条件语句来防止出现空白的广告系列 ID，如以下示例所示：

<URL>https://partner.com?hotelID=(PARTNER-HOTEL-ID)(IF-HOTEL-CAMPAIGN)(IF-AD-CLICK)&amp;hotel_campaign=(CAMPAIGN-ID)(ELSE)&amp;FreeBookingLink(ENDIF)(ELSE)utm_campaign=(CAMPAIGN-ID)(ENDIF)</URL>

IF-PROMOTED 示例（仅限酒店广告）

您可以构建一个条件块，用于查看用户是否点击了房源推广广告。

以下示例在着陆页文件中使用此指令：

<URL>https://partner.com/(IF-PROMOTED)1(ELSE)0(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>

在此示例中，如果用户选择了酒店宣传广告，结果将显示为下列网址：

https://partner.com/1?hid=123

如果用户未选择酒店宣传广告，结果将显示为下列网址：

https://partner.com/0?hid=123

IF-RATE-RULE-ID 示例

您可以构建一个条件块，用于检查用户是否选择了条件费率，如果选择了，则使用交易消息的 <Rate> 块中 <RateRuleID> 元素的值。

以下示例在着陆页文件中使用此指令：

<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)(IF-RATE-RULE-ID)&amp;customerType=42(ELSE)(ENDIF)</URL>

在此示例中，如果用户未选择条件式价格，则结果为以下网址：

https://www.partner.com?hid=123

如果用户选择了条件式价格，则结果为以下网址：

https://www.partner.com?hid=123&customerType=42

IF-USER-LIST-ID 示例（在 Google Ads 中定义）

如果您在 Google Ads 的酒店广告系列中为受众群体名单设置了出价调节系数，则可以将 IF-USER-LIST-ID 与 USER-LIST-ID 搭配使用，以便为属于特定 Google Ads 受众群体名单的客户在您的网站上设置参数。您可能需要这样做，以便进行跟踪或为受众群体名单中的成员自定义网站。

<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)(IF-USER-LIST-ID)&amp;audience_list=(USER-LIST-ID)(ELSE)(ENDIF)</URL>

在此示例中，如果用户不是某个受众群体名单的成员，结果将显示为下列网址：

https://www.partner.com?hid=123

如果用户是受众群体名单 12345678 的成员，则结果为以下网址：

https://www.partner.com?hid=123&audience_list=12345678

IF-VERIFICATION 示例

如果您需要检查 Google 是否生成了用于测试或自动验证的网址，可以使用 IF-VERIFICATION。

<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)(IF-VERIFICATION)&amp;isgoogle=true(ENDIF)</URL>

在此示例中，如果 Google 未生成用于测试或验证的网址，则结果为以下网址：

https://www.partner.com?hid=123

如果 Google 生成了用于测试或验证的网址，则结果是以下网址：

https://www.partner.com?hid=123&isgoogle=true

FOR-EACH-CHILD-AGE 示例

您可以构建一个条件块，用于填充酒店价格 Feed 中指定的每位儿童入住者的最大年龄。

以下示例在着陆页文件中使用此指令：

<URL>https://partner.com?adults=(NUM-ADULTS)&amp;children=(NUM-CHILDREN)(FOR-EACH-CHILD-AGE)&amp;age=(CHILD-INDEX)_(CHILD-AGE)(END-FOR-EACH)&amp;hid=(PARTNER-HOTEL-ID)&amp;</URL>

在此示例中，如果行程包含 2 名成人和 2 名儿童（年龄分别为 0 岁和 17 岁），则结果将显示为以下网址：

https://www.partner.com?adults=2&children=2&age=0_0age=1_17&hid=123

如果行程包含 2 位成人和 0 位儿童，则结果为以下网址：

https://www.partner.com?adults=2&children=0&hid=123

构建网址时的一般规则

所有变量都是可选的。您无需在着陆页网址中插入任何变量。不过，使用变量传递行程和用户信息通常可以为用户带来更好的体验，并有助于您遵守 Google 的政策。

在着陆页文件中定义构造的网址时，请遵循以下一般规则：

• 所有变量都用左括号和右括号括起来。

• 查询字符串参数必须在最终输出中用和号 ("&") 分隔。因为和号是 XML 中的特殊字符，而着陆页文件格式是 XML。因此，您必须改用编码后的实体“&”。最终输出会呈现实际的“&”字符。 例如：

  <!-- Do this: -->
  <URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)&amp;nights=(LENGTH)</URL>
  
  <!-- Do NOT do this: -->
  <URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)&nights=(LENGTH)</URL>
  

  您还必须对可能包含在着陆页网址中的特殊字符进行网址编码。例如：

  • 空格 (" ")：将 <URL> 元素中的空格字符替换为“%20;”
  • 正斜杠 (“/”)：将 <URL> 元素中的正斜杠替换为“%2F;”

  并非所有非字母字符都必须进行网址编码。例如，连字符“-”无需进行网址编码。如需查看必须进行网址编码的常见字符列表，请参阅网址编码。

• 单个参数的值可以由多个变量构成。以下示例使用 CHECKINDAY、CHECKINMONTH 和 CHECKINYEAR 变量构建单个参数 checkinDate：

  <URL>https://www.partnerdomain.com?checkinDate=(CHECKINDAY)%2F;(CHECKINMONTH)%2F;(CHECKINYEAR)</URL>
  

  此示例会生成类似于以下内容的网址：

  https://www.partnerdomain.com?checkinDate=7/23/1971
  

• 您可以为查询字符串参数的名称使用任何 ID。您的服务器会处理这些值。不过，您传递的值仅限于可用变量列表。

• 除了可用变量列表中的变量之外，您还可以使用最多 5 个自定义变量。