“零售”已重命名为 Vertex AI Search 零售解决方案。我们正在更新内容，以反映新品牌。

此页面由 Cloud Translation API 翻译。

功能块导航

本页介绍了 Vertex AI Search for Retail 的功能块导航功能。

为什么使用功能块？

作为属性值对的直观表示，功能块是一种与动态细分条件相同的信息呈现方式，只会显示与特定查询最相关的属性，而不会显示对买家来说不一定直观的动态细分条件族。这样做的目的是提高滤镜使用量，进而提高每位用户带来的收入。功能块导航可提高对强效 HEAD 查询使用过滤条件的相关性，从而有助于更准确地预测收入（通过回归分析）。

功能块导航功能是“引导式搜索”套餐的一部分，可让客户更快地缩小用户查询范围，并提供与最终用户更相关的结果，从而让客户受益。功能块导航功能旨在解决动态细分条件的房地产问题，让用户能够更快地找到可能与其更相关的内容。功能块导航还可避免买家在左侧或右侧导航窗格中浏览所有细分属性族，以便找到他们要找的确切商品，然后还需要再次点击“提交”按钮来确认其缩小后的搜索范围。

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

通过上传商品目录，在 Search for Retail 控制台中提供动态细分条件。这些过滤条件会通过更改显示的过滤条件的顺序来缩小查询范围，以便正确的过滤条件显示在顶部，并使每次搜索返回的结果更相关。

动态细分条件会对一系列过滤条件进行排序，例如，对于时尚零售商，查询“连衣裙”时，系统会对“款式”和“袖长”进行排序；对于杂货零售商，查询“牛奶”时，系统会对“容量”“品种”或“包装”进行排序。通常，这些动态细分属性族的排列方式对用户来说并不总是直观的。此外，用于动态细分选择的弹出式窗格会占用商品网站上的大量空间，而且也不一定适合移动设备。

因此，他们需要缩减商品网站上的展示空间，并提高每次搜索转化的用户收入。

功能块的运作方式

功能块导航可让用户更快地缩小搜索范围，从而提高搜索互动度和每次搜索带来的收入。功能块可以横向显示在商品网站上，不受细分属性族的影响。功能块功能可控制搜索过滤条件，以便将最有可能吸引用户互动的过滤条件单独放置在页面顶部，从而将搜索结果从其动态细分属性族中分离出来，以便立即直观呈现。这样，功能块导航可为用户提供更易于访问的动态细分内容排列方式。

买家历程

当买家在启用了功能块导航的零售商网站上执行搜索时，最多会看到 20 个功能块，其中显示的是最有可能吸引买家互动的各个过滤条件值。这些功能块会按使用可能性排序，不考虑产品属性族。每个功能块都可以包含一张图片，表示应用了滤镜的典型商品。如果客户点击某个功能块，系统会像应用了相应的“面向”-“值”一样处理。这会更新商品列表，使其与查询和过滤条件相匹配，并显示应用的细分。此外，显示的图块会刷新，以反映新的预期互动率（不包括已应用的任何过滤条件）。

零售商转化历程

零售商向 Vertex AI Search for Retail 发送查询，并收到标准查询响应，其中包含按商品属性族对功能块值进行排名的排序列表，以及生成功能块图片的方法。然后，零售商可以选择是否渲染带有图片的功能块。如果潜在客户点击某个功能块或细分值，零售商会向 Google 发送一个新查询，并将与该功能块或细分对应的过滤条件添加到过滤条件字段中。零售商网站还会针对添加了过滤条件的第二个查询向 Google 发送事件。对于“用户点击了过滤条件”和“用户点击了功能块”，Vertex AI Search for Retail 响应、发送给 Google 的查询以及发送给 Google 的事件都是相同的。

图块中显示的过滤条件

过滤条件可以根据零售商在 Retail Search 控制台中或 Vertex AI Search for Retail API 中针对内容、商品数量和与定量查询相关的设置的偏好设置，确定是否符合功能块显示条件。

