商品属性简介

适用于零售业的 Vertex AI Search 可以利用商品属性实现索引编制、动态分面、可搜索性、过滤和模型质量。本页讨论如何设置产品属性配置，以及如何根据您使用的方法和配置来处理这些配置。

属性类型

商品属性可以具有不同的默认设置和允许的选项，具体取决于其类型。

  • 系统属性：预定义的系统属性是现有的 Product 字段，用于提供有关商品的更多信息。包括品牌、库存状况、颜色和尺寸等商品属性。如需了解商品的所有可用的系统属性，请参阅 Product 参考文档。

  • 自定义属性：自定义属性是您使用 Product.attributes 字段定义的额外属性。例如商店名称、供应商或样式。如需查看自定义属性的示例和限制，请参阅 Product.attributes 参考文档。

  • 商品目录级属性：提供商品相关商店级信息的系统或自定义属性。如果商品（如杂货商品）在商店和区域之间有很大差异，则您可以为具有商店特定促销活动的商品使用商品目录级属性。

    inventories.price 和 inventories.originalPrice 是 Vertex AI Search 针对零售业预定义的数字系统属性。您可以创建自定义商品目录级属性，其可以是文本或数字。默认情况下，商品目录级属性可编入索引。商品目录级属性不支持设置可搜索和动态分面。

可用的配置设置

属性配置设置会影响您网站上的搜索和推荐行为。

搜索使用以下属性设置：

  • 可编入索引：搜索功能可以使用此属性进行过滤和分面。
  • 动态分面：搜索可以根据过去用户行为（例如分面点击和查看）自动将此属性用作动态分面。如需为特性启用动态构面，必须将该属性的 Indexable 设置为 true。
  • 可搜索：此属性可通过搜索查询搜索，从而提高该属性的召回率。此控件仅适用于文本特性。
  • 可检索：如果设置为 true，则搜索会在对搜索查询的响应中返回此属性。如果所有属性均将“Retrievable”设置为 false，则搜索结果将仅包含商品名称或（针对款式/规格）商品名称和颜色信息。

建议使用以下属性设置：

  • 可过滤（公开预览版）：此属性可用于推荐过滤表达式。此控件仅适用于文本属性。

可编入索引

如果将某个特性设置为可编入索引，则搜索可以使用该属性进行过滤和分面。

  • 系统属性：系统会始终为预定义的系统属性启用索引编制功能。无法为系统属性停用此设置。
  • 自定义属性：默认处于启用状态。您可以为任何自定义属性停用索引编制便利性。如果您打算将自定义属性设为可编入索引，则必须遵循正则表达式模式 [a-zA-Z0-9][a-zA-Z0-9_]*。例如 key0LikeThis 或 KEY_1_LIKE_THIS。
  • 商品目录级属性：始终为系统商品目录级属性启用；此设置无法更改。默认情况下，系统会为自定义商品目录级属性启用；您可以关闭此设置。
  • 依赖项：不适用

索引配置更改会在导入清单数据后立即生效。否则，您所做的更改最长可能需要 12 小时或更长时间才会生效。您可以在评估页面上测试您的更改是否已应用。

动态构面

为某个属性启用动态分面后，搜索功能可以将该属性用作动态分面。可以根据之前的用户行为（例如构面点击和视图）自动将动态构面添加到搜索中。

  • 系统属性：如果索引编制便利性设置为 true，则默认处于启用状态。您可以为任何系统属性停用动态分面。
  • 自定义属性：如果索引编制便利性设置为 true，则默认处于启用状态。您可以为任何自定义属性停用动态分面。
  • 商品目录级属性：不支持。
  • 依赖项：如需为某个属性启用动态分面，您必须先为该属性启用可编入索引性。

为特性设置动态构面始终是全局性的。您应用于特性的动态构面配置可供使用该特性的目录中的产品使用。

动态构面配置更改最多需要两天时间。您可以在评估页面上测试是否已应用您所做的更改。

对于数字自定义属性，需要在请求中指定存储分区。系统不会自动对数值进行分区。

可搜索

将某个属性设置为可搜索，可提高该属性在搜索查询中的召回率。

