提升效果

AI Commerce Search 提供了一项功能，可让您指定应在搜索中提升排名的记录。您可以通过应用提升规则来控制结果排名，从而确定返回的搜索项的优先级或降低其优先级。

借助提升功能，您可以根据自己定义的条件提升或降低特定项的排名，从而控制结果排名。与从结果集中移除项的过滤功能不同，提升功能会调整已符合返回条件的项的位置。

提升和过滤替换

注意： 过滤规则始终优先于提升规则。如需详细了解如何过滤和排序搜索结果，请参阅过滤和排序结果。

以下是一些常见的过滤条件类型示例，这些过滤条件优先于提升规则：

1. 用户指定 。这些可以是价格或品牌等内容。它们会以图块或分面的形式向最终用户显示在网站上。

• 主题性（相关性） 。这些过滤条件仅适用于搜索查询（不适用于浏览）。它们会从搜索结果中排除相关性较低的产品。例如，搜索“冰箱”不会返回微波炉或冰箱把手等配件。 过滤条件会识别出不应提升冰箱搜索结果中的微波炉。

提升规则

只有在存在基本相关性得分时，才能应用提升规则，例如在按相关性排序的搜索结果或具有预排序得分的浏览结果中。提升功能是一种应用于搜索和浏览结果的乘数函数。提升功能的语法和逻辑可以分解为：

• 适用范围 。提升功能无法替换适用范围规则。如果某项被过滤掉（例如缺货），提升该项也不会使其显示出来。

• 运算符 。您可以在提升条件中使用大于和小于等运算符来处理数值字段，这些运算符在标准严格过滤中不可用。

提升或掩埋值

一个产品可以受多个提升或掩埋规则的限制，这些规则在 boostSpec class of the Search API. 提升值是介于 -1.0 和 1.0 之间的浮点数。

• 正值（0.0 到 1.0）：提升项的排名，使其在结果中排名靠前。值为 1.0 时，提升效果最大。

• 负值（-1.0 到 0.0）：降低（掩埋）项的排名，使其在结果中排名靠后。值为 -1.0 时，降低效果最大。

单个产品的多个提升或掩埋规则

多个提升或掩埋规则可能会影响一个产品，提升值的总和或最大值决定了最终得分。当多个提升规则应用于同一产品时，请务必检查是否有其他产品的得分超过了该产品，使其无法占据榜首。系统默认设置为最大值模式，以减少此问题的发生。

假设一个产品获得了 2、3 和 0.5 的提升，而另一个产品获得了 0.5 的提升。虽然该产品仅获得了 0.5 的提升得分，但如果重复提升，其排名会高于另一个产品。请仔细检查提升规范，确保其没有重叠，或者确保其按预期重叠。

冲突解决

如果多个提升规则应用于同一产品，您可以定义它们之间的互动方式。

• 最大提升规则（默认） ：AI Commerce Search 会检查哪个值最大，并忽略其他规则。

• 提升效果总和（替代设置）：如果存在降低和提升，AI Commerce Search 会将所有适用的提升和掩埋规则的值相加。这样可以实现累积效应。所得总和要么是降低的提升效果，要么是净掩埋效果。

配置提升

如需使用提升或掩埋规则配置数据集，您可以根据产品属性（例如品牌或价格）定义条件，并分配介于 -1.0（掩埋） 和 1.0（提升） 之间的提升值，以调整匹配项的排名得分。以下产品可用于配置提升或掩埋控件：

• 搜索：主题性过滤条件以及用户应用的其他任何过滤条件，例如网站上的分面。详细了解如何为搜索配置提升。

• 浏览：由于没有文本查询，因此仅应用用户应用的过滤条件。过滤条件还用于检查产品（例如西装）是否属于正确的商品类别（例如不是毛衣）。详细了解如何为推荐内容配置提升。

示例数据集

查看示例产品数据集

