您可以将投放控件应用于投放配置，以自定义搜索处理搜索查询和返回结果的方式。投放控件是一种规则，由条件/操作对组成，其中条件决定了投放控件何时执行操作。操作用于指定服务控制执行的行为。
您可以使用 API Control.create 方法创建投放控制。
如果您不想使用 API，可以选择使用控制台在 Vertex AI Search for Commerce 中创建投放控制变量。
集成和配置最佳实践
本部分介绍了使用服务控制变量时的集成和配置最佳实践。
从不显示控件开始
开始使用 Vertex AI Search for Commerce，并尽可能减少或不使用服务控制。提升和掩埋等服务控制功能会干扰最初为提高搜索结果的收入和相关性而进行的排名优化。
如果出于非常强烈的业务需求，则应添加投放控制。例如，ABC.com 是一个在线时尚购物平台。他们有自有品牌 pqr 和 xyz，以及其他品牌。现在，ABC.com 可以选择提升自有品牌 pqr 和 xyz 的排名，也就是说，对于一些特定的搜索查询（例如女式上衣），将这些品牌的产品显示在搜索结果的顶部。此功能的业务用例可能是，ABC.com 的品牌为 pqr 和 xyz 的产品利润更高，这为干扰默认排名（即不使用加推）提供了正当理由。
另一个从最少控制项开始的原因是，后端 AI 模型会根据用户购买模式和趋势不断学习和调整（后端会根据 30-90 天窗口期内的事件进行训练）。这样一来，许多与同义词相关的应用场景便可迎刃而解。
总而言之，添加投放控制功能的决定应以一些强有力的收入指标或业务用例为依据。
特性配置
点击此处查看特性配置的前提条件。属性的目的是扩展商品信息结构并添加用户定义的商品属性。这些属性不应用于存储信息。此外，还可为使属性可搜索和可编入索引的属性设置 true/false 标志。将至少一个配置标志设置为 true。
完全匹配属性配置
完全匹配配置标志用于 model_name 或 part_number 等属性，这些属性往往是唯一的字母数字字符。例如，洗衣机型号的型号编号可能为 "WA2300AH3000"。在这种情况下，请将属性设置为 model_name，并将完全匹配的配置设置为 true，以便当搜索查询与 model_name 属性字符串匹配时，搜索结果中仅返回此商品。
需要注意的是，请勿在属性中使用常用字词或品牌，并将完全匹配设置为 true。当搜索查询中包含这些常用字词时，搜索结果会受到很大限制，导致常用搜索查询的商品召回率较低，并对点击率 / 转化率指标产生负面影响。
Vertex AI Search for commerce 仅提供排名服务
Vertex AI Search for Commerce 服务的价值主张是，它可用于根据查询相关性从目录中发现产品，并以可优化收入的方式对这些产品进行排名（同时提供提升/隐藏/过滤等辅助功能）。
从本质上讲，Vertex AI Search for Commerce 服务会返回一个经过收入和相关性优化的商品排名列表，以供向最终用户展示。Vertex AI Search for commerce 并非目录数据库的替代品。
如果需要，可以使用商品的 GET 和 LIST API 获取完整的商品信息，作为丰富层的一部分。
可用的投放控件
您可以使用以下投放控件：
- 提升/掩埋：影响返回结果列表中的结果排名和顺序。适用于搜索和推荐。
- 过滤条件：从返回结果列表中移除未传递过滤条件的结果。仅适用于搜索。
- 重定向：根据搜索查询将用户重定向到特定页面。仅适用于搜索。
- 置顶：为特定商品指定结果中的确切位置。
- 语言：自定义搜索查询语言。仅适用于搜索。您可以使用以下几种语言控件：
控件条件
控制条件决定了服务控制何时执行操作。
控件条件字段可以是查询字词和/或时间范围。某些控制变量类型允许使用多个条件字段，而有些则不允许使用任何条件字段。
可用的条件字段：
- 查询字词：当相应字词出现在搜索查询中时触发。
- 完全匹配要求整个搜索查询都与查询字词相匹配。
- 可以指定多个查询字词。触发条件之一，只要某个查询字词出现在搜索查询中即可。
- 有效时间范围：当搜索查询的日期在该时间范围内时触发。
- 可以指定多个时间范围。只要查询日期在时间范围（含）内，就会触发。
您指定的条件字段用于确定是否应用控件。
- 多条件字段使用 AND 进行组合。这意味着如果同时指定时间范围和查询字词，则需要触发两个条件字段才能应用控件措施。
- 多条件子字段使用 OR 进行组合。也就是说，如果您有多个查询字词，只要有任何一个查询字词匹配，都会触发该查询字词。如果您有多个时间范围，只要有一个时间范围匹配，就会触发相应控件。
- 未指定条件字段表示控件始终适用。但是，某些控件需要定义字段。
如需详细了解条件设置，请参阅 Controls.condition API 参考文档。
控件操作
控制操作指定了在搜索过程中满足条件时服务控制的行为。
您可以指定哪种操作取决于您创建的投放控制类型。例如，提升/掩埋控件的操作是将您指定的提升/掩埋值应用到您指定的过滤条件，而单向同义词控件则是应用相关术语。
提升/掩埋控件
借助提升/掩埋控件，您可以将某些搜索结果显示为排名更高或较低的排名。
您可以为搜索或推荐创建提升/掩埋控制。推荐的升降级功能目前为公开预览版。
创建提升/掩埋控制变量时，您可以使用过滤条件表达式根据 Product 字段指定条件。
然后，您可以应用一个介于 -1.0 到 1.0 之间的 boost 值，以指明匹配或打破这些条件的商品结果。正值会提升结果，负值会掩埋结果。
设置较高的提升强度可以提升商品规模，但不一定意味着提升商品始终会成为最佳结果。与搜索查询相关性更强的结果仍优先于大量但不相关的项目。同样，将增强强度设置为 -1.0 会使该项大幅下降，但可能仍然显示深度相关结果。
作为使用提升/掩埋的一个例子，您可以优先考虑较便宜的商品，并降低高价商品的优先级。
搜索和推荐提升/掩埋控件的控制条件有所不同：
- 搜索：您可以将查询字词和适用的时间范围设置为控制条件。
- 建议：控制条件不可用。相应控制措施始终适用。
作为控件操作，指定用于商品提升或掩埋的过滤条件，并设置提升/掩埋值。
如需创建提升/掩埋控件，请参阅创建新的投放控件。
如需详细了解提升/掩埋控制设置，请参阅 Controls.BoostAction API 参考文档。
过滤条件控件
借助过滤控件，您可以根据特定搜索请求动态添加预定义的过滤条件。
您可以根据 Product 字段使用过滤条件表达式。如需了解过滤条件表达式语法，请参阅过滤和排序结果。
您可以将查询字词和适用的时间范围设置为控制条件。作为控制操作，请指定要在查询时应用的过滤条件。
例如，对于查询蓝色鞋子，您可以使用过滤条件控件自动过滤蓝色的搜索结果。您还可以使用过滤控件来防止某些结果返回给买家。
如需创建过滤条件控件，请参阅创建新的投放控件。
如需详细了解过滤条件控制设置，请参阅 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包含{1、pid1}。带有pid1的商品会固定在最终结果中的首位。
置顶规则接受任何商品 ID（主要商品、款式/规格或合集），但对于任何具有非主要商品 ID 的商品，置顶效果都会减弱。
也就是说，如果您希望某个确切的变体或合集明显固定在界面顶部，请执行以下操作：
根据商品的父商品 ID 创建固定规则。
然后，您必须执行以下任一操作：
- 添加额外的加权规则，并使用加权条件（例如
id:ANY(123, 234)）对变体 ID 进行加权。 - 添加额外的过滤规则，以过滤掉感兴趣的确切款式/规格产品。
- 添加额外的加权规则，并使用加权条件（例如
启用固定和应用规则
启用固定控制功能后：
- 商品 ID 与插针匹配的商品会显示在最终响应中，且位置与控制变量指定的位置完全一致。
- 不允许将图钉固定到第二页或更后面的页面（页码更高），也就是说，系统会忽略任何设置为高于请求
page_size的位置的图钉。 - 一个控件最多可固定 10 个商品。
product_id必须是目录中现有商品的 ID。
除非出现以下情况，否则系统始终会在每次搜索中召回相应商品并将其显示在页面上：
- 已应用过滤条件和排序方式。这些设置会阻止图钉显示。
- 排序顺序（例如按价格对搜索结果进行排序）不是默认设置。
固定行为
- 如果某个商品被固定，系统会忽略来自请求或其他控件的任何提升或埋没。
- 如果商品固定到多个位置，则以最近更新的控件为准。
- 两个商品不能固定到同一固定控件（固定地图）内的同一位置。
- 如果多个控件与同一查询匹配，并且每个控件都针对同一商品 ID 具有不同的 Pin，则以最近更新的控件中的
[pin_pos, p_id]对为准。
- 如果多个控件与同一查询匹配，并且每个控件都针对同一商品 ID 具有不同的 Pin，则以最近更新的控件中的
语言控件
您可以创建默认设置或替换字词的处理方式，以用于某些查询。
同义词控件
将两个字词设置为同义词是一种关联这两个字词的语言控件。
同义词控件可为搜索查询添加更多上下文。它们不会强制将结果纳入搜索结果中，但可以帮助系统在搜索结果中纳入更多商品，从而提高特定结果被纳入的可能性。换句话说，同义词控制变量可以促使搜索结果考虑更多选项，但最终搜索结果取决于得分。
例如，如果您希望搜索跑鞋的结果也包含运动鞋，请创建语言同义词控制。条件是输入跑鞋作为搜索字词。相应操作是将同义词“运动鞋”纳入该搜索中。因此，当您网站上的买家搜索跑鞋时，搜索功能会查找与您创建的语言控制规则匹配的结果，并在向买家返回搜索结果时将搜索范围扩展为运动鞋。
如需创建同义词控件，请参阅创建新的投放控件。
双向同义词控件
使用双向同义词控件将多个字词关联起来，以便搜索在搜索过程中对它们使用相同的处理方式。
您可以将查询字词和适用的时间范围设置为控制条件。您无需设置单独的控件操作；如果您指定的术语用作查询，则控件操作会使用您指定为同义词的其他术语。
例如，您可以设置一个双向同义词控件，将“dish towel”和“kitchen towel”等术语与同义词相关联。当您网站上的买家输入厨房用毛巾作为查询时，搜索可以扩展查询以包含餐具用毛巾和厨房用毛巾的结果。
如需创建同义词控件，请参阅创建新的投放控件。
同义词不会更改原始查询。例如，如果查询 A 和 B 是双向同义词，则会产生以下效果：
返回的查询 A 结果：集合 A（未应用同义词规则）和集合 B 的部分内容。不过，结果可能小于 A 和 B 的组合。
返回查询 B 的结果：集合 B 和部分集合 A，但可能小于结果集 A 和 B 的总和。
如需详细了解双向同义词控制设置，请参阅 Controls.TwowaySynonymsAction API 参考文档。
单向同义词控件
单向同义词控件会扩展查询字词，以单向链接字词。
您可以将查询字词和适用的时间范围设置为控制条件。作为控制操作，请指定用作单向同义词的字词。
例如，您可以设置单向同义词控件，该控件扩展了搜索字词玫瑰以包含字词粉色。由于“pink”是单向同义词，因此在搜索时不包含“rose”一词。
如需创建单向同义词控件，请参阅创建新的投放控件。
请注意，与双向同义词一样，系统会执行原始查询，并提供同义词作为该查询的提示。完全不同的字词的同义词可能只会导致少量同义词出现在结果中。上例返回的是粉色商品，重点是粉色玫瑰，但如果同义词规则将搜索字词“dog”扩展为包含“cat”，则返回的商品大多是狗，还有一些是猫。
如需详细了解单向同义词控制设置，请参阅 Controls.OnewaySynonymsAction API 参考文档。
同义词不会提供相同的结果
两个同义词的搜索结果并不总是完全相同。
例如，如果您将 laptop bags 和 luggage 设置为双向同义词，系统可能已将 suitcase 与 luggage 相关联。因此，当用户搜索行李时，Vertex AI Search 商务解决方案会返回与行李、手提箱和笔记本电脑包相关的结果。不过，当您搜索 laptop bags 时，Vertex AI Search for Commerce 只会将 luggage 添加到同义词中。因此，结果可能不包含行李箱。
忽略控件
忽略控件可防止搜索在搜索期间使用某些查询字词。它们会将查询中被忽略的字词标记为不重要，但不会完全从查询中排除这些字词。
如需从查询中彻底移除某个搜索字词，请使用替换控制变量。虽然过滤控制功能会影响显示哪些结果，但替换控制功能是一种更强大的方法，可防止 Vertex AI Search for commerce 返回特定字词的结果。
忽略控制不能保证 Vertex AI Search 商务解决方案不会返回忽略的字词对应的结果。例如，即使设置了针对字词“oil”的忽略控制，对于“oil paints”的查询，系统仍可能会返回油漆。查询内容为 paints，可能会有许多匹配的油漆，但由于搜索的是 paints，因此结果集更大。如果油漆是您网站上热门的搜索查询，而您销售多种不同类型的油漆，但油基油漆的销量并不高，那么这种控制方式可能很有用。
您可以将查询字词和适用的时间范围设置为控制条件。您无需设置单独的控制操作；如果您指定的术语用作查询，则控制操作会忽略该术语。
例如，您可以创建一个控件，使其忽略使用令人反感的语言的查询字词。
如需创建忽略控件，请参阅创建新的投放控件。
如需详细了解忽略控制设置，请参阅 Controls.IgnoreAction API 参考文档。
不关联控件
不关联控件可防止某些搜索字词与其他指定字词相关联。这不一定会影响搜索结果，但可能会影响。
使用给定的查询字词和适用的时间范围作为控制条件。 作为控制操作，请指定不应与查询字词相关联的字词。
示例：您创建了一项控制措施，以防止品牌名称（例如 gShoe）在查询中与 cheap 和 poor quality 分组。买家搜索质量较差的便宜 gShoe。搜索会从初始查询中移除查询字词便宜和较差质量，最终的查询字词为 gShoe。不过，这并不能保证该网页会完全从搜索结果中移除。
如果相关查询字词还包含指定为“不关联”的字词，则系统可能仍会返回该相关结果。要完全避免这种情况，请使用过滤器控件。
如需创建不关联控件，请参阅创建新的投放控件。
如需详细了解不关联控件设置，请参阅 Controls.DoNotAssociateAction API 参考文档。
替换控件
替换控件将一个或多个给定查询字词替换为您指定的其他字词。您可以指定可映射到单个字词的多个字词（但反之则不然）。
您可以将查询字词和适用的时间范围设置为控制条件。作为控制操作，请指定应用作替换项的字词。
例如，您可以创建一项控制措施，用在商品描述中更常用的完整品牌名称替换品牌的昵称。
如需在 Search for Commerce 控制台中创建替换控件，请参阅创建新的投放控件。
如需详细了解替换控制设置，请参阅 Controls.ReplacementAction API 参考文档。