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

此页面由 Cloud Translation API 翻译。

功能块导航

本页面介绍面向零售的 Vertex AI Search 的图块导航功能。

为什么使用功能块？

作为属性值对的可视化表示，图块是呈现与动态分面相同的信息的不同方式，它仅显示特定查询最常涉及的属性，而不受动态分面系列的影响，而动态分面系列对买家来说并不总是直观。这样做的目的是提高滤镜使用量，进而提高每位用户带来的收入。功能块导航可提高对强制 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 响应）中必须至少包含一个产品。
没有与系统过滤条件（例如“instock = yes”）对应的图块或“available for sale = yes”。
功能块会按互动可能性排序。

基于商品数量

如果可排名的功能块数量少于 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 进行任何更改，新的客户端库在正式发布时可用，并发布在公开库文档中。

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

显示功能块：按所提供的顺序显示返回的功能块，其中响应中的第一个功能块为显示的第一个功能块。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 使用该属性进行过滤。启用动态分面后，Search for Retail 可以根据过去的用户行为（例如分面点击和浏览）自动将某个属性用作动态分面。

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

单个功能块控件

利用商品详情控件，您可以在不更改目录的情况下管理商品详情的行为，并影响整个网站的搜索行为。

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

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

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

商品详情控件类型控件的下拉菜单中的最后三个动态商品详情控件类型不会影响功能块：

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

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

API 中的功能块控件

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

特性控件

对于搜索和建议，您可以在目录级别的 REST 资源资源下找到该 API：projects.locations.catalogs.attributesConfig。此 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`	移除特定分面键的分面值。这些值会映射到属性值。

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