服务控件简介

您可以将投放控件应用于投放配置,以自定义搜索功能处理搜索查询和返回结果的方式。投放控制是一项规则,由条件/操作对组成,其中条件决定了投放控制的执行时间,操作指定了投放控制将采取的行为。

您可以使用 API Control.create 方法创建投放控制设置。

如果您不想使用 API,可以选择使用控制台在 Vertex AI Search for Commerce 中创建投放控制变量。

可用的投放控件

您可以使用以下投放控件:

  • 提升/掩埋:影响返回结果列表中的结果排名和顺序。适用于搜索和推荐。
  • 过滤条件:从返回结果列表中移除未传递过滤条件的结果。仅适用于搜索。
  • 重定向:根据搜索查询将用户重定向到特定页面。仅适用于搜索。
  • 置顶:为特定商品指定结果中的确切位置。
  • 语言:自定义搜索查询语言。仅适用于搜索。您可以使用以下几种语言控件:
    • 同义词:扩展搜索查询的搜索查询的同义词。
    • 单向同义词:针对特定术语扩展单向同义词。
    • 忽略:阻止搜索中使用某个术语。
    • 不关联:禁止系统在用户搜索特定字词时在搜索中使用这些字词。
    • 替换:替换搜索查询中的字词。

控件条件

控制条件决定了投放控制的执行时间。

控件条件字段可以是查询字词和/或时间范围。某些控制类型允许使用多个条件字段,而有些则不允许使用任何条件字段。

可用的条件字段:

  • 查询字词:当相应字词出现在搜索查询中时触发。
    • 完全匹配要求整个搜索查询都与查询字词相匹配。
    • 可以指定多个查询字词。触发条件之一,只要某个查询字词出现在搜索查询中即可。
  • 有效时间范围:当搜索查询的日期在该时间范围内时触发。
    • 可以指定多个时间范围。只要查询日期在时间范围(含)内,就会触发。

您指定的条件字段用于确定是否应用控件。

  • 多条件字段使用 AND 进行组合。这意味着如果同时指定时间范围和查询字词,则需要触发两个条件字段才能应用控件措施。
  • 多条件子字段使用 OR 进行组合。也就是说,如果您有多个查询字词,只要有任何一个查询字词匹配,都会触发该查询字词。如果您有多个时间范围,只要有一个时间范围匹配,就会触发相应控件。
  • 未指定条件字段表示控件始终适用。但是,某些控件需要定义字段。

如需详细了解条件设置,请参阅 Controls.condition API 参考文档

控件操作

控制操作指定了在搜索过程中满足条件时,投放控制将执行的行为。

您可以指定哪种操作取决于您创建的投放控制类型。例如,提升/掩埋控件的操作是将您指定的提升/掩埋值应用到您指定的过滤条件,而单向同义词控件则是应用相关术语。

提升/掩埋控件

借助提升/掩埋控件,您可以将某些搜索结果显示为排名更高或较低的排名。

您可以为搜索或推荐创建提升/掩埋控制。推荐的升降级功能目前为公开预览版。

创建提升/掩埋控制时,您可以使用过滤条件表达式根据 Product 字段指定条件。

  • 对于搜索过滤条件,请使用过滤和排序结果中记录的过滤条件表达式语法。
  • 对于建议过滤条件,请使用过滤建议中记录的过滤条件表达式语法。

然后,您可以应用一个介于 -1.0 到 1.0 之间的 boost 值,以指明匹配或打破这些条件的商品结果。正值会提升结果,负值会掩埋结果。

设置较高的提升强度可以提升商品规模,但不一定意味着提升商品始终会成为最佳结果。与搜索查询相关性更强的结果仍优先于大量但不相关的项目。同样,将增强强度设置为 -1.0 会使该项大幅下降,但可能仍然显示深度相关结果。

作为使用提升/掩埋的一个例子,您可以优先考虑较便宜的商品,并降低高价商品的优先级。

搜索和推荐提升/掩埋控件的控制条件有所不同:

  • 搜索:您可以将查询字词和适用的时间范围设置为控制条件。
  • 建议:控制条件不可用。此控制措施始终适用。

作为控件操作,指定用于商品提升或掩埋的过滤条件,并设置提升/掩埋值。

如需创建提升/掩埋控件,请参阅创建新的投放控件

如需详细了解提升/掩埋控制设置,请参阅 Controls.BoostAction API 参考文档

过滤条件控件

借助过滤控件,您可以根据特定搜索请求动态添加预定义的过滤条件。

您可以根据 Product 字段使用过滤条件表达式。如需了解过滤条件表达式语法,请参阅过滤和排序结果

您可以将查询字词和适用的时间范围设置为控制条件。作为控制操作,请指定要在查询时应用的过滤条件。