id	title	brands	categories	price_info.price
"nest_mini_2nd_gen"	"Nest Mini (2nd gen)"	["Google", "Nest"]	["Nest > speakers and displays"]	49.00
"nest_audio"	"Nest Audio"	["Google", "Nest"]	["Nest > speakers and displays"]	99.99
"nest_hub_max"	"Nest Hub Max"	["Google", "Nest"]	["Nest > speakers and displays"]	229.00
"nest_hub"	"Nest Hub"	["Google", "Nest"]	["Nest > speakers and displays"]	88.99
"google_home_max"	"Google Home Max"	["Google", "Nest"]	["Nest > speakers and displays"]	299.00
"google_home_mini"	"Google Home Mini"	["Google", "Nest"]	["Nest > speakers and displays"]	49.00
"google_pixel_5"	"Google Pixel 5"	["Google", "Pixel"]	["Pixel > phones"]	699.00
"google_pixel_4a_with_5g"	Google Pixel 4a 5G 版	["Google", "Pixel"]	["Pixel > phones"]	499.00
"google_pixel_4a"	"Google Pixel 4a Phones"	["Google", "Pixel"]	["Pixel > phones"]	349.00
"google_pixel_stand"	"Google Pixel Stand"	["Google", "Pixel"]	["Pixel > featured accessories"]	79.00
"google_pixel_buds"	"Google Pixel Buds"	["Google", "Pixel"]	["Pixel > featured accessories"]	179.00
"google_pixel_5_case"	Google Pixel 5 保护壳	["Google", "Pixel"]	["Pixel > featured accessories"]	40.00
"google_pixel_4a_5g_case"	"Google Pixel 4a (5G) Case"	["Google", "Pixel"]	["Pixel > featured accessories"]	40.00
"google_pixel_4a_case"	Google Pixel 4a 保护壳	["Google", "Pixel"]	["Pixel > featured accessories"]	40.00

配置选项

在 AI Commerce Search 中，提升功能作为乘数应用于搜索算法生成的基本相关性得分。您可以使用提升规范直接在搜索请求中配置提升规则，也可以通过将服务控件附加到服务配置来配置提升规则。在响应中，符合这些条件的项会获得修改后的相关性得分，使其在结果列表中排名靠前或靠后，而不会被完全移除。如需配置搜索提升或掩埋控件，请执行以下操作：

Cloud 控制台

1. 在 Gemini Enterprise for Customer Experience 控制台的 AI Commerce Search 中，前往控件 页面。
   
   前往“控件”页面

2. 在投放控件 标签页下，点击控件右侧的修改 。

3. 在修改控件 弹出式窗口中，点击控件名称 字段下的字段以修改控件名称。

4. 可选：对于搜索，在触发器 部分中，选择哪种类型的用户行为会触发此控件。浏览类别 和搜索 部分会变暗。

5. 可选：修改匹配的搜索字词 。

   **注意**： 如果您指定了类别或查询字词条件以及时间 范围条件，则只有在同时满足这两个条件时，控件才会 应用。

6. 可选：点击添加时间范围 选项，添加一个或多个可以应用此控件的时间范围。

   **注意**： 如果您除了指定此类 条件之外还指定了时间范围条件，则只有在同时满足这两个条件时，控件才会应用。

7. 点击继续 ，前往操作 部分。

8. 在提升/掩埋商品 字段中，为产品属性添加过滤条件。

   使用过滤和 排序结果中记录的过滤表达式语法。例如，如需要指定“product1”和“product2”的红色和蓝色版本，请使用以下语法： (id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))

9. 对于提升/掩埋值，使用滑块设置 提升强度。正值会增强结果，负值会掩埋结果。点击继续 。

10. 在服务配置 部分中，选择要应用控件的服务配置。

11. 提交控件设置。

现在，您可以在项目的投放控件 下找到添加的提升或掩埋控件规则，该规则会作为新的控件类型 列出。了解如何在创建控件下创建新的提升和掩埋控件。

JSON

这演示了按价格提升的示例。

假设您要优先考虑价格较低的商品（小于 95 美元），降低价格较高商品（超过 95 美元）的优先级，则可以应用提升规范。

{
  "condition_boost_specs": [
    {
      "condition": "price: IN(*, 95.0e)",
      "boost": 0.5
    },
    {
      "condition": "price: IN(95.0e, *)",
      "boost": -0.5
    }
  ]
}

在此示例中，价格低于 95 美元的商品会获得提升 (0.5)，而价格高于 95 美元的商品则会被降低 (-0.5)。

在结果中，"nest_mini_2nd_gen"、"google_home_mini" 和 "nest_hub" 可能是 前三个，而 "nest_audio"、"nest_hub_max" 和 "google_home_max" 可能是 后三个。但是，与 过滤和排序结果中所述的按价格排序不同，系统不会预先确定特定顺序。

搜索提升

对于搜索，请通过在 SearchRequest 中直接添加包含 condition_boost_specs 的提升规范 (boostSpec)，动态应用匹配项的排名得分。

条件和触发器

搜索提升可以是有条件的。您可以根据以下条件触发提升规则：

• 查询字词：仅当用户搜索特定字词时才应用提升（例如，当查询包含“夹克”时，提升冬装）。

