功能块导航

本页介绍了 AI Commerce Search 的平铺导航功能。

为什么要使用功能块？

作为属性值对的可视化表示形式，平铺是一种不同于动态构面的信息呈现方式，它仅显示特定查询中最常互动的属性，而与购物者不一定直观的动态构面系列无关。此功能的目的是提高滤镜的使用率，从而提高每位用户带来的收入。平铺导航可使强 HEAD 查询中的过滤条件使用情况更具相关性，从而有助于更准确地预测收入（通过回归）。

平铺式导航功能是引导式搜索软件包的一部分，可帮助客户更快地缩小用户查询范围，并提供与最终用户更相关的结果。平铺式导航功能旨在解决动态方面占用的空间问题，让用户能够更快地找到可能更相关的内容。此外，平铺式导航还可避免买家必须在左侧或右侧导航窗格中浏览所有方面系列，才能找到所需的确切商品，然后还必须通过第二次点击提交按钮来确认缩小后的搜索选择。

功能块导航可与动态分面相辅相成

在 Gemini Enterprise for Customer Experience 控制台中，通过上传商品目录，即可在 AI Commerce Search 中获得动态分面。这些过滤条件通过更改显示的过滤条件的顺序来缩小查询范围，以便将正确的过滤条件放在顶部，并使搜索在每次搜索轮次中返回更相关的结果。

动态方面可对过滤条件系列进行排序，例如时尚零售商的查询“连衣裙”的“款式”“袖子”，或食品杂货零售商的查询“牛奶”的“容量”“种类”或“容器”。通常，这些动态分面系列以用户并不总是直观的方式排列。此外，用于动态分面选择的弹出式窗格会占用商品网站上的大量空间，并且同样不一定适合在移动设备上显示。

因此，我们需要减少商品网站上的广告空间，并提高每次搜索转化的用户收入。

板块是如何运作的？

通过板块导航，用户可以更快地缩小搜索范围，从而提高搜索互动度和每次搜索带来的收入。无论分面系列如何，平铺都可以水平显示在商品网站上。该功能可控制搜索过滤条件，将最有可能吸引用户互动的过滤条件单独放置在页面顶部，从而使搜索结果脱离其动态商品详情系列，以便立即直观地显示。这样一来，用户就可以通过板块导航更轻松地找到动态方面内容。

买家历程

如果买家在启用平铺导航的零售商网站上进行搜索，则会看到最多 20 个平铺，其中显示最有可能吸引买家的各个过滤条件值。这些功能块按使用可能性排序，与商品属性系列无关。每个功能块都可以包含一张图片，用于展示应用相应过滤条件后的典型商品。如果客户点击某个功能块，则相当于应用了相应的事实值。这样一来，商品列表就会更新为与搜索查询和过滤条件相符，并显示已应用的商品详情。此外，显示的板块会刷新，以反映新的预期互动率，但会排除已应用的任何过滤条件。

零售商历程

零售商向 AI Commerce Search 发送查询，并收到标准查询回复，其中包含按商品属性系列排序的平铺值列表，以及生成平铺图片的方式。然后，零售商会渲染包含或不包含图片的图块。如果潜在客户点击某个板块或方面值，零售商会向 Google 发送一个新查询，其中包含与该板块或方面对应的过滤条件，该过滤条件已添加到过滤条件字段中。零售商网站还会向 Google 发送添加了过滤条件的第二次查询的事件。无论是“用户点击了过滤条件”还是“用户点击了功能块”，AI Commerce Search 响应、发送给 Google 的查询和发送给 Google 的事件都是相同的。

图块中显示的过滤条件

根据零售商在 Gemini Enterprise for Customer Experience 控制台中的 AI Commerce Search 或 AI Commerce Search API 中设置的偏好，过滤条件可以符合平铺条件，这些偏好与内容、商品数量以及与定量查询相关。

基于内容

• 之前的搜索中不得应用过滤条件。
• 仅限与标记为可动态分面的目录属性中的属性值对应的板块。
• 搜索返回结果（AI Commerce Search 响应）必须包含至少一件商品。
• 系统过滤条件（例如“instock = yes”或“available for sale = yes”）对应的图块不会显示。
• 系统会按互动可能性对功能块进行排序。

