AI Commerce Search 可利用产品特性进行索引编制、动态构面、搜索、过滤和模型质量评估。本页面介绍了如何设置商品属性配置，以及系统如何处理这些配置，具体取决于您使用的方法和配置。
属性类型
商品属性可以具有不同的默认设置和允许的选项，具体取决于其类型。
系统属性：预定义的系统属性是现有的
Product字段，可提供有关商品的更多信息。这些属性包括品牌、供应情况、颜色和尺寸等商品属性。如需查看产品的所有可用系统属性，请参阅Product参考文档。自定义属性：自定义属性是您使用
Product.attributes字段定义的额外属性。例如，这可能包括商店名称、供应商或风格。如需查看自定义属性的示例和限制，请参阅Product.attributes参考文档。以下是排名前 20 的自定义属性的一些示例：
- 相应商品所属的产品线
- 相应商品的实体店销量
- 服装的适用场合
- 适用于相应商品的特惠和优惠券
- 网站级商品热门程度
商品目录级属性：提供商品实体店级信息的系统属性或自定义属性。对于属性在不同商店和区域之间差异很大的商品（例如食品杂货）或有特定商店促销活动的商品，您可以使用商品目录级属性。
inventories.price和inventories.originalPrice是由 AI Commerce Search 预定义的数值系统属性。您可以创建自定义的商品级属性，这些属性可以是文本属性，也可以是数字属性。默认情况下，广告资源级属性可编入索引。不支持为商品目录级属性设置可搜索性和动态分面。
可用的属性设置
特性配置设置会影响您网站上的搜索和推荐行为。
| 配置 | 说明 | 系统属性 | 自定义属性 | 广告资源级属性 |
|---|---|---|---|---|
| 可搜索性 | 此特性可通过搜索查询进行搜索，从而提高此特性的召回率（仅限文本特性）。 | 始终开启（仅限文字） | 默认处于停用状态（可以启用；仅限文字） | 不支持 |
| 可编入索引性 | 搜索可以使用此属性进行过滤和构面。 | 始终开启 | 默认处于启用状态（可以停用） | 系统：始终开启 自定义：默认开启（可停用） |
| 动态商品详情 | Search 可以根据过去的用户行为（例如分面点击和视图）自动将此属性用作动态分面（仅限文本属性）。 | 默认处于启用状态（如果为 indexability = True）（可以停用）。 |
默认处于启用状态（如果为 indexability = True）（可以停用）。 |
不支持 |
| 可过滤 （预览版） |
此属性可用于 Recommendations AI 过滤表达式。此控件仅适用于文本属性。 | 默认处于停用状态（可针对文字启用；FulfillmentInfo 和 Title 除外） |
默认处于停用状态（可针对文本启用）。 | 仅支持 availability=IN_STOCK |
| 完全匹配 | 此属性仅适用于文本自定义属性。如需启用精确搜索，必须将 indexable 设置为 enabled。 | 不支持 | 默认处于停用状态（可以启用）。 | 不支持 |
搜索使用以下属性设置：
- 可编入索引：搜索可以使用此属性进行过滤和构面。
- 动态构面：Search 可以根据过去的用户行为（例如构面点击和视图）自动将此特性用作动态构面。如需为特性启用动态构面，必须将该属性的 Indexable 设置为 true。
- 可搜索：此特性可通过搜索查询搜索，从而提高此特性的召回率。此控件仅适用于文本特性。
- 可检索：如果设置为 true，则搜索会在对搜索查询的响应中返回此属性。如果所有属性的“可检索”都设置为 false，则搜索结果仅包含商品名称或（对于款式/规格）商品名称和颜色信息。REST 字段 RetrievableFields 已针对商品弃用。请改用可检索的网站级控制设置。
“推荐”功能使用以下属性设置：
- 可过滤（公开预览版）：此属性可用于建议过滤表达式。此控件仅适用于文本属性。
可编入索引
如果将特性设置为可编入索引，则搜索功能可以使用该特性进行过滤和构面。
- 系统属性：预定义的系统属性始终可编入索引。对于系统属性，无法停用此设置。
- 自定义属性：默认处于启用状态。您可以针对任何自定义属性停用可编入索引性。如果您计划使自定义属性可编入索引，则该属性必须遵循正则表达式模式
[a-zA-Z0-9][a-zA-Z0-9_]*。例如，key0LikeThis或KEY_1_LIKE_THIS。 - 商品目录级属性：始终为系统商品目录级属性启用；此设置无法更改。默认情况下，此设置针对自定义商品目录级属性处于启用状态；您可以将其关闭。
- 依赖项：不适用
导入目录数据后，索引配置更改会立即生效。否则，更改最长可能需要 12 小时或更长时间才能生效。您可以在评估页面上测试更改是否已应用。
动态构面
为特性启用动态构面后，搜索功能可以将该特性用作动态构面。可以根据之前的用户行为（例如构面点击和视图）自动将动态构面添加到搜索中。
- 系统属性：如果将可编入索引性设置为 true，则默认启用。您可以为任何系统特性停用动态分面。
- 自定义属性：如果可编入索引性设置为 true，则默认启用。您可以为任何自定义属性停用动态分面。
- 商品级属性：不支持。
- 依赖项：如需为特性启用动态构面，您必须先为该特性启用可编入索引功能。
为特性设置动态构面始终是全局性的。您应用于特性的动态构面配置可供使用该特性的目录中的产品使用。
动态构面配置更改最多需要两天时间。您可以在评估页面上测试更改是否已应用。
对于数值自定义属性，需要在请求中指定分桶。 数值不会自动分桶。
可搜索
如果将特性设置为可搜索，则该特性在搜索查询中的召回率会提高。
只有文本属性值才能启用可搜索性。不适用于数值特性。
- 系统属性：
Product的预定义文本系统属性的可搜索性设置由 AI Commerce Search 配置。这些设置无法更改。 - 自定义属性：默认处于停用状态。您可以为任何文本自定义属性启用此配置。
- 商品级属性：不支持。
- 依赖项：不适用
- 精确可搜索：针对与目录中任何指定商品匹配的搜索查询返回有针对性的搜索结果。此选项非常适合序列号。详细了解可进行精确搜索的选项。
虽然具有可搜索属性的商品更有可能显示在相应属性的搜索结果中，但并不能保证一定会显示。
过滤建议
虽然可以从变体汇总到主要商品以用于推荐的可过滤属性数量上限为 10 个，但如果某个属性启用了推荐过滤功能，则可以在推荐过滤表达式中使用该属性来过滤预测中的商品。
- 系统属性：默认处于关闭状态。您可以为
Product的任何预定义系统文本特性（FulfillmentInfo和title除外）开启此设置。不支持数值属性。 - 自定义属性：默认处于关闭状态。您可以为
Product的任何自定义文本属性启用此设置。不支持数值属性。 - 商品目录级属性：仅支持
availability值IN_STOCK。 - 依赖项：不适用
可进行精确搜索的选项
您可以为特定字符串查询的 exact-searchable 选项（目录属性字段）提供特定值。如果查询与商品目录中的任何商品匹配，且相应字段的值与查询中给定的字符串相同，则搜索查询会返回完全相同的商品。此选项非常适合序列号，因为客户希望获得有针对性的搜索体验。
通常，对于自定义属性，ExactSearchableOption 字段适用于具有确切值（例如 ModelId 或 ManufacturerId）的商品属性。product_id 等属性是主要索引字段，默认情况下可以进行精确搜索。对于完全匹配，item_id 字段始终处于启用状态，无法停用。
- 为避免在搜索中返回无关的商品，请勿将可搜索选项设置为
battery等通用值。 - 为避免搜索查询得不到充分处理，请勿将
tag等特殊字段（其字符串值之一可能是“iphone”）设置为精确可搜索。这样做可能会导致这些查询限制商品清单中所有 iPhone 的结果。
如需了解详情，请参阅商品属性简介。
属性配置最佳实践
这些最佳实践对于了解如何正确为自定义属性编制索引非常重要，同时还要注意某些可能会影响其可搜索性的语言解析机制。
- 处理字母数字（零件号或 SKU）：由于默认的语言分析会针对自然语言进行优化，因此可能会从零件号中剥离连字符 (
-) 等特殊字符（例如将part-123转换为part和123）。为了使这些内容可供搜索，您必须使用exact-searchable属性标志。 - n-gram 解决方法：对于包含特殊字符的高度复杂的型号，最佳实践是在提取之前，在您自己的数据流水线中将字符串拆分为 n-gram，并将原始字符串存储在标记为
exact searchable: true的自定义属性中。这会强制执行与 n-gram 片段的严格匹配。 - 自定义属性键限制：自定义属性键不得包含连字符或特殊字符。为了可编入索引，键必须严格匹配正则表达式模式
[a-zA-Z0-9][a-zA-Z0-9_]*。如需了解详情，请参阅商品属性简介页面。