例如,对于查询 blue shoes,您可以使用过滤条件控件自动过滤蓝色的搜索结果。您还可以使用过滤控件来防止某些结果返回给买家。

如需创建过滤控件,请参阅创建新的投放控件

如需详细了解过滤条件控制设置,请参阅 Controls.FilterAction API 参考文档

重定向控件

您可以使用重定向控件根据买家的意图将他们重定向到不同的页面,而不仅仅是显示搜索结果。

您可以将查询字词和适用的时间范围设置为控制条件。作为控制操作,请指定在条件匹配时要重定向到的重定向 URI。

例如,您可以创建一个重定向控制,以便在商品 gShoe 推广期间,使用跑鞋运动鞋的查询会重定向到 gShoe 商品页面。使用重定向控制的另一种情况是,如果买家搜索的字词与您的网站无关,则将他们重定向到特定网页。例如,如果买家搜索 FAQ,则将他们重定向到您网站上实际的“常见问题解答”页面,而不是显示搜索结果。

如需创建重定向控件,请参阅创建新的投放控件

如需详细了解重定向控制设置,请参阅 Controls.RedirectAction API 参考文档

置顶控件

借助固定控件,您可以指定某个商品在结果中显示的精确位置。

您可以为搜索或浏览创建固定控件。建议不支持此功能。

创建置顶控制时,您可以使用过滤条件表达式根据 Product 字段指定条件。

作为控制操作,请向您的搜索或浏览 Condition 添加 Rule,这将是操作字段 pin_action.

然后,您可以应用一个介于 [1,120] 之间的 pin 值,以指明将匹配给定条件的搜索结果固定到的固定位置。

  • 规则条件:必须指定非空 [Condition.query_terms][](仅限搜索)或 [Condition.page_categories][](仅限浏览),但不能同时指定两者。
  • 操作输入:映射了 [pin_position, product_id] 对(输入位置可以是 1 到 120 之间的值)。最大大小是请求页面大小上限。10 是允许的针脚对数。
  • 操作结果:将具有匹配 ID 的商品固定到最终结果顺序中指定的位置。 举例来说,假设搜索查询为 鞋子[Condition.query_terms][]"shoes",而 pin_map 包含 {1pid1}。带有 pid1 的商品会固定在最终结果中的首位。

启用图钉和已应用的规则

启用固定控制功能后:

  • 商品 ID 与插针匹配的商品会显示在最终响应中,且位置与控制变量指定的位置完全一致。
  • 不允许将图钉固定到第二页或更后面的页面(页码更高),也就是说,系统会忽略任何设置为高于请求 page_size 的位置的图钉。
  • 一个控件最多可固定 10 个商品。
  • product_id 必须是目录中现有商品的 ID。

除非出现以下情况,否则系统始终会在每次搜索中召回相应商品并将其显示在页面上:

  • 已应用过滤条件和排序方式。这些设置会阻止图钉显示。
  • 排序顺序(例如按价格对搜索结果进行排序)不是默认设置。

固定行为

  • 如果某个商品被固定,系统将忽略来自请求或其他控件的任何加推或埋没
  • 如果商品固定到多个位置,则以最近更新的控件为准。
  • 两个商品不能固定到同一固定控件(固定地图)内的同一位置。
    • 如果多个控制变量与同一查询匹配,并且每个控制变量都具有同一商品 ID 的不同 pin,则以最近更新的控制变量中的 [pin_pos, p_id] 对为准。

语言控件

您可以创建默认设置或替换字词在特定搜索查询中的处理方式。

同义词控件

将两个字词设置为同义词是一种关联这两个字词的语言控件。

同义词控件可为搜索查询添加更多背景信息。它们不会强制将结果纳入搜索结果中,但可以帮助系统在搜索结果中纳入更多商品,从而提高特定结果被纳入的可能性。换句话说,同义词控制变量可以促使搜索结果考虑更多选项,但最终的搜索结果将取决于得分。

例如,如果您希望跑鞋的搜索结果也包含运动鞋,请创建语言同义词控制。条件是输入跑鞋作为搜索字词。相应操作是将同义词“运动鞋”纳入该搜索中。因此,当您网站上的买家搜索跑鞋时,搜索功能会查找与您创建的语言控制规则匹配的结果,并在向买家返回搜索结果时将搜索范围扩展为运动鞋

如需创建同义词控件,请参阅创建新的投放控件

双向同义词控件

使用双向同义词控件将多个字词关联起来,以便搜索在搜索过程中对它们使用相同的处理方式。

您可以将查询字词和适用的时间范围设置为控制条件。 您无需设置单独的控件操作;如果您指定的术语用作查询,则控件操作会使用您指定为同义词的其他术语。

例如,您可以设置一个双向同义词控件,将“dish towel”和“kitchen towel”等术语与同义词相关联。当您网站上的买家输入厨房用毛巾作为查询时,搜索功能可以扩展查询以包含餐具用毛巾厨房用毛巾的结果。