基于商品数量

• 如果可排名功能块的数量少于 20 个，该怎么办？
  • 如果介于 >= 2 和 < 20 之间，则返回尽可能多的图块。
  • 如果可用功能块数量不足 2 个，则不返回任何功能块。
• 如果可排名图块的数量超过 20 个，则根据互动可能性返回前 20 个。

基于量化查询

• 图块支持“分类”（颜色 = 红色）和数值（重量 =“1 磅 - 2 磅”）。
• 数字模块的分桶：
  • 系统会遵循使用特定属性的控制变量配置的分桶。例如，如果某个方面手动分桶为 0-1 磅、1-3 磅和 3-6 磅，则这些分桶会用于板块。如需了解更多详情，请参阅动态分面和板块控件。
  • 如果某个分面是自动分桶的，则应在板块中使用相同的分桶。

AI Commerce Search API 中的功能块导航？

没有针对功能块功能的新 API。不过，我们已向现有的 Vertex AI 主要（查询）API 添加了新字段。

请求 tileNavigationSpec

查询

{
  "tile_navigation_requested": boolean,
  "applied_tiles": repeated
}

字段（请求）
tile_navigation_requested	此布尔值字段用于指定客户是否希望请求使用功能块导航。
applied_tiles	此重复字段用于指定已点击的图块。

首先，设置 tileNavigationSpec 字段。调用包含属性名称和值的对象 productAttributeValue，例如 name=color 和 value=red。将所有其他字段保持不变。

Response tileNavigationResult

然后，该 API 会在 tileNavigationResult 字段中返回最多 20 个功能块，并按使用可能性排序。响应会根据图块的属性值和相应的代表性图片显示图块：

响应

...
  "tileNavigationResult": {
    "tiles": [
      {
        "productAttributeValue": {
          "name": "sizes",
          "value": "large"
        },
        "representativeProductId": "xxxx"
      },
      {
        "productAttributeValue": {
          "name": "attributes.weight",
          "value": "light"
        },
        "representativeProductId": "xxxx"
      },
      {
        "productAttributeValue": {
          "name": "colors",
          "value": "black"
        },
        "representativeProductId": "xxxx"
      }
    ]
  }
  ...

字段（回答）
tiles	此重复字段用于驱动客户端上向用户显示的板块。该字段包含一个模块列表，其中每个模块都是一个包含 productAttributeValue 和 representativeProductId 的对象。

现有 API 无需更改，新的客户端库将在正式版发布时推出，并发布在公共库文档中。

零售商应如何处理板块搜索结果

• 显示板块：按提供的顺序显示返回的板块，响应中的第一个板块是显示的第一个板块。ProductAttributeValue 是一个键值对，其中包含属性值，以便您了解要显示哪些功能块。在后续搜索请求中，应在 appliedTiles 字段中设置 ProductAttributeValue，还应在 filter 字段中设置（例如，filter = "attributes.weight:ANY(\"large\")"）。然后，响应将包含过滤后的商品和一组新的要显示的板块。

• 显示图片：这些图片可以通过引用响应中的 representativeProductId 字段来获取，该字段提供与应用的过滤条件匹配的典型商品的商品 ID。然后，零售商会在自己的系统中查找此代表性商品 ID，并选择要在图块中显示的相应图片。请务必使用代表性商品 ID，而不是主商品 ID，以确保图片能够准确反映过滤后的属性（例如，针对 color = "red" 过滤条件显示红色款式/规格）。

在控制台中配置功能块行为

搜索界面上显示的板块由目录属性直接决定，而目录属性是从零售商上传到商品清单的信息中提取的。候选块是商品清单中所有“可动态分面的属性”的属性中的所有值。

启用动态分面和平铺

过滤条件由商品属性控制，这些属性源自商品目录和用户事件。设置动态分面和平铺，以便最终用户查询与商品属性相匹配。

注意： 若要在项目中启用平铺功能，您必须每周持续发出至少 7,000 次 API 请求。从本质上讲，这意味着项目必须已处于生产环境中。

如需控制哪些属性可用于动态分面和平铺，请执行以下操作：

