可供搜索的商品详情

本页面介绍了一些商品详情功能及其使用方法。

本部分介绍了与“面向”相关的一些基本术语的定义和说明：

  • 构面：用于执行分面搜索的构面规范。它们可帮助用户过滤搜索结果，找到所需内容。例如，如果 用户搜索“shoes”，可能会返回的一些商品详情有：price， attributes.department、attributes.colors 和 attributes.size。

  • 系统属性：预定义的系统属性是现有的商品字段，用于提供有关商品的更多信息。其中包括一些预定义的商品属性，例如 brand、availability、color 和 size。

  • 自定义属性：自定义属性 您使用 Product.attributes 字段定义的额外属性。例如，这可能包括 style、color 或 department。

  • 构面键：这是构面的名称。例如，它可以是 attributes.department 或 sizes。构面键对应于 属性名称中。例如，（商品）系统属性名称 sizes 对应于构面键 sizes。同样，（产品）自定义属性 名称 department 对应于构面键 attributes.department（ 自定义属性，则系统会向自定义属性添加前缀 attributes. 名称以获取分面键）。字词属性名称、商品详情键和 分面名称可以互换。

  • 面向的值：对于文本键，这是面向的某个文本值。例如，文本分面键 brands 可以具有这样的文本值 为Asics和Nike。对于数值键，构面值是一个范围。修改者 例如，数字分面键价格的间隔形式为 [20, 30）。

  • 属性或细分类型：可以是文本类型，也可以是数值类型。

  • 固定的细分条件：这是您使用 FacetSpec 和选项 enableDynamicPosition=false 在请求中传递的细分条件。商品详情 在响应中的所有动态分面之前，会按其原始顺序显示。

  • 动态分面：这些分面搜索依据， 一面。它们要么随请求一起传递 enableDynamicPosition=true 也可以根据搜索模型提取。然后对它们进行排名 训练好的模型，相关性最高的模型位于顶部。

  • 可构建构面、可使用动态构面或可平铺：为属性启用动态构面后，搜索功能可根据过去的用户行为（例如构面点击和视图）自动将此属性用作动态构面。要启用动态模式，请执行以下操作： 必须为属性启用分面，还必须为以下对象启用索引： 该属性。

  • 过滤条件：过滤条件语法由一种表达式语言组成，用于从要过滤的商品的一个或多个字段构造谓词。例如，如果用户与分面键 attributes.brands 的分面值 Asics 互动，则过滤条件的一部分可能是 (attributes.brands:ANY(\"Asics",\"Nike\"))。过滤条件表达式区分大小写。如需详细了解此过滤器，请参阅此用户指南。

动态分面和图块简介

为提取配置启用动态构面后，搜索功能可根据过去的用户行为（例如构面点击和视图）自动将属性用作此配置的搜索结果中的动态构面和功能块。您可以在请求中传递动态详情 enableDynamicPosition=true 也可以根据搜索模型提取。然后对它们进行排名 将最相关的模型放在顶部。

默认情况下，大多数分面键都是可分面的。API 中的动态分面设置 可以在整个网站范围内为您选择的某些特定构面键覆盖 属性控件。换句话说，如果您希望某些切面键不可切面化，则需要在 Attribute controls 标签页中为这些键停用动态切面化。如需了解详情，请参阅管理网站级属性控件。

请注意，动态细分和功能块可以根据准确的商品目录数据创建。不过，要使该功能以适合您网站的最佳方式运行，构面模型需要学习您网站上的活动。为此，您需要准确设置搜索事件上传中的查询、类别和过滤字段。

如果服务配置均未启用动态分面和功能块，而您刚刚启用了动态分面和功能块 服务配置中的动态分面和功能块预计要等待三到四天才能生效。

商品详情控件

本部分介绍了如何创建不同类型的细分控件，其中许多控件还会控制功能块行为：

Vertex AI Search for Retail 会针对所有这些分面执行区分大小写的匹配 （除非另有说明）。

如需控制特定分面值和图块行为，请前往 Search for Retail 控制台中的商品详情控件标签页。

转到“控件”页面

点击创建控件，以修改从搜索返回的分面。系统随即会打开创建控件窗格。点击控件类型字段，打开下拉菜单，然后从中选择控件类型。每个选项都会打开一个对话框，其中包含用于控制多个维度的选项。所有分面控件类型都至少需要属性信息，但每种表单所需的信息略有不同。

替代文本

创建忽略分面和图块值控件

如果您想移除某些特定分面键和图块键的一些不需要的分面值和图块值，请创建“忽略分面和图块值”控件。

此控件对于清除不需要的分面和图块值（例如 NA 和 Not_applicable。但也可用于清除季节性趋势 Easter（如果你是 10 月的话）。

如需创建会忽略分面和图块值的控件，请执行以下操作：

  1. 前往 Search for Retail 控制台中的“控件”页面。

    转到“控件”页面

  2. 在细分属性控件标签页上，点击 创建控件。

    系统随即会打开创建控件窗格。

  3. 选择忽略分面和图块值。

  4. 指定属性名称。

    例如，brands 表示系统属性。对于自定义属性，名称以 attributes. 开头，即 例如 attributes.department 和 attributes.colors。

  5. 可选：指定开始时间和/或结束时间。

  6. 将一个或多个属性值指定为忽略的值。

    例如： NA、Not_applicable和Easter。

  7. 点击提交。

创建替换分面和图块值控件

如果您想将多个类似的分面和图块值合并为一个术语，请创建“替换分面和图块值”控件。

替换分面和图块值有时也称为合并分面和图块值。

为避免出现冲突和无用的映射，如果属性值 facet_value_1 被替换为另一个属性值 facet_value_2，则后者不能再被替换为其他属性值。例如，如果您将 ruby 替换为 dark red，则无法随后将 dark red 替换为 red。

对于每个属性名称，一个属性值在 替换值字段中的“替换值”。

如需创建用于替换分面和值的控件，请执行以下操作：

  1. 前往 Search for Retail 控制台中的“控件”页面。

    转到“控件”页面

  2. 在细分属性控件标签页上，点击 创建控件。

    系统随即会打开创建控件窗格。

  3. 选择替换分面和图块值。

  4. 指定属性名称。

    此功能仅适用于以 attributes 开头的自定义属性，例如 attributes.department 和 attributes.colors。

  5. 在“替换值”中指定一个或多个属性值，例如 RED、Red、dark red、bright red、ruby 和 crimson。

    属性值只能在替换值字段中出现一次。

  6. 指定一个属性值作为替换字词，例如 red。

  7. 点击提交。

虽然被替换的值可能会很快消失， 字词最多可能需要四天才会显示。

替换分面值控件生效后，如果响应中返回了分面键（在此示例中为 attributes.colors），则替换的分面值（例如 dark red 和 crimson）不会作为分面值显示。它们会被替换项（例如 red）替换。

创建一个合并分面控件

最好在以下位置正确设置商品自定义属性名称和值： 在将产品提取到 Google 搜索的 数据库。不过，如果您无法更改自定义属性名称，则可以创建 合并分面控件。如果需要，您可以创建一个合并分面控件， 将分面与另一个分面合并（替换）。例如，您可能有多个颜色自定义细分键，例如 attributes.colors_jeans、attributes.colors_clothes 和 attributes.colors_hue，并且您希望将它们替换为名为 attributes.colors 的现有自定义细分键。

最好是，合并的键应满足以下条件：

  • 自定义属性名称是永久性的，且不会更改类型。
  • 提取的许多商品的属性名称。

如果您删除已合并的键，则会丢失其互动数据，这些数据用于训练动态细分模型。

为每件商品编制索引时，系统会将键和合并的键都作为属性名称包含在内，除非您超出了每件商品允许的属性数量上限。如果属性数量上限超出每个商品允许的配额，搜索会任意截断要用作属性名称的合并键。

例如，如果某个特定商品的自定义属性名称数量已达到上限 并且有一个自定义属性名称是 colors_jeans，假设您 使用合并分面控件将 attributes.colors_jeans 合并到 attributes.colors。在此示例中，属性名称 colors 不会添加到 因为每个产品包含的自定义键数量已达上限 产品。合并后的键不会从以下对象的（自定义）属性名称中删除： 但它们也不会作为动态分面键返回。同样，如果 合并具有相同键的多个键，这会导致 合并键的属性值超出了属性值限制 允许时，搜索任意截断属性值。

要创建将分面合并到另一个分面的控件，请执行以下操作：

  1. 前往 Search for Retail 控制台中的“控件”页面。

    转到“控件”页面

  2. 在细分属性控件标签页上，点击 创建控件。

    系统会打开创建控件窗格。

  3. 选择合并分面。

  4. 请指定要与另一个属性合并的有效自定义分面键。

    此功能仅适用于以 attributes 开头的自定义属性，例如 attributes.colors_clothes 和 attributes.colors_jeans。

  5. 请指定有效的自定义分面键作为合并的键。

  6. 点击提交。

此控制选项通常会在 2-4 天内生效。

创建一组数字间隔控件

借助“设置数值间隔”控件，您可以确定数值细分或图块的间隔，而无需接受计算得出的间隔。

例如，搜索引擎可能会为自定义数字细分键 attributes.monitor_size 计算 [10,15)、[15,20)、[20,25)、[25,30)、[30,40)、[40,50) 和 [50,infinity) 这些间隔。不过，您可能希望 间隔 [0,14)、[14,17)、[17,21)、[21,24)、[24,27)、[27,32] 和 [32,无穷大） 。

关于计算区间和设置区间

对于所有数值自定义属性和数值系统属性 price， rating 和 ratingCount，搜索会计算一些区间 并具有基于所有（数值）属性的分布情况的圆角边界 每个属性的值您还可以在请求中指定一些间隔时间。最后一种方式是 分面键 设置数字间隔控件。

以下是用于确定使用哪些间隔的优先级顺序：

  • 首先，如果在请求数字分面时指定了某些区间 键，这些间隔都会保持不变。

  • 否则，如果数值分面键是动态的，或者在请求中传递时不包含间隔，那么如果您使用设置数值间隔控件添加的间隔不为空，系统会将这些间隔添加到该数值分面键。

  • 否则，系统会添加前面提到的具有四舍五入边界的计算间隔。

创建控件

如果您想为数字分面和图块键（而非 然后创建一个 设置数字间隔控件

如需创建用于添加间隔时间的控件，请执行以下操作：

  1. 前往 Search for Retail 控制台中的“控件”页面。

    转到“控件”页面

  2. 在方面控件标签页上，点击 创建控件。

    系统随即会打开创建控件窗格。

  3. 选择设置数字面片和图块间隔。

  4. 指定数字属性的名称。

    例如，price 表示系统 属性。对于自定义属性，名称以 attributes. 开头，如 示例：attributes.number_of_pieces。

  5. 请至少指定 Minimum 或 Maximum 中的一项。如果两者都指定了， 最小值不能大于最大值。您可以选择每个边界 包含或独占。

  6. 如需添加更多间隔，请点击 添加间隔。最大数量 间隔为 40。

  7. 点击提交。

创建用于移除分面和图块的控件

借助“移除分面”控件，您可以从动态分面中移除特定分面和图块键。系统会根据一些给定的查询字词或网页类别移除分面键和图块键。

此商品详情控件类型可控制属性本身。如果应用此分面控件类型，搜索结果中将不会返回与此分面相关联的任何分面或图块。

如果您想为某些查询移除一些分面键和图块键，此控件非常有用 字词或浏览。例如，您可以使用此控件移除查询“鞋子”的细分键 attributes.shoe_size。

要创建用于移除分面或图块的控件，请执行以下操作：

  1. 前往 Search for Retail 控制台中的“控件”页面。

    转到“控件”页面

  2. 在细分条件控件标签页上，点击 创建控件。系统随即会打开创建控件窗格。

  3. 选择移除分面和图块。

  4. 每种控制项只能用于搜索或浏览，不能同时用于这两者。执行以下任一操作：

    • 对于搜索查询，点击搜索并指定部分查询 要匹配的查询字词或某些完全匹配的查询字词。查看详细信息 请参阅查询字词中的信息 条件。无论是哪种情况，查询字词都需要采用小写形式。例如，您可以指定部分查询字词 shirts、polo、jackets、t-shirt、fall coats和 如果存在以下情况，则接下来指定的分面键不会 小写查询是这些查询字词之一或包含以下任一查询字词 查询字词表示为一元语法。

    • 对于浏览，请点击浏览类别，然后指定一些网页类别。您可以指定类别列表（最多 10 个条目）或 部门。格式应与用户事件网页类别相同。对于 例如，可能是 page_categories：Sales > 2023 Black Friday Deals。如果有 网页与后一个网页之间的内容完全匹配（区分大小写） 事件中传递的类别（针对浏览），然后使用分面键 不会显示为动态分面。

  5. 在要忽略的属性中，至少指定一个有效的分面键。

  6. 点击提交。

创建强制返回分面控件

“强制返回分面”控件可能会影响动态分面的列表位置 键。

如果您想在 动态分面。例如，您可以使用 用于强制分面键 brands 显示在位置 10 或更小的位置上的控件 handbags 这一查询的指定排名。如果分面 brands 已在顶部 10 表示此查询的动态分面，则它不应出现太大变化。如果它不在前 10 名或动态细分列表中，则应该会大致位于第 10 位。

如需为强制返回商品详情创建控件，请执行以下操作：

  1. 前往 Search for Retail 控制台中的“控件”页面。

    转到“控件”页面

  2. 在细分属性控件标签页上，点击 创建控件。

    系统随即会打开创建控件窗格。

  3. 选择强制返回分面。

  4. 每种控制项只能用于搜索或浏览，不能同时用于这两者。执行以下任一操作：

    • 对于搜索查询，点击搜索并指定部分查询 要匹配的查询字词或某些完全匹配的查询字词。查看详细信息 请参阅查询字词中的信息 条件。无论是哪种情况，查询字词都需要采用小写形式。例如，您可以指定部分查询字词 shirts、polo、jackets、t-shirt、fall coats和 接下来指定的分面键应显示在其各自的 如果小写查询是 或包含任意一个查询字词 一元语法。

    • 对于“浏览”，请点击浏览类别并指定某个网页 类别。您可以指定类别列表（最多 10 个条目）或 部门。格式应与用户事件网页类别相同。对于 例如，可能是 page_categories：Sales > 2023 Black Friday Deals。如果后者与事件中传递的某个网页类别（适用于浏览）完全匹配（区分大小写），那么接下来指定的细分键应显示在动态细分中相应位置附近或更高的位置。

  5. 请指定有效的分面键以及介于 1 到 100 之间的整数位置 （含边界值）。

  6. 如果您要指定多个构面键，请点击 添加调整项，然后重新执行上一步。

  7. 点击提交。

创建重新排序动态分面控件

动态细分排名取决于查询（搜索）或网页类别（浏览）。重新排序动态分面控件还允许排名取决于 用户互动的一些分面值

例如，使用此控件时，如果 用户与分面键 attributes.department 的分面值 watches 互动 之后，排名还取决于 值 watches。您可以按维度键指定要按哪些维度值重新排名，也可以仅指定维度键，系统会根据其所有维度值重新排名。

如需为动态分面重新排序创建控件，请执行以下操作：

  1. 前往 Search for Retail 控制台中的“控件”页面。

    转到“控件”页面

  2. 在方面控件标签页上，点击 创建控件。

    系统随即会打开创建控件窗格。

  3. 选择对动态分面重新排序。

  4. 请指定有效的自定义文本分面键（所有自定义键的前缀均为 attributes.）。

  5. 您可以指定一些特定的面向属性值，也可以应用于所有面向属性值。

    • 如果您想根据其所有细分值重新排名，请点击 任何值更改。

    • 如果您想根据特定细分值重新排名，请点击 所选值更改。然后，插入您要对其重新排序的所有分面值 （区分大小写）。例如，可以是 watches、luggages、 bed。

  6. 点击提交。

您需要传递用户在请求中互动的所有分面键 原因如下：

  • 假设用户浏览促销活动，并看到第一个显示的面键列表。
  • 然后，用户首先与分面键互动 attributes.age_group。
  • 接下来，他们按下商品详情键 attributes.department 分面值 watches，您可以为其设置要重新排序的控件。

届时，搜索会对键进行重新排序。

因此，响应中可能不会返回之前启用的细分键 attributes.age_group。如果您在请求中传递此键（使用 Facetspec， enableDynamicPosition 已设置为 true)， 它会自动在响应中返回

不过，搜索功能可能会返回位于第 27 个位置的该按键，而您可能只向用户显示前 20 个按键。因此，请确保用户之前互动过的这些键 向用户显示的信息如果您不想向用户显示过多按键，则可能需要在响应中滤除一些未参与互动的中间按键。