提升效果

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

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

提升和过滤覆盖

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

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

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

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

提升规则

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

• 适用范围。提升功能无法覆盖库存状况规则。如果某商品被过滤掉（例如缺货），即使提高其权重，也不会显示该商品。

• 运算符。您可以在加权条件中对数值字段使用大于和小于等运算，而这些运算在标准严格过滤中不可用。

提升或掩埋值

一个商品可以受多个提升或埋没规则的制约，这些规则在 Search API 的 boostSpec 类中设置。提升值是介于 -1.0 和 1.0 之间的浮点数。

• 正值（0.0 到 1.0）：提升商品排名，使其在结果中显示在更靠前的位置。值为 1.0 时，升位效果最强。

• 负值（-1.0 到 0.0）：降权（隐藏）相应商品，使其在结果中的位置更低。值为 -1.0 时，降级幅度最大。

单个商品上的多个提升或埋没规则

多个提升或埋没规则可能会影响某个商品，最终得分由提升值的总和或最大值决定。当多个提升规则应用于同一商品时，请务必检查是否有其他商品的分数超过了该商品，导致该商品不再位于首位。将最大模式设置为默认值，以降低此问题的发生几率。

假设一种商品获得的提升系数为 2、3 和 0.5，另一种商品获得的提升系数为 0.5。虽然该商品的提升得分仅为 0.5，但当它被反复提升时，其排名会高于另一商品。仔细检查加推规范，确保它不会重叠，或者重叠是您有意为之。

冲突解决

如果多个提升规则适用于同一商品，您可以定义这些规则的互动方式。

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

• 增强效果总和（替代设置）：如果同时存在降级和升级，Vertex AI Search for Commerce 会将所有适用的增强规则和埋没规则的值相加。这样可以产生累积效应。最终的总和要么是降低的升幅，要么是净埋没效应。

配置强化

如需配置包含加权或降权规则的数据集，您可以根据商品属性（例如品牌或价格）定义条件，并分配一个介于 -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 with 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 Case"	["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 Case"	["Google", "Pixel"]	["Pixel > featured accessories"]	40.00

配置选项

在 Vertex AI Search for commerce 中，提升功能会以乘数形式应用于搜索算法生成的基本相关性得分。您可以使用提升规范直接在搜索请求中配置提升规则，也可以通过将投放控件附加到投放配置来配置提升规则。在响应中，符合这些条件的商品会获得修改后的相关性得分，从而在结果列表中显示在更高或更低的位置，但不会被完全移除。如需配置搜索结果提升或嵌入控件，请执行以下操作：

Cloud 控制台

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

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 的商品。配置控件时，请考虑以下因素：

• 控件类型：提升或掩埋

• 产品选择：建议

• Action：

  • 过滤表达式：ratingCount > 100

  • 提升价值：0.5

此控制功能可确保在推荐列表中优先显示热门且评价良好的商品，同时仍能保持与用户的相关性。

调试和问题排查

每件商品都可无限次提升，但用户应用的过滤条件会从搜索响应中排除商品。如需排查为什么加推商品可能不会显示在搜索和浏览结果中，请检查以下各项：

• 多条提升规则（包括埋没降级）：检查提升模式配置（总和或最大值），并确定最终得分。
• 相关性：商品必须与搜索查询相关，并且通过相关性过滤条件。如果搜索查询是“Nike 鞋”，而商品名为“Air Jordans”，这两个词并不匹配，但它们之间存在密切的语义关系，因此相关性得分很高。黄色夹克等商品名与 Nike 搜索查询的相关性得分较低。同样，如果商品名称是一个与任何字词都毫无关系的神秘型号，那么对于任何查询，相关性得分都会很低。
• 过滤条件：过滤规则会替换任何加推规则，并阻止加推商品显示在结果中。过滤条件始终在加推之上应用。如果商品应用了用户设置的过滤条件，或者商品类别设置了浏览过滤条件，则提升效果将完全失效。

教程：升位

本教程将展示一些商品升位示例。

---

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

操作演示

---