这是 Recommendations AI、Retail Search 和新的 Retail 控制台的文档。

服务控件

您可以将服务控件应用于服务配置,以自定义 Retail Search 如何处理搜索查询并返回结果。服务控件是由条件-操作对组成的规则,其中条件表示服务控件何时执行,该操作指定服务控件会执行的行为。

您可以在控制台中或使用 API Control.create 方法创建服务控件。

然后,您可以将新的服务控件附加到您创建的任何 Retail Search 服务配置中。传送时,系统仅会对请求的有效服务配置进行控制。

如需详细了解如何在控制台中创建服务控件,请参阅创建和管理控件

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

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

控件条件

控制条件用于指示执行服务控件的时间。

控件条件字段可以是查询字词和/或时间范围。您可以指定多个条件字段,具体取决于控件类型。

可用的条件字段如下:

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

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

  • 多条件字段使用 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 产品页面。

如需在控制台中创建重定向控件,请参阅创建新的服务控件

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

语言控件

您可以创建默认设置或替换字词的处理方式。

例如,如果您是商家,则可能需要将包含“运行鞋”一词的查询扩展为包含“运动鞋”,以使搜索结果同时包含这两个关键字。通过语言控制,您可以创建语言同义词控制,条件是输入“跑鞋”作为搜索字词,并且操作包括该搜索的同义词“运动鞋”。当您网站上的购物者输入“跑鞋”作为查询字词时,Retail Search 会查找与您创建的语言控件匹配的项,并将搜索扩展为包含“运动鞋”并将结果返回给购物者。

双向同义词控制

使用双向同义词控制可以将多个字词关联起来,这样 Retail Search 就可以在搜索期间处理这些字词。

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

例如,您可以设置一个双向同义词控件,将字词“餐巾”和“厨房毛巾”作为同义词进行关联。当您网站上的买家输入“kitchen towel”作为查询时,Retail Search 可以扩展查询以包含“dish towel”的结果,反之亦然。

如需在控制台中创建同义词控件,请参阅创建新的服务控件

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

单向同义词控件

单向同义词控件单向链接。

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

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

如需在控制台中创建单向同义词控件,请参阅创建新的服务控件

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

忽略控件

忽略控件可防止 Retail Search 在搜索期间使用某些查询字词。

忽略控件并不能保证 Retail Search 不会提供任何结果。要完全避免这种情况,请使用过滤器控件。

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

例如,您可以创建一个忽略冒犯性语言的查询字词的控件。

如需在控制台中创建忽略控件,请参阅创建新的服务控件

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

不关联控件

不关联控件可防止系统在查询您指定的其他字词时一起查询查询字词。

您可以设置查询条件和适用的时间范围作为控制条件,作为一项控制操作,指定不应与查询字词关联的字词。

例如,您可以创建一个控件,防止在查询中将品牌名称(例如“gShoe”)与字词“便宜”和“质量差”分组,这样一来,如果买家搜索了“便宜的便宜 gShoe”,零售商搜索就只会搜索“低价款”。

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

如需在控制台中创建不关联控件,请参阅创建新的服务控件

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

替换控件

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

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

例如,您可以创建一个控件,将品牌的昵称替换为在商品说明中更常用的完整品牌名称。

如需在控制台中创建替换控件,请参阅创建新的服务控件

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