商品属性简介

Vertex AI Search 零售解决方案可利用产品属性进行编入索引、动态构面、可搜索性、过滤和模型质量。本页介绍了如何设置商品属性配置，以及 Google 如何处理这些配置，具体取决于您使用的方法和配置。

属性类型

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

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

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

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

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

可用的配置设置

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

搜索广告系列使用以下属性设置：

  • 可编入索引：搜索可以使用此属性进行过滤和构面。
  • 动态构面：搜索网络可以根据过去的用户行为（例如构面点击和视图）自动将此属性用作动态构面。如需为特性启用动态构面，必须将该属性的 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 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 资源，您可以在目录级管理属性配置。

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

如需检索所有属性配置，请使用 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 方法为特定商品设置可编入索引和可搜索的设置：