Vertex AI Search for Retail 将重命名为 Vertex AI Search for Commerce。我们正在更新内容，以反映新品牌。

此页面由 Cloud Translation API 翻译。

功能块导航

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

为什么选择贴片？

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

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

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

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

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

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

板块是如何运作的？

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

买家历程

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

零售商历程

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

以图块形式显示的过滤条件

根据零售商可在 Search for Commerce 控制台或 Vertex AI Search for Commerce API 中设置的偏好设置，过滤器可用于平铺显示内容、商品数量和与定量查询相关的信息。

基于内容

之前的搜索中不得应用过滤条件。
仅与标记为可动态构面的目录属性中的属性值对应的功能块。
搜索返回结果（Vertex AI Search for Commerce 响应）必须包含至少一个商品。
系统过滤条件（例如“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 commerce 控制台的“控件”页面中，在特性控件标签页下设置您的板块控件。前往“控件”页面
如需修改属性控件，请点击属性旁边的 修改控件，然后将每个属性的控件设置为 True 或 False。

替代文本

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

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

单个功能块控件

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

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

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

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

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

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

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

API 中的功能块控制

本部分介绍了如何在 Vertex AI 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`	移除特定分面键的分面值。这些值会映射到属性值。

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

功能块导航 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。