商品属性简介

Vertex AI Search 商务解决方案可使用产品属性来实现索引编制、动态分面、可搜索性、过滤和模型质量。本页面介绍了如何设置商品特性配置，以及系统如何处理这些配置，具体取决于您使用的方法和配置。

属性类型

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

• 系统属性：预定义的系统属性是现有的 Product 字段，可提供有关商品的更多信息。这些属性包括品牌、供应情况、颜色和尺寸等商品属性。如需查看产品的所有可用系统属性，请参阅 Product 参考文档。

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

  以下是排名前 20 的自定义属性的一些示例：

  • 相应商品所属的产品线
  • 相应商品的实体店销量
  • 服装的适用场合
  • 适用于相应商品的特惠和优惠券
  • 网站级商品热门程度

• 商品目录级属性：提供商品实体店级信息的系统属性或自定义属性。对于属性在不同商店和区域之间差异很大的商品（例如食品杂货）或有特定商店促销活动的商品，您可以使用商品目录级属性。

  inventories.price 和 inventories.originalPrice 是 Vertex AI Search for Commerce 预定义的数值型系统属性。您可以创建自定义的商品级属性，这些属性可以是文本属性，也可以是数字属性。默认情况下，广告资源级属性可编入索引。不支持为商品目录级属性设置可搜索性和动态分面。

可用的配置设置

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

搜索使用以下属性设置：

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

“推荐”功能使用以下属性设置：

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

可编入索引

如果将特性设置为可编入索引，则搜索功能可以使用该特性进行过滤和构面。

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

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

动态构面

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

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

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

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

对于数值自定义属性，需要在请求中指定分桶。 数值不会自动分桶。

可搜索

如果将特性设置为可搜索，则该特性在搜索查询中的召回率会提高。

只有文本属性值才能启用可搜索性。不适用于数值属性。

• 系统属性：Product 的预定义文本系统属性的搜索设置由 Vertex AI Search for Commerce 配置。此设置不可更改。
• 自定义属性：默认处于停用状态。您可以为任何文本自定义特性启用此配置。
• 商品目录级属性：不支持。
• 依赖项：不适用
• 完全可搜索：针对与目录中任何指定商品匹配的搜索查询返回有针对性的搜索结果。此选项非常适合序列号。详细了解可精确搜索的选项。

虽然具有可搜索属性的商品更有可能显示在相应属性的搜索结果中，但并不能保证一定会显示。

过滤建议

如果某个属性已开启推荐过滤功能，则可以在推荐过滤表达式中使用该属性来过滤预测中的商品。

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

可进行精确搜索的选项

您可以为 exact-searchable 选项（目录属性字段）指定特定字符串查询的某个值。如果查询与商品目录中的任何商品匹配，且相应字段的值与查询中给定的字符串相同，则搜索查询会返回完全相同的商品。此选项非常适合序列号，因为客户希望获得有针对性的搜索体验。

通常，对于自定义属性，ExactSearchableOption 字段适用于具有确切值（例如 ModelId 或 ManufacturerId）的商品属性。product_id 等属性是主索引字段，默认情况下可以进行精确搜索。对于完全匹配，item_id 字段始终处于启用状态，无法停用。

• 为避免在搜索中返回不相关的商品，请勿将可搜索选项设置为 battery 等通用值。
• 为避免搜索查询的投放量不足，请勿将 tag 等特殊字段（其字符串值可能包含“iphone”）设置为精确可搜索。这样做可能会导致这些查询限制商品目录中所有 iPhone 的结果。

如需了解详情，请参阅商品属性简介。

属性行为

使用主商品和款式/规格商品指定项来构建商品目录时，请了解如何处理商品属性以进行过滤。它们的行为取决于您使用的是搜索还是推荐，以及您如何配置目录分类。

为确保过滤行为可预测且准确，请确保主要商品和变体商品的过滤属性定义保持一致且完整。这种方法有助于进行精确过滤，从而提高商品发现率和搜索相关性。

搜索与推荐中的主要变体行为

虽然搜索和推荐结果中仅返回主要商品，但 Vertex AI Search 商务解决方案可优化搜索和推荐质量。

• 对于搜索模型，变体属性用于搜索索引中的主商品。搜索结果会根据主要商品的款式/规格属性显示各种选项。

• 对于推荐模型，商品详情和属性不会从主要商品继承到款式/规格商品。为获得最佳推荐质量，主商品和款式/规格商品的关键属性（例如 product.categories、product.title、product.attributes 和 product.prices）必须具有完整准确的详细信息。

在编入索引和过滤期间处理属性

如果主要和变体中定义了相同的属性，则变体中的属性会参与过滤。例如，假设为主要商品及其变体（颜色或尺寸）定义了某个属性。变体属性值主要用于过滤，在此期间，系统会检查主商品的任何变体是否与属性值匹配。以商品库存状况为例：主商品可以标记为 out-of-stock，但如果其至少一个变体标记为 in-stock，那么在应用 in-stock 过滤条件后，主商品会显示在搜索结果中。