根据内容

过滤条件不得是在之前的搜索中应用的。
仅显示与标记为可动态构面的目录属性中的属性值对应的功能块。
搜索返回结果（Vertex AI Search for Retail 响应）中必须至少包含一个产品。
系统不会显示与系统过滤条件（例如“库存状况 = 是”或“可供销售 = 是”）对应的功能块。
功能块会按互动可能性排序。

基于商品数量

如果可排名的功能块数量少于 20 个，该怎么办？
- 如果大于等于 2 且小于 20，则返回尽可能多的功能块。
- 如果可用的功能块数量少于 2 个，则不返回任何功能块。
如果可排名的功能块超过 20 个，则根据互动可能性返回前 20 个功能块。

基于定量查询

功能块同时支持“分类”（颜色 = 红色）和数值（重量 =“1 磅 - 2 磅”）数据。
数值图块的分桶：
- 系统会遵循针对特定属性使用控件配置的分桶。例如，如果某个细分维度被手动分桶为 0-1 磅、1-3 磅和 3-6 磅，则这些分桶会在功能块中使用。如需了解详情，请参阅动态细分条件和功能块控件。
- 如果某个切面是自动分桶的，则功能块中应使用相同的分桶。

Retail 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 无需更改，新的客户端库在 GA 发布时可用，并会发布在公共库文档中。

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

显示功能块：按所提供的顺序显示返回的功能块，其中响应中的第一个功能块为显示的第一个功能块。ProductAttributeValue 是一个包含属性值的键值对，以便您知道要显示哪些功能块。在后续搜索请求中，应在 appliedTiles 字段中设置 ProductAttributeValue，还应在 filter 字段中设置 ProductAttributeValue（例如，filter = "attributes.weight:ANY(\"large\")"）。然后，响应中将包含过滤后的商品和一组新的功能块。
显示图片：您可以通过引用响应中的 representativeProductId 字段来获取这些图片，该字段提供与应用的过滤条件匹配的典型商品的商品 ID。然后，零售商会在自己的系统中查找此代表性商品 ID，并选择要在功能块中显示的适当图片。请务必使用代表性商品 ID（而非主要商品 ID），以确保图片准确反映过滤后的属性（例如，针对 color = "red" 过滤条件显示红色款式/规格）。

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

搜索屏幕上显示的功能块的选择直接取决于目录属性，而这些属性又是从零售商上传到商品目录的信息中提取的。候选图块是商品目录中所有“可动态分面属性”的属性值。

启用动态分面和平铺

细分由商品属性控制，这些属性来自商品清单和用户事件。设置动态分面和平铺功能可让最终用户的查询与商品属性相匹配。

如需控制哪些属性符合使用动态分面和功能块的条件，请执行以下操作：

在 Search for Retail 控制台的“控件”页面中，点击属性控件标签页，然后设置功能块控件。前往“控件”页面
如需修改属性控件，请点击属性旁边的 修改控件，然后将每个属性的控件设置为 True 或 False。

替代文本

第三列和第四列（可编入索引和动态分面）是控制图块的关键。对于每行属性，这两个列都必须标记为 True，功能块才能正常运行。可编入索引可让 Vertex AI Search for Retail 使用该属性进行过滤。启用动态构面后，零售业搜索广告可以根据过去的用户行为（例如构面点击和视图）自动将某个属性用作动态构面。

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

各个功能块控件

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

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

在目录一级被标记为动态分面和平铺的以下细分属性值控件也会影响图块：

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

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

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

如需详细了解如何控制每个控件上的特定细分值和功能块行为，请参阅细分控件。

API 中的功能块控件

本部分介绍了如何在 Vertex AI Search for Retail API 中控制功能块行为。

特性控件

对于搜索和推荐，您可以在目录级别的 REST 资源“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`	移除特定分面键的分面值。这些值会映射到属性值。

了解如何在控制台中创建这些各项控件。