商品属性简介

面向零售业的 Vertex AI Search 可以利用商品属性编制索引、 动态分面、可搜索性、过滤和模型质量。当前页面 讨论如何设置商品属性配置以及如何处理 具体取决于您使用的方法和配置。

属性类型

商品属性的默认设置和允许的选项可能会因其类型而异。

• 系统属性：预定义的系统属性是现有的 Product 字段提供相应商品的更多信息。这些国家/地区包括 品牌、库存状况、颜色和尺寸等商品属性。所有角色 商品的可用系统属性，请参阅 Product 参考文档。

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

• 广告资源级属性：提供 商品的商店一级的信息。对于在不同商店和地区之间具有明显不同属性的商品（例如日杂商品），或者具有针对特定商店的促销活动的商品，您可以使用商品目录级属性。

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

可用的配置设置

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

搜索使用以下属性设置：

• 可编入索引：搜索可以使用此属性进行过滤和构面。
• 动态分面：搜索可以自动使用此配置 属性用作动态分面，并且基于过去的用户行为（例如分面点击） 和观看次数如需为特性启用动态构面，必须将该属性的 Indexable 设置为 true。
• 可搜索：此属性可通过搜索查询搜索，从而提高此属性的召回率。此控件仅适用于文本特性。
• 可检索：如果设置为 true，搜索会返回此 属性。如果所有属性都具有 “可检索”设置为 false，搜索结果将仅包含商品名称 或（对于款式）商品名称和颜色信息。产品的 REST 字段 RetrievableFields 已弃用。请改用可检索的网站级控件。

Recommendations 使用以下属性设置：

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

可编入索引

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

• 系统属性：预定义的系统属性始终可编入索引。无法为系统属性停用此设置。
• 自定义属性：默认处于启用状态。您可以为任何自定义属性停用可编入索引功能。如果您打算将自定义属性设为可编入索引， 必须遵循正则表达式模式 [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 不支持在切换后退回到产品级配置模式。

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

配置方法

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

• Search for Retail 控制台：使用 Search for Retail 控制台在目录一级设置属性配置。此选项可在整个产品内 所有商品。哪些设置在控制台中可用取决于配置模式。

• AttributeConfig API 方法：设置属性配置 使用 API 创建清单级别这会配置所有商品的属性。

• Product API 方法（已废弃）：使用 Product API 方法在商品级别设置自定义属性。使用此项设置属性 方法既不适用于新用户， 建议。

在控制台中配置属性

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

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

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

使用 AttributesConfig 配置属性

借助 AttributesConfig API 资源，您可以管理 目录级别

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

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

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

更新多个属性

使用 updateAttributesConfig 方法进行更新 配置多个属性

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

一个请求中允许的清单属性数量上限为 1000。

更新单个属性

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

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

  请参阅 API 参考文档 AddCatalogAttribute。

• ReplaceCatalogAttribute：修改单个属性配置。 这会将 AttributesConfig 中指定的 CatalogAttribute 替换为 使用相同的 CatalogAttribute.key 更新清单属性。

  请参阅 API 参考文档 ReplaceCatalogAttribute。

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

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

  请参阅 API 参考文档 RemoveCatalogAttribute。

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

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

以下字段用于为特定网页指定可编入索引和可搜索的设置 通过 Product API 方法验证商品：

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