• 时间范围：仅在特定促销期间应用提升。

• 全局：将提升应用于由特定配置处理的所有查询。

搜索请求和响应示例

在前面显示的示例数据集中，如果您搜索“Google speaker”，那么您会收到 “nest_mini_2nd_gen”、“nest_audio”、“nest_hub_max”、“nest_hub”、“google_home_max” 和“google_home_mini”，无序排列。

查看搜索请求和响应示例

Java

import com.google.cloud.retail.v2.SearchRequest;
import com.google.cloud.retail.v2.SearchRequest.BoostSpec;
import com.google.cloud.retail.v2.SearchRequest.BoostSpec.ConditionBoostSpec;
import com.google.cloud.retail.v2.SearchResponse;
import com.google.cloud.retail.v2.SearchServiceClient;

public static void searchProductsWithBoostSpec(String query, int pageSize,
    String condition, float boostStrength) throws IOException, InterruptedException {
  BoostSpec boostSpec = BoostSpec.newBuilder()
      .addConditionBoostSpecs(ConditionBoostSpec.newBuilder()
          .setCondition(condition)
          .setBoost(boostStrength)
          .build())
      .build();

  SearchRequest searchRequest = SearchRequest.newBuilder()
      .setPlacement(DEFAULT_SEARCH_PLACEMENT_NAME)
      .setBranch(DEFAULT_BRANCH_NAME)
      .setVisitorId(VISITOR_ID)
      .setQuery(query)
      .setPageSize(pageSize)
      .setBoostSpec(boostSpec)
      .build();

  try (SearchServiceClient searchClient = SearchServiceClient.create()) {
    SearchResponse response = searchClient.search(searchRequest).getPage().getResponse();
    System.out.println("Search response: " + searchResponse);
  }
}

推荐内容提升

推荐内容提升使用服务控件进行管理。与搜索不同，推荐内容提升不支持基于查询的条件（因为没有用户查询）。相反，控件适用于其所附加的服务配置生成的所有预测。因此，您通常通过将提升或掩埋服务控件附加到服务配置来配置推荐内容，而不是在请求中传递提升规范。

推荐内容支持的字段

在定义要在推荐内容中提升哪些产品时，请使用过滤表达式。虽然标准推荐内容过滤仅限于文本字段，但提升支持其他数值字段。

字段类型	支持的字段	说明
文本	productId、brands、categories、genders、ageGroups、colorFamilies、colors、sizes、title、materials、patterns、conditions、attributes.key、 tags	可用于过滤和提升的标准字段。请注意，tags 是与产品关联的自定义标记。
数值	price、discount、rating、ratingCount	仅适用于提升/掩埋 。借助这些字段，您可以根据价格、折扣或用户评分来提升产品。

如需了解详情，请参阅提升/掩埋支持的字段部分，具体请参阅过滤推荐内容。

提升评分较高的产品

假设您想确保评分较高的电影在“您可能还喜欢”推荐面板中排名靠前。对于此用例，请创建一个服务控件，以提升评分数大于 100 的项。配置控件时，请考虑以下因素：

• 控件类型：提升或掩埋

• 产品选择：推荐内容

• 操作：

  • 过滤表达式: ratingCount > 100

  • 提升值: 0.5

此控件可确保在推荐列表中优先考虑热门且评分较高的项，同时仍保持用户个性化相关性。

调试和问题排查

每个产品都有资格获得无限提升，但用户应用的过滤条件会从搜索响应中排除产品。如需排查提升的产品可能未显示在搜索和浏览结果中的原因，请检查以下内容：

• 多个提升规则（包括掩埋降级）：检查提升模式配置（总和或最大值），并确定最终得分。
• 相关性：产品必须与查询相关，并且通过相关性过滤条件。如果搜索查询是“耐克鞋”，而产品标题是“Air Jordans”，则字词不匹配，但它们之间紧密的语义关系会带来较高的相关性得分。 “黄色夹克”等产品标题与耐克搜索查询的相关性得分较低。 同样，如果产品标题是一个与任何字词都没有关系的神秘型号，则对于任何查询，相关性得分都会较低。
• 过滤条件：过滤规则会替换任何提升规则，并阻止提升的产品显示在结果中。过滤条件始终应用于提升之上。如果产品具有用户应用的过滤条件，或者商品类别过滤条件用于浏览，则提升将完全不起作用。

教程：提升

本教程向您展示了一些产品提升示例。

---

如需遵循有关此任务的分步指导，请直接在 Cloud Shell Editor 中点击 操作演示:

操作演示

---