出于以下原因，请在主要和变体中设置相同的可过滤属性：

• 变体属性优先用于过滤。如果主商品及其变体上都定义了某个属性，则在过滤时使用变体中的属性。例如，如果主商品的颜色是占位颜色，但其款式/规格具有实际颜色，则应填充款式/规格的颜色，并将其用于过滤。

• 对于与库存相关的属性（例如库存状况），如果主商品有款式/规格，则主商品的库存状况应设置为 OUT_OF_STOCK，而实际库存状况（例如 IN_STOCK）应在款式/规格级别设置。这样一来，只要至少有一款变体有货，系统就会将主商品视为有货。如果是，则 availability: ANY("IN_STOCK") 等过滤条件会正确返回主商品。

• 使用过滤表达式时，预测响应将返回至少有一个主要商品或变体商品与过滤条件的属性值匹配的主要商品。

用于过滤的可选属性

请保持 categories 字段的整洁，并针对分类进行优化。如果需要进行更精细的过滤，请使用单独的自定义属性（而非 categories 字段）根据广泛的类别来实现。这还可以避免对类别建议的自动补全训练造成负面影响。

例如，假设您通常设置 [lvl1, lvl1>lvl2, lvl1>lvl2>lvl3] 等类别进行过滤。自动补全功能会统计给定查询中最常出现的类别，因此您最终会获得 lvl1 和 lvl2（您的所有商品）作为建议的类别。

最佳做法

如果您的目录包含主商品和款式商品，并且两者都定义了同一属性，则在过滤时系统会考虑款式商品中的属性。

• 准确填充属性：确保主商品和变体商品的属性（尤其是用于过滤的属性）具有完整且准确的详细信息，以最大限度地提高效果。

• 使用内置字段：不要仅依赖于自定义属性。将商品信息映射到内置的 Product 字段（brands、colors、sizes 和必填字段）。内置字段对可搜索性、可编入索引性和相关性优化有更大的影响。自定义属性 (Product.attributes) 适用于不适合使用预定义的系统属性的商品数据。

• 设置网站范围的可检索字段控制：该 API 支持 variantRollupKeys 变体，允许您在搜索响应中检索详细信息。

• 目录语言保持一致：商品目录应仅使用一种语言，并且搜索查询应使用相同的语言发送。目录中包含多种语言可能会降低模型性能。如果不设置语言代码，可能会影响拼写更正等功能。

• 价格信息：准确填写主要商品和款式/规格商品的价格信息，以确保建议和过滤结果的准确性。如果商品缺少商品级价格，而仅依赖本地商品目录价格，请使用商品目录级价格的中位数填充主商品的定价。

配置模式

配置模式决定了特性配置的处理方式以及您可以设置的特性配置。

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

以前，默认模式是商品级配置。如果您仍在使用商品级配置模式，并且需要切换到目录级配置模式，请与支持团队联系。Search 不支持在切换后退回到产品级配置模式。

如需查看配置模式，请前往“Search for commerce”控制台的控件页面。如果可编入索引选项在网站级控件标签页上显示为列，则配置模型为目录级。如果网站级控件标签页上没有可编制索引列，则配置模型为商品级。

配置方法

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

• Search for commerce 控制台：使用 Search for commerce 控制台在目录级别设置特性配置。此配置会为所有产品全局配置属性。哪些设置在控制台中可用取决于配置模式。如需详细了解如何在控制台中配置属性，请参阅下一部分。

• AttributeConfig API 方法：使用 API 在目录级设置特性配置。此配置适用于所有商品的属性。

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

在控制台中配置属性

您可以通过“Search for commerce”控制台控件页面上的网站级控件标签页，跨所有产品全局设置特性选项。如需详细了解如何在控制台中进行此设置，请参阅管理网站级特性控件。

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

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

使用 AttributesConfig 配置属性

借助 AttributesConfig API 资源，您可以管理目录级特性配置。

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

• CatalogAttribute.indexableOption：为属性设置可编入索引的选项。
• CatalogAttribute.dynamicFacetableOption：为属性设置动态分面选项。
• CatalogAttribute.searchableOption：为属性设置可搜索选项。
• CatalogAttribute.recommendationsFilteringOption（公开预览版）：为属性设置建议过滤选项。

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

更新多个属性

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

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

一个请求中允许的最大目录属性数量为 1000。

更新单个属性

以下方法用于更新各个目录属性：

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

  请参阅 AddCatalogAttribute 的 API 参考文档。

• ReplaceCatalogAttribute：修改单个属性配置。 此操作会通过更新具有相同 CatalogAttribute.key 的目录属性来替换 AttributesConfig 中的指定 CatalogAttribute。

  请参阅 ReplaceCatalogAttribute 的 API 参考文档。

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

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

  请参阅 RemoveCatalogAttribute 的 API 参考文档。

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

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

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

• Product.attributes.indexable。
• Product.attributes.searchable。仅适用于自定义属性。