1. 前往 Gemini Enterprise for Customer Experience 控制台中 AI Commerce Search 的控制页面。 前往“控制”页面

2. 点击属性控件标签页 > 设置功能块控件。

3. 可选：如需修改属性控制变量，请点击属性旁边的 修改控制变量，然后将每个属性的控制变量设置为 True 或 False。

第三列和第四列（可编入索引和动态分面）对于控制图块至关重要。对于每个属性行，这两个列都必须标记为 True，功能块才能正常运行。可编入索引：启用后，AI Commerce Search 可以使用相应属性进行过滤。启用动态分面后，AI Commerce Search 可以根据过去的用户行为（例如分面点击和浏览）自动将某个属性用作动态分面。

如需了解如何在 API 中执行此操作，请参阅 API 中的功能块控制部分。

单个功能块控件

借助构面控件，您无需更改目录即可管理构面的行为，并影响您网站上的搜索行为。

移除分面控件可从某些查询的动态分面结果中移除整个分面。它还会移除此分面的成员图块，使其无法作为图块返回。

以下在目录级标记为动态分面和平铺的分面值同样会影响平铺：

• 忽略分面值：禁止显示图块，并移除搜索结果中的动态分面。
• 替换分面值：让零售商能够更改图块和动态分面中特定查询的分面值（例如，对于属性 color，将 navy blue 更改为 blue）。
• 设置数值区间：允许零售商指定分桶大小，以便在动态分面和动态块中输出给定动态范围内的搜索响应。

下拉菜单中的最后三种动态分面控制类型不会影响图块：

• 强制返回分面
• 对动态分面重新排序
• 合并分面

如需详细了解如何控制每个控件上的特定商品详情值和平铺行为，请参阅商品详情控件。

API 中的功能块控制

本部分介绍了如何在 AI Commerce Search API 中控制平铺行为。

特性控件

对于搜索和推荐，您可以在 REST 资源“Resource: projects.locations.catalogs.attributesConfig”下的目录级层找到相应 API。此 API 提供了一些方法，用于在目录级别和商品级别添加、移除和替换属性。字段 catalogAttributes 可以映射到可编入索引、可搜索和 dynamicFacetable 的字段。如果分面符合平铺条件，则 dynamicFacetable 适用于平铺行为。

AttributesConfig

目录级属性配置。

与功能块相关的字段
catalogAttributes	map 在目录级启用属性配置，其中包含有关属性是否可搜索、是否可动态分面等信息，方法是将属性名称映射到值（即可调用对象）CatalogAttribute。

CatalogAttribute

attributesConfig 资源提供 CatalogAttribute（目录级对象）。此对象的两个字段用于生成控件，以控制哪些属性显示为图块。这意味着，商品清单中所有“可用于分面的属性”中的任何属性都可以作为平铺候选项：

与功能块相关的字段
DynamicFacetableOption	enum 全局控制字段，必须指定为启用或停用。此操作会开启或关闭动态分面，进而影响功能块。此属性在 Google Cloud 控制台的“属性控制”下设置。
facetConfig	包含各个分面值选项的对象。此字段是分面控制变量。

商品详情控件

FacetConfig

一个对象，包含用于使各个分面值动态化并因此可能实现平铺的分面选项。它是目录级 CatalogAttribute 配置中的一个字段。

该对象包含已有的字段，这些字段的影响范围现在已扩展到功能块：

JSON 示例

  "facetIntervals": [
    {
      object (Interval)
    }
  ],
  "ignoredFacetValues": [
    {
      object (IgnoredFacetValues)
    }
  ]

与功能块相关的字段
ignoredFacetValues	FacetConfig 中的此消息字段包含要忽略的当前属性名称的方面值（仅在方面中，不会影响目录中的商品说明），适用于指定时间范围。
facetIntervals	这样，零售商就可以为数值输入指定分桶大小。对于板块，此功能应以相同的方式运行 - 如果零售商为动态分面设置了特定的数值区间，则应为板块使用相同的数值区间。
removeFacetValue	移除特定分面键的分面值。这些值会映射到属性值。

了解如何在控制台中创建这些单独的控制措施。