只能为文本属性值启用可搜索性。但不适用于数字属性。

  • 系统属性：Product 的预定义文本系统属性由 Vertex AI Search for Retail 配置其可搜索性设置。这些设置无法更改。
  • 自定义属性：默认处于停用状态。您可以为任何文本自定义属性启用此配置。
  • 商品目录级属性：不支持。
  • 依赖项：不适用

虽然具有可搜索属性的商品更有可能出现在该属性的搜索结果中，但不能保证它们一定会显示。

建议过滤

如果某个特性已开启推荐过滤，则可以在建议过滤表达式中使用它来过滤预测中的商品。

  • 系统属性：默认处于关闭状态。您可以为 Product 的任何预定义系统文本属性（FulfillmentInfo 和 title 除外）启用此设置。不支持数字属性。
  • 自定义属性：默认处于关闭状态。您可以为 Product 的任何自定义文本属性启用此设置。不支持数字属性。
  • 商品目录级属性：仅支持 availability 值 IN_STOCK。
  • 依赖项：不适用

配置模式

配置模式决定了系统如何处理属性配置以及您可以设置哪些属性配置。

  • 目录级配置模式（默认）：在此模式下，目录级目录级属性配置用作可信来源。
  • 产品级配置模式（已弃用）：在此模式下，产品级属性配置用作可靠来源。

以前，产品级配置是默认模式。如果您仍处于产品级配置模式，并且需要切换到目录级配置模式，请与支持团队联系。搜索不支持在切换后返回到产品级配置模式。

如需查看配置模式，请前往 Search for Retail 控制台的控件页面。如果网站级控件标签页上提供了 Indexable 选项作为列，则表示配置模型是目录级的。如果网站级控件标签页中未显示可编入索引列，则表示配置模型为产品级。

配置方法

您可以通过以下方式设置属性配置：

  • Search for Retail 控制台：使用 Search for Retail 控制台在目录级别设置属性配置。这将全局配置所有产品的属性。控制台中有哪些设置取决于配置模式。

  • AttributeConfig API 方法：使用 API 在目录级别设置属性配置。这将配置所有产品的属性。

  • Product API 方法（已废弃）：使用 Product API 方法在商品级别设置自定义属性。新用户无法使用此方法设置属性，因此不建议这样做。

在控制台中配置属性

您可以在 Search for Retail 控制台控件页面的网站级控件标签页上，对所有商品进行全局设置属性选项。如需详细了解如何在控制台中进行此设置，请参阅管理网站级属性控件。

如需使用此功能，配置模式必须是目录级。

对可编入索引和可搜索的属性配置设置所做的更改会在提取目录后立即生效。否则，更改最长可能需要 12 小时或更长时间才会生效。您可以在评估页面上测试您的更改是否已应用。

使用 AttributesConfig 配置属性

通过 AttributesConfig API 资源，您可以在目录级别管理属性配置。

以下字段在目录级别设置属性选项：

如需检索所有属性配置，请使用 GetAttributesConfig 方法。

更新多个属性

使用 updateAttributesConfig 方法在目录级别更新多个属性。

请求中包含的目录属性会在清单中更新，或者如果不存在则会插入。如果目录属性字段没有值，系统会为其分配默认值。

一个请求中所允许的目录属性数量上限为 1,000。

更新单个属性

以下方法用于更新单个清单属性：

  • AddCatalogAttribute：向目录属性添加单个属性配置。

    请参阅 AddCatalogAttribute 的 API 参考文档。

  • ReplaceCatalogAttribute：修改单个属性配置。 这将通过使用相同的 CatalogAttribute.key 更新目录属性来替换 AttributesConfig 中指定的 CatalogAttribute。

    请参阅 ReplaceCatalogAttribute 的 API 参考文档。

  • RemoveCatalogAttribute：从 AttributesConfig 中移除单个属性配置。

    只能删除未被产品使用的 CatalogAttributes。如果使用了 CatalogAttribute，RemoveCatalogAttribute 不会将其删除，但会将其配置属性重置为默认值。如果有任何产品正在使用该属性，则 CatalogAttribute.inUse 会设置为 True。

    请参阅 RemoveCatalogAttribute 的 API 参考文档。

使用 Product 方法配置属性（已废弃）

新用户无法使用此方法设置属性，因此不建议这样做。

以下字段通过 Product API 方法为特定商品设置可编入索引和可搜索的设置：