如需创建同义词控件,请参阅创建新的投放控件

同义词不会更改原始查询。例如,如果查询 A 和 B 是双向同义词,则会产生以下效果:

  • 返回的查询 A 结果:集合 A(未应用同义词规则)和集合 B 的部分内容。不过,结果可能小于 A 和 B 的组合。

  • 返回查询 B 的结果:集合 B 和部分集合 A,但可能小于结果集 A 和 B 的总和。

如需详细了解双向同义词控制设置,请参阅 Controls.TwowaySynonymsAction API 参考文档。

单向同义词控件

单向同义词控件会扩展查询字词,以单向链接字词。

您可以将查询字词和适用的时间范围设置为控制条件。作为控制操作,请指定用作单向同义词的字词。

例如,您可以设置单向同义词控件,该控件扩展了搜索字词 rose 以包含字词 pink。由于“pink”是单向同义词,因此在搜索时不包含“rose”一词。

如需创建单向同义词控件,请参阅创建新的投放控件

请注意,与双向同义词一样,系统会执行原始查询,并提供同义词作为该查询的提示。完全不同的字词的同义词可能只会导致少量同义词出现在结果中。上例返回的是粉色商品,重点是粉色玫瑰,但如果同义词规则将搜索字词“dog”扩展为包含“cat”,则返回的商品大多是狗,还有一些是猫。

如需详细了解单向同义词控制设置,请参阅 Controls.OnewaySynonymsAction API 参考文档

同义词不会提供完全相同的结果

两个同义词的搜索结果并不总是完全相同。

例如,如果您将 laptop bagsluggage 设置为双向同义词,系统可能已将 suitcaseluggage 相关联。因此,当用户搜索 luggage 时,Vertex AI Search 商务解决方案会返回与 luggagesuitcaselaptop bags 相关的结果。不过,当您搜索笔记本电脑包时,Vertex AI Search for Commerce 只会将行李添加到同义词中。因此,结果可能不包含 suitcase

忽略控件

忽略控件可防止搜索在搜索期间使用某些查询字词。它们会将查询中被忽略的字词标记为不重要,但不会完全从查询中排除这些字词。

如需从查询中完全移除某个搜索字词,请使用替换控制变量。虽然过滤控制功能会影响显示哪些结果,但替换控制功能是一种更强大的方法,可防止 Vertex AI Search 商务解决方案针对特定字词返回结果。

忽略控制不能保证 Vertex AI Search 商务解决方案不会返回忽略字词的搜索结果。例如,即使设置了针对字词“oil”的忽略控制,对于“oil paints”的查询,系统仍可能会返回油漆。系统会将该查询作为 paints 传递,可能会匹配到许多油漆,但由于搜索的是 paints,因此结果集会更大。如果油画颜料是您网站上热门的搜索查询,而您销售许多不同类型的颜料,但油性颜料的销量并不高,那么这种控制方式可能很有用。

您可以将查询字词和适用的时间范围设置为控制条件。 您无需设置单独的控制操作;如果您指定的字词用作查询,则控制操作会忽略该字词。

例如,您可以创建一个控件,使其忽略使用令人反感的语言的查询字词。

如需创建忽略控件,请参阅创建新的投放控件

如需详细了解忽略控制设置,请参阅 Controls.IgnoreAction API 参考文档

不关联控件

不关联控件可防止某些搜索字词与其他指定字词相关联。这不一定会影响搜索结果,但可能会影响。

使用给定的查询字词和适用的时间范围作为控制条件。作为控制操作,请指定不应与查询字词相关联的字词。

示例:您创建了一项控制措施,以防止品牌名称(例如 gShoe)在查询中与 cheappoor quality 分组。买家搜索质量较差的便宜 gShoe。搜索会从初始查询中移除查询字词便宜质量差,最终的查询字词为 gShoe。不过,这并不能保证该网页会完全从搜索结果中移除。

如果相关查询字词还包含指定为“不关联”的字词,则系统可能仍会返回该相关结果。要完全避免这种情况,请使用过滤器控件。

如需创建不关联控件,请参阅创建新的投放控件

如需详细了解不关联控件设置,请参阅 Controls.DoNotAssociateAction API 参考文档

替换控件

替换控件将一个或多个给定查询字词替换为您指定的其他字词。您可以指定可映射到单个字词的多个字词(但反之则不然)。

您可以将查询字词和适用的时间范围设置为控制条件。作为控制操作,请指定应用作替换项的字词。

例如,您可以创建一项控制措施,用在商品描述中更常用的完整品牌名称替换品牌的昵称。

如需在 Search for Commerce 控制台中创建替换控件,请参阅创建新的投放控件

如需详细了解替换控制设置,请参阅 Controls.ReplacementAction API 参考文档