Vertex AI Search for Retail 将重命名为 Vertex AI Search for Commerce。我们正在更新内容，以反映新品牌。

此页面由 Cloud Translation API 翻译。

创建投放控件

本页面介绍如何创建投放控制变量。

投放控件是您定义并应用到各个投放配置的规则。

您可以在 Search for Commerce 控制台中创建投放控件，其中包含触发控件的条件和条件触发时执行的操作。然后，您可以将新的投放控件附加到投放配置。

服务控制与配置之间的关系

投放配置与控件之间存在多对多关系。您可以向投放配置添加多个控件，一个控件可以与多个投放配置相关联。

创建投放控件和投放配置时，您需要选择控件可用于的产品（推荐或搜索）。

投放控制只能与相同商品类型的投放配置相关联。例如，为推荐内容创建的投放控制变量无法与为搜索内容创建的投放配置相关联。

投放配置用于管理在搜索或预测请求期间应用哪些控件。在投放时，系统只会考虑请求的有效投放配置中的控制设置。例如，假设您创建了两个控制：一个名为 gShoe Sale 的控制，用于在搜索 shoes 时提升 gShoe 品牌的结果；另一个名为 More shoes 的控制，用于将使用 running shoes 一词的查询扩展为包含 sport shoes。如果您仅将 gShoe Sale 控制变量附加到投放配置，那么使用该投放配置的搜索请求会针对使用“鞋”一词的查询提升 gShoe 结果，但 More shoes 控制变量不会产生任何效果，因为它未附加到您使用的投放配置。

如需了解详情，请参阅关于投放配置。

快速入门视频和指南

投放控件简介：借助投放控件，您可以创建规则，从而自定义您的投放配置返回搜索结果的方式。
提升/掩埋：影响返回结果列表中的结果排名和顺序。可用于搜索和推荐。
过滤条件：从返回结果列表中移除未传递过滤条件的结果。仅适用于搜索。
重定向：根据搜索查询将用户重定向到特定页面。仅适用于搜索。

本教程介绍了如何使用重定向控制。

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

操作演示

语言：自定义搜索查询语言。仅适用于搜索。

您可以使用以下几种语言控件：
- 同义词：扩展搜索查询的搜索查询的同义词。
- 单向同义词：针对特定字词扩展单向同义词。
- 不关联：阻止在出现特定字词时搜索一组字词。
- 忽略：阻止搜索中使用某个字词。
- 替换：替换搜索查询中的字词。
置顶：影响结果排序，将某个结果放置在特定位置（例如第 4 位）。可供搜索和浏览。

如需查看这些控件的示例，请参阅服务控件简介。

投放控制配置选项

您可以创建控件，然后将其添加到有效的投放配置中或将其交换。

您最多可以创建 100 个投放控件。如果您需要更多投放控制功能，请申请增加配额。如需了解如何申请更多配额，请参阅增加配额。一个投放配置最多可以包含 100 个除重定向控件之外的任何类型的投放控件，重定向控件的限制为每个投放配置 1000 个。

您可以通过以下方式创建投放控件：

在Google Cloud 控制台的“控件”页面上：您可以在创建服务配置的过程中选择性地创建控件。
您可以使用商品推介控制台。
您可以使用 Controls.create 方法内嵌创建投放控件。

使用 Google Cloud 控制台

如需使用 Google Cloud 控制台创建投放控制设置，请执行以下操作：

前往 Search for commerce 控制台中的控件页面。

转到“控件”页面
按照每个提供服务的控制部分下的 Google Cloud 控制台步骤操作。

使用商品推介控制台

Merchandising 控制台是一款专为推销员设计的工具，可用于创建和管理控件。它提供审批流程，以便所有推销员都可以提出控制措施，并由推销员审批者进行审核。

借助 Merchandising 控制台，您可以创建投放控件，例如固定、提升/掩埋、同义词和分面。Merchandising 控制台具有人性化的界面，可让推销员高效地创建和管理控件。此工具还可简化审批流程，让任何推销员都能提出控制措施，并让推销员审批者审核这些措施。

在 Google Cloud中，如需访问“商品推介”控制台标签页，您至少必须拥有以下权限：

Project Viewer（查看者）：用于访问项目。
Retail Editor：用于修改和保存 Merchandising 控制台设置。

以管理员身份使用控制台

在开始之前，您必须是 Google Cloud 管理员，才能将用户加入到 Merchandising 控制台。

然后，通过访问 Google Cloud 控制台中的“Merchandising”控制台标签页来初始化 Merchandising 控制台：

您需要具备以下 IAM 角色，才能访问、修改和向 Merchandising 控制台用户分配创建者或审批者角色：

如需修改 Merchandising 控制台，您至少需要拥有 Retail Editor 角色。
如需向用户分配 Creator 或 Approver 角色，您需要拥有项目级 IAM 管理员角色。

如需查看 IAM 项目级权限和 Vertex AI Search for Commerce 权限的完整布局，请参阅此 [Vertex AI Search for Commerce 产品](/retail/docs/iam)文档中的 [预定义的管理员角色](/retail/docs/iam#roles)部分。

Merchandising 控制台用户入门指导

如果您是 Google Cloud 控制台管理员，请执行以下操作，以向网站推销员授予对推销控制台的访问权限，并为其分配创建者或审批者角色：

前往 Search for commerce 控制台中的控件页面。

转到“控件”页面
前往商品推介控制台标签页。
您可以看到与当前 Google Cloud 项目关联的 Merchandising 控制台的唯一网址。复制链接或直接在 Google Cloud 控制台中打开链接。
选择商家将用于预览和附加已获批控件的默认投放配置。
为用户授予审批者或创建者角色。
您可以查看与当前 Google Cloud 项目关联的 Merchandising 控制台的唯一网址。复制链接或直接在 Google Cloud 控制台中打开链接。
在商品推介控制台中，为预览选择默认投放配置。
（可选）使用以下函数修改对 Merchandising 控制台的访问权限：

添加用户：向用户授予对商品详情控制台的审批者或创建者访问权限。
删除用户：通过删除审批者或创建者来撤消对 Merchandising 控制台的访问权限。

添加审批人电子邮件地址。对于商家提交的每项控制措施，审批人电子邮件列表中的用户都会收到一封电子邮件，以便他们审核并批准相应控制措施。

以用户身份访问控制台

如果您已获授使用相应网址的访问权限，则可以选择使用 Merchandising 控制台，而不是标准 Google Cloud 控制台。如需使用 Merchandising 控制台创建控制变量，请执行以下操作：

使用管理员为您提供的凭据登录。
按照每个投放控制部分下的 Merchandising 控制台文档步骤操作。
提交后，您会收到一封电子邮件通知，主题为 [商家控制台] 建议的控制措施正在等待审核。
作为审批者，您可以接受、拒绝或更改控制请求。

以网站推销员的身份使用控制台

作为网站商品推销员，您可以按照以下步骤开始使用 Merchandising 控制台。

为问题设置审批流程。

前往主菜单中的设置部分。
默认情况下，系统会在定义目标界面中设置预定义的问题列表。

点击 添加问题，添加一个问题，帮助审批者了解新控件的用途。
点击保存以保存问题。

创建控制变量。

前往控件部分。
点击 创建控制变量。
确定目标：必须回答之前定义的所有问题。如果您尚未定义任何问题，则不会显示此界面。
选择一个控件。指定控件类型并为控件分配名称。
设置规则：您可以为每条规则定义触发条件和操作。
定义触发条件：目标是确定何时应用此控件。

查询字词：当您的搜索查询包含或完全匹配特定字词时，此规则可能会触发。您可以定义这些查询字词。
适用的时间范围：您可以应用时间限制，将此规则的启用限制在特定时间段内。

定义操作：根据控件的类型，您可以定义操作，例如固定控件的商品 ID 和位置。
预览规则：您可以在屏幕上看到规则的动态预览。
提交规则：点击提交以提交推销员设置的规则集后，您可以在控制变量列表中看到该控制变量处于待处理状态。

批准控制

如需批准某项控制措施，请点击控制措施列表中的相应控制措施旁边的更多图标。选择查看。
系统会针对相应控件提供一个界面，您可以在其中批准、拒绝或批准并进行修改。
获得批准后，您会被重定向到控制项列表页面，该页面会显示控制项为已批准。

营销控制台阶段

控制类型

不同类型的控制措施有不同的要求。前往您计划创建的控件类型的创建程序：

创建热推/埋没控制
创建过滤控件
创建重定向控制变量
创建固定控件
创建双向同义词控件
创建单向同义词控件
创建不关联控件
创建忽略控制变量
创建替代控件

创建提升/掩埋控件

此控制类型适用于搜索和推荐。

创建搜索热推/埋没控制
创建推荐升降控制

如需详细了解此控件类型，请参阅提升/掩埋控件。

创建搜索提升/埋没控制

如需创建搜索提升/埋没控制，请执行以下操作：

营销规划控制台

点击管理员提供的网址。Sign in（登录）。

系统会将您转到商品推介控制台中的控制页面。
点击 创建控制变量。
确定最终用户的目标和所需时间。必须回答所有问题。点击下一步。
选择一个控件。输入控件的名称，选择 Search 产品，然后选择控件类型 Boost/Bury。
配置提升/掩埋控件：
1. 在触发条件下，通过为相关搜索查询提供条件（例如包含或不在范围内），定义哪些目录属性会触发此控制。如果未配置任何目录属性，此控件将始终适用。
2. 通过输入日期范围来定义适用时间范围。如果满足指定的任一时间范围，则在指定的任一时间范围内，目录属性将与查询匹配。使用 添加时间范围添加时间范围。
3. 定义您要使用此控件触发的提升/掩埋操作。这些操作由目录属性（例如 colors）、条件（例如 contains）和值（例如 red）定义。
4. 点击 添加属性，以添加更多属性。
使用滑块设置提升/掩埋值。负数表示埋点，正数表示提升。
点击提交，将控制请求提交给审批者。您将能够在 Merchandising Console 中查看已提交请求的状态。如果您改变了主意，可以删除控制请求。

审批人步骤

在投放配置下，将您的控件分配给现有的投放配置。
批准提升/掩埋控件的请求。

Cloud 控制台

前往 Search for commerce 控制台中的控件页面。

转到“控件”页面
在投放控件标签页下，点击 创建控件。

系统会打开创建控制变量窗格。
在偏好设置部分的控制名称字段中，为新控制输入名称。
可选：如需更改自动创建的控制 ID，请点击修改，然后输入新的控制 ID。
在选择商品部分中，选择搜索。
选择提升/掩埋控件作为控件类型。点击继续
在触发器部分中，选择哪种类型的用户行为会触发此控件。
- 浏览类别：当用户浏览您网站上的类别时（search.request.query 为空），此规则就会触发。
- 搜索：当用户在您的网站上进行搜索时（search.request.query 不为空）触发该规则。如需将此控件设置为在浏览任何类别或搜索任何查询时触发，请跳过以下步骤。
可选：设置可触发此控制措施的特定类别或查询，具体取决于用户浏览的是特定类别还是搜索的是特定查询。
- 如果您选择的是浏览类别：在类别字段中，输入在浏览时会触发此控制措施的类别。
- 如果您选择搜索：点击添加查询按钮，添加要过滤的搜索字词（例如 running shoes）。为每个字词选择部分匹配或完全匹配。
注意：如果您除了指定时间范围条件之外，还指定了类别或搜索查询字词条件，则只有在同时满足这两个条件时，系统才会应用控制措施。
可选：点击添加时间范围按钮以添加一个或多个可以应用此控制措施的时间范围。

注意：如果您除了指定此类条件之外，还指定了时间范围条件，则只有在同时满足这两个条件时，系统才会应用相应控制措施。
点击继续以进入操作部分。
在提升/掩埋商品字段中，为商品特性添加过滤条件。

使用过滤和排序中记录的过滤条件表达式语法。例如，如需要指定“product1”和“product2”的红色和蓝色版本，请使用以下语法：(id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))
对于提升/掩埋值，使用滑块设置提升强度。正值会增强结果，负值会掩埋结果。点击继续。
在投放配置部分，选择要应用控件的投放配置。
提交控件设置。

新创建的或更新的控件需要几分钟时间才能准备好传送实时流量。您可以在控制台的评估页面上测试更改是否已应用。

您现在可以在控件页面的投放控件标签页上找到列出的新控件。

curl

发出 Control.create 请求，其中包含控制 ID 和请求正文中的 Control 实例。

如需了解字段详情，请参阅 Controls API 参考文档和 Controls.create API 参考文档。

当用户浏览您网站上的类别（search.request.query 为空）或在您网站上搜索（search.request.query 不为空）时，可以触发提升/埋没控制。

以下示例展示了浏览触发的控件的字段，其中 searchSolutionUseCase 设置为 SEARCH_SOLUTION_USE_CASE_BROWSE。

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_BROWSE"
              ],
              "rule": {
                "condition": {
                  "pageCategories": [
                      "CATEGORY_ABC",
                      "CATEGORY_XYZ"
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "boostAction": {
                  "boost": BOOST_NUMBER,
                  "productsFilter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

以下示例展示了搜索触发的控件的字段，其中 searchSolutionUseCase 设置为 SEARCH_SOLUTION_USE_CASE_SEARCH。

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_SEARCH"
              ],
              "rule": {
                "condition": {
                  "queryTerms": [
                    {
                      "value": "VALUE_1",
                      "fullMatch": "FULLMATCH_BOOLEAN_1"
                    },
                    {
                      "value": "VALUE_2",
                      "fullMatch": "FULLMATCH_BOOLEAN_2"
                    }
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "boostAction": {
                  "boost": BOOST_NUMBER,
                  "productsFilter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

新创建的或更新的控件需要几分钟时间才能准备好传送实时流量。您可以在控制台的评估页面上测试更改是否已应用。

如需向投放配置添加控制变量，请使用 ServingConfig.addControl 方法：

如需详细了解此方法，请参阅 ServingConfig.addControl API 参考文档。
如需查看此方法的示例，请参阅管理投放配置。

创建推荐提升/掩埋控件

如需创建推荐提升/掩埋控件，请执行以下操作：

营销规划控制台

点击管理员提供的网址。Sign in（登录）。

系统会将您转到商品推介控制台中的控制页面。
点击 创建控制变量。
确定最终用户的目标和所需时间。必须回答所有问题。点击下一步。
选择一个控件。输入控件的名称，选择浏览商品，然后选择控件类型提升/掩埋。
配置提升/掩埋控件：
1. 在触发器下，输入要触发控制功能的网页类别。如果未配置任何目录属性，此控件将始终有效。
2. 通过输入日期范围来定义适用时间范围。如果满足指定的任一时间范围，则在指定的任一时间范围内，目录属性将与查询匹配。使用 添加时间范围添加时间范围。
3. 定义您要使用此控件触发的提升/掩埋操作。这些操作由目录属性（例如 colors）、条件（例如 contains）和值（例如 red）定义。
4. 点击 添加属性，以添加更多属性。
使用滑块设置提升/掩埋值。负数表示埋没，正数表示提升。
点击提交，将控制请求提交给审批者。您将能够在 Merchandising Console 中查看已提交请求的状态。如果您改变了主意，可以删除控制请求。

审批人步骤

在投放配置下，将您的控件分配给现有的投放配置。
批准提升/掩埋控件的请求。

Cloud 控制台

前往 Search for commerce 控制台中的控件页面。

转到“控件”页面
在投放控件标签页上，点击 创建控件。

系统会打开创建控制变量窗格。
在偏好设置部分的控制名称字段中，为新控件输入名称。
（可选）如需更改自动创建的控制组 ID，请点击修改，然后输入新的控制组 ID。
在商品选择部分，选择推荐。
选择提升/掩埋控件作为控件类型。
点击继续以进入操作部分。
在提升/掩埋商品字段中，为商品特性添加过滤条件。

使用过滤建议中记录的过滤条件表达式语法。

例如，如需要指定“product1”和“product2”的红色和蓝色版本，请使用以下语法：(id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))
对于提升/掩埋值，使用滑块设置提升强度。正值会增强结果，负值会掩埋结果。
点击继续，前往提供配置部分。
选择要应用控件的投放配置。
提交控件设置。

新创建的或更新的控件需要几分钟时间才能准备好传送实时流量。您可以在控制台的评估页面上测试更改是否已应用。

您可以在控件页面的投放控件标签页上找到列出的新控件。

curl

发出 Control.create 请求，其中包含控制 ID 和请求正文中的 Control 实例。

如需了解字段详情，请参阅 Controls API 参考文档和 Controls.create API 参考文档。

如需创建过滤表达式，请使用过滤建议中记录的过滤表达式语法。

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "solutionTypes": [ "SOLUTION_TYPE_RECOMMENDATION" ],
                "boostAction": {
                  "boost": BOOST_NUMBER,
                  "productsFilter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

新创建的或更新的控件需要几分钟时间才能准备好传送实时流量。您可以在控制台的评估页面上测试更改是否已应用。

如需向投放配置添加控制变量，请使用 ServingConfig.addControl 方法：

如需详细了解此方法，请参阅 ServingConfig.addControl API 参考文档。
如需查看此方法的示例，请参阅管理投放配置。

创建过滤控件

如需详细了解此控件类型，请参阅过滤器控件。

营销规划控制台

点击管理员提供的网址。Sign in（登录）。

系统会将您转到商品推介控制台中的控制页面。
点击 创建控制变量。
确定最终用户的目标和所需时间。必须回答所有问题。点击下一步。
选择一个控件。输入控制变量的名称，选择搜索或浏览产品，然后选择控制变量类型过滤。
配置过滤条件控件：
1. 在触发条件下，通过为相关搜索查询或网页类别提供条件（例如包含或不在范围内），定义哪些目录属性会触发此控制变量。如果未配置任何目录属性，此控件将始终适用。
2. 通过输入日期范围来定义适用时间范围。如果满足指定的任一时间范围，则在指定的任一时间范围内，目录属性将与查询匹配。使用 添加时间范围添加时间范围。
3. 定义您要使用此控件触发的过滤操作。这些操作由目录属性（例如 colors）、条件（例如 contains）和值（例如 red）定义。
4. 点击 添加属性，以添加更多属性。
点击提交，将控制请求提交给审批者。您将能够在 Merchandising Console 中查看已提交请求的状态。如果您改变了主意，可以删除控制请求。

审批人步骤

在投放配置下，将您的控件分配给现有的投放配置。
批准对过滤条件控件的请求。

Cloud 控制台

前往 Search for commerce 控制台中的控件页面。

转到“控件”页面
在投放控件标签页上，点击 创建控件。

系统会打开创建控制变量窗格。
在偏好设置部分的控制名称字段中，为新控件输入名称。
可选：如需更改自动创建的控制 ID，请点击修改，然后输入新的控制 ID。
选择过滤条件控件作为控件类型。
点击“继续”以进入触发器部分。
选择哪种类型的用户行为会触发此控件：
- 浏览类别：当用户浏览您网站上的类别时（search.request.query 为空），此规则就会触发。
- 搜索：当用户在您的网站上进行搜索时（search.request.query 不为空）触发该规则。
可选：设置控制条件，以便根据浏览的类别或搜索的查询来触发规则。可用的选项取决于您选择的是浏览类别还是搜索：
- 如果您选择的是浏览类别：在类别字段中，输入在浏览时会触发此控制措施的类别。
- 如果您选择的是搜索：点击添加查询按钮以添加要过滤的搜索字词（例如 running shoes），然后为每个字词选择以下选项之一：
  - 部分匹配：此控件仅在查询包含与查询字词部分匹配的内容时适用。
  - 完全匹配：此控件仅在查询包含与此查询字词完全匹配的内容时适用。
  如果查询中包含这些字词之一，则应用相应控件。
注意：如果您除了指定此条件之外，还指定了时间范围条件，则只有在同时满足这两个条件时，系统才会应用相应控制措施。
可选：点击添加时间范围按钮以添加一个或多个可以应用此控制措施的时间范围。

注意：如果您除了指定此时间范围条件之外，还指定了类别或搜索查询条件，则只有在同时满足这两个条件时，系统才会应用此控件。
点击继续以进入操作部分。
在过滤操作字段中添加商品属性的过滤条件。

使用过滤和排序中记录的过滤条件表达式语法。

例如，如需要指定“product1”和“product2”的红色和蓝色版本，请使用以下语法：(id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))
点击继续，前往提供配置部分。
选择要应用控件的投放配置。
提交控件设置。

新创建的或更新的控件需要几分钟时间才能准备好传送实时流量。您可以在控制台的评估页面上测试更改是否已应用。

您可以在控件页面的投放控件标签页上找到列出的新控件。

curl

发出 Control.create 请求，其中包含控制 ID 和请求正文中的 Control 实例。

如需了解字段详情，请参阅 Controls API 参考文档和 Controls.create API 参考文档。

当用户浏览您网站上的类别（search.request.query 为空）或在您网站上搜索（search.request.query 不为空）时，可以触发过滤条件控件。

以下示例展示了浏览触发的控件的字段，其中 searchSolutionUseCase 设置为 SEARCH_SOLUTION_USE_CASE_BROWSE。

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_BROWSE"
              ],
              "rule": {
                "condition": {
                  "pageCategories": [
                      "CATEGORY_ABC",
                      "CATEGORY_XYZ"
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "filterAction": {
                  "filter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

以下示例展示了搜索触发的控件的字段，其中 searchSolutionUseCase 设置为 SEARCH_SOLUTION_USE_CASE_SEARCH。

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_SEARCH"
              ],
              "rule": {
                "condition": {
                  "pageCategories": [
                      "CATEGORY_ABC",
                      "CATEGORY_XYZ"
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "filterAction": {
                  "filter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

如需向投放配置添加控制变量，请使用 ServingConfig.addControl 方法：

如需详细了解此方法，请参阅 ServingConfig.addControl API 参考文档。
如需查看此方法的示例，请参阅管理投放配置。

创建重定向控件

如需详细了解此控件类型，请参阅重定向控件。

营销规划控制台

点击管理员提供的网址。Sign in（登录）。

系统会将您转到商品推介控制台中的控制页面。
点击 创建控制变量。
确定最终用户的目标和所需时间。必须回答所有问题。点击下一步。
选择一个控件。输入控件的名称，选择 Search 产品，然后选择控件类型 Redirect。
配置重定向控件：
1. 在触发条件下，通过为相关搜索查询提供条件（例如包含或不在范围内），定义哪些目录属性会触发此控制。如果未配置任何目录属性，此控件将始终适用。
2. 通过输入日期范围来定义适用时间范围。如果满足指定的任一时间范围，则在指定的任一时间范围内，目录属性将与查询匹配。使用 添加时间范围添加时间范围。
3. 输入重定向网址，定义您要使用此控件触发的重定向操作。
点击提交，将控制请求提交给审批者。您将能够在 Merchandising Console 中查看已提交请求的状态。如果您改变了主意，可以删除控制请求。

审批人步骤

在投放配置下，将您的控件分配给现有的投放配置。
批准对重定向控件的请求。

Cloud 控制台

前往 Search for commerce 控制台中的控件页面。

转到“控件”页面
在投放控件标签页上，点击 创建控件。

系统会打开创建控制变量窗格。
在偏好设置部分的控制名称字段中，为新控件输入名称。
可选：如需更改自动创建的控制 ID，请点击修改，然后输入新的控制 ID。
选择重定向控件作为控件类型。
点击“继续”以进入触发器部分。
创建至少一个搜索字词或时间范围触发器。重定向控件至少需要一个触发器：
选择哪种类型的用户行为会触发此控件：
- 浏览类别：当用户浏览您网站上的类别时（search.request.query 为空），此规则就会触发。
- 搜索：当用户在您的网站上进行搜索时（search.request.query 不为空）触发该规则。
设置控制条件，以便根据浏览的类别或搜索的查询内容来触发规则。可用的选项取决于您选择的是浏览类别还是搜索：
- 如果您选择的是浏览类别：在类别字段中，输入在浏览时会触发此控制措施的类别。
- 如果您选择的是搜索：点击添加查询按钮以添加要过滤的搜索字词（例如 running shoes），然后为每个字词选择以下选项之一：
  - 部分匹配：此控件仅在查询包含与查询字词部分匹配的内容时适用。
  - 完全匹配：此控件仅在查询包含与此查询字词完全匹配的内容时适用。
  如果查询中包含这些字词之一，则应用相应控件。
注意：如果您除了指定此条件之外，还指定了时间范围条件，则只有在同时满足这两个条件时，系统才会应用相应控制措施。
点击添加时间范围按钮以添加一个或多个可以应用此控制措施的时间范围。

注意：如果您除了指定此时间范围条件之外，还指定了类别或搜索查询条件，则只有在同时满足这两个条件时，系统才会应用此控件。
点击继续以进入操作部分。
输入触发此控件时要重定向到的 URI。
点击继续，前往提供配置部分。
选择要应用控件的投放配置。
提交控件设置。

新创建的或更新的控件需要几分钟时间才能准备好传送实时流量。您可以在控制台的评估页面上测试更改是否已应用。

您可以在“控件”页面的投放控件 (Serving controls) 标签页上找到列出的新控件。

curl

发出 Control.create 请求，其中包含控制 ID 和请求正文中的 Control 实例。

如需了解字段详情，请参阅 Controls API 参考文档和 Controls.create API 参考文档。

当用户浏览您网站上的类别（search.request.query 为空）或在您网站上搜索（search.request.query 不为空）时，可以触发重定向控制。

以下示例展示了浏览触发的控件的字段，其中 searchSolutionUseCase 设置为 SEARCH_SOLUTION_USE_CASE_BROWSE。

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_BROWSE"
              ],
              "rule": {
                "condition": {
                  "queryTerms": [
                    {
                      "value": "VALUE_1",
                      "fullMatch": "FULLMATCH_BOOLEAN_1"
                    },
                    {
                      "value": "VALUE_2",
                      "fullMatch": "FULLMATCH_BOOLEAN_2"
                    }
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "redirectAction": {
                  "redirectUri": "REDIRECT_URI",
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

以下示例展示了搜索触发的控件的字段，其中 searchSolutionUseCase 设置为 SEARCH_SOLUTION_USE_CASE_SEARCH。

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_SEARCH"
              ],
              "rule": {
                "condition": {
                  "queryTerms": [
                    {
                      "value": "VALUE_1",
                      "fullMatch": "FULLMATCH_BOOLEAN_1"
                    },
                    {
                      "value": "VALUE_2",
                      "fullMatch": "FULLMATCH_BOOLEAN_2"
                    }
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "redirectAction": {
                  "redirectUri": "REDIRECT_URI",
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

如需向投放配置添加控制变量，请使用 ServingConfig.addControl 方法：

如需详细了解此方法，请参阅 ServingConfig.addControl API 参考文档。
如需查看此方法的示例，请参阅管理投放配置。

创建双向同义词控件

如需详细了解此控件类型，请参阅双向同义词控件。

营销规划控制台

点击管理员提供的网址。Sign in（登录）。

系统会将您转到商品推介控制台中的控制页面。
点击 创建控制变量。
确定最终用户的目标和所需时间。必须回答所有问题。点击下一步。
选择一个控件。输入控件的名称，选择 Search 产品，然后选择控件类型 Synonyms。
配置双向同义词控件：
1. 在触发条件下，通过为相关搜索查询提供条件（例如包含或不在范围内），定义哪些目录属性会触发此控制。如果未配置任何目录属性，此控件将始终适用。
2. 通过输入日期范围来定义适用时间范围。如果满足指定的任一时间范围，则在指定的任一时间范围内，目录属性将与查询匹配。使用 添加时间范围添加时间范围。
3. 定义您要使用此控件触发的同义词类型。选择双向。如需详细了解同义词类型，请参阅有关同义词的部分。
点击提交。系统随即会转到详细的双向同义词配置界面。
在双向同义词操作下的字段中输入同义词。此操作会以双向方式将字词关联在一起，以便在搜索结果中将它们视为相同字词，这样一来，搜索“红色沙发”会返回“红棕色沙发”，但搜索“红棕色沙发”会扩展为包含所有类型的红色沙发，例如深红色或粉红色。
再次点击提交，将控制请求发送给审批者。您将能够在 Merchandising Console 中查看已提交请求的状态。如果您改变了主意，可以删除控制请求。

审批人步骤

在投放配置下，将您的控件分配给现有的投放配置。
批准对双向同义词控件的请求。

Cloud 控制台

前往 Search for commerce 控制台中的控件页面。

转到“控件”页面
在投放控件标签页上，点击 创建控件。
在控制变量名称字段中，为新控制变量输入名称。

系统会打开创建控制变量窗格。
您将进入偏好设置部分。
可选：如需更改自动创建的控制 ID，请点击修改，然后输入新的控制 ID。
选择双向同义词控件作为控件类型。
点击“继续”以进入触发器部分。
可选：点击添加时间范围按钮以添加一个或多个可以应用此控制措施的时间范围。
点击继续以进入操作部分。
在同义词字段中，输入 2 到 100 个应互为同义词的搜索字词（例如 shirt 和 top）。

如果查询中包含其中任一字词，则搜索会将其他查询字词视为所包含字词的同义词。
点击继续，前往提供配置部分。
选择要应用控件的投放配置。
提交控件设置。

新创建的或更新的控件需要几分钟时间才能准备好传送实时流量。您可以在控制台的评估页面上测试更改是否已应用。

您可以在“控件”页面的投放控件 (Serving controls) 标签页上找到列出的新控件。

curl

发出 Control.create 请求，其中包含控制 ID 和请求正文中的 Control 实例。

如需了解字段详情，请参阅 Controls API 参考文档和 Controls.create API 参考文档。

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                    ]
                },
                "twoWaySynonymAction": {
                  "synonyms": [
                    "SYNONYM_1",
                    "SYNONYM_2"
                  ]
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

如需向投放配置添加控制变量，请使用 ServingConfig.addControl 方法。请参阅内嵌向投放配置添加控件。

创建单向同义词控件

如需详细了解此控件类型，请参阅单向同义词控件。

营销规划控制台

点击管理员提供的网址。Sign in（登录）。

系统会将您转到商品推介控制台中的控制页面。
点击 创建控制变量。
确定最终用户的目标和所需时间。必须回答所有问题。点击下一步。
选择一个控件。输入控件的名称，选择 Search 产品，然后选择控件类型 Synonyms。
配置单向同义词控件：
1. 在触发条件下，通过为相关搜索查询提供条件（例如包含或不在范围内），定义哪些目录属性会触发此控制。如果未配置任何目录属性，此控件将始终适用。
2. 通过输入日期范围来定义适用时间范围。如果满足指定的任一时间范围，则在指定的任一时间范围内，目录属性将与查询匹配。使用 添加时间范围添加时间范围。
3. 定义您要使用此控件触发的同义词类型。选择单程。如需详细了解同义词类型，请参阅有关同义词的部分。
点击提交。系统随即会转到详细的单向同义词配置界面。
在单向同义词操作下方的字段中输入同义词。此操作会以单向方式将字词关联在一起，以便在搜索结果中将它们视为相同字词，这样一来，搜索“红色沙发”时会包含“深红色沙发”，但搜索“深红色沙发”时不会返回其他类型的红色沙发，从而将结果限制为仅包含深红色沙发。
再次点击提交，向审批者发送控制请求。您将能够在 Merchandising Console 中查看已提交请求的状态。如果您改变了主意，可以删除控制请求。

审批人步骤

在投放配置下，将您的控件分配给现有的投放配置。
批准针对单向同义词控件的请求。

Cloud 控制台

前往 Search for commerce 控制台中的控件页面。

转到“控件”页面
在投放控件标签页上，点击 创建控件。

系统会打开创建控制变量窗格。
在偏好设置部分的控制名称字段中，为新控件输入名称。
可选：如需更改自动创建的控制 ID，请点击修改，然后输入新的控制 ID。
选择单向同义词控件作为控件类型。
点击“继续”以进入触发器部分。
可选：点击添加时间范围按钮以添加一个或多个可以应用此控制措施的时间范围。
点击继续以进入操作部分。
在查询字词字段中，输入当查询中包含任何字词时，应与同义词相关联的字词（例如 shoes）。
在同义词字段中，输入应该用作您指定的查询字词的同义词的字词（例如，sneakers 和 sandals 作为查询字词 shoes 的单向同义词）。
点击继续，前往提供配置部分。
选择要应用控件的投放配置。
提交控件设置。

新创建的或更新的控件需要几分钟时间才能准备好传送实时流量。您可以在控制台的评估页面上测试更改是否已应用。

您可以在“控件”页面的投放控件 (Serving controls) 标签页上找到列出的新控件。

curl

发出 Control.create 请求，其中包含控制 ID 和请求正文中的 Control 实例。

如需了解字段详情，请参阅 Controls API 参考文档和 Controls.create API 参考文档。

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "oneWaySynonymAction": {
                  "synonyms": [
                    "queryTerms": [
                      "QUERY_TERM_1",
                      "QUERY_TERM_2"
                    ],
                    "synonyms": [
                      "SYNONYM_1",
                      "SYNONYM_2"
                    ]
                  ]
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

如需向投放配置添加控制变量，请使用 ServingConfig.addControl 方法：

如需详细了解此方法，请参阅 ServingConfig.addControl API 参考文档。
如需查看此方法的示例，请参阅管理投放配置。

创建不关联控件

如需详细了解此控件类型，请参阅不关联控件。

营销规划控制台

点击管理员提供的网址。Sign in（登录）。

系统会将您转到商品推介控制台中的控制页面。
点击 创建控制变量。
确定最终用户的目标和所需时间。必须回答所有问题。点击下一步。
选择一个控件。输入控件的名称，选择 Search 产品，然后选择控件类型 Do not associate。
配置不关联控制变量：
1. 在触发条件下，通过为相关搜索查询提供条件（例如包含或不在范围内），定义哪些目录属性会触发此控制。如果未配置任何目录属性，此控件将始终适用。
2. 通过输入日期范围来定义适用时间范围。如果满足指定的任一时间范围，则在指定的任一时间范围内，目录属性将与查询匹配。使用 添加时间范围添加时间范围。
3. 在不关联操作下，指定不应与您在前面的触发条件部分中输入的查询字词关联的字词。分别将它们输入到“查询字词”和“不相关字词”字段中。
点击提交，将控制请求发送给审批者。您将能够在 Merchandising Console 中查看已提交请求的状态。如果您改变了主意，可以删除控制请求。

审批人步骤

在投放配置下，将您的控件分配给现有的投放配置。
批准 Do-not-associate 控件的请求。

Cloud 控制台

前往 Search for commerce 控制台中的控件页面。

转到“控件”页面
在投放控件标签页上，点击 创建控件。

系统会打开创建控制变量窗格。
在偏好设置部分的控制名称字段中，为新控件输入名称。
可选：如需更改自动创建的控制 ID，请点击修改，然后输入新的控制 ID。
选择不关联控件作为控件类型。
点击“继续”以进入触发器部分。
可选：点击添加时间范围按钮以添加一个或多个可以应用此控制措施的时间范围。
点击继续以进入操作部分。
在查询字词字段中，输入您要明确区分的字词（例如 gShoe）。
在不关联的字词字段中，输入要与搜索结果中的指定查询字词取消关联的字词。

例如，您可以将搜索字词 gShoe 与字词 cheap 分开。
点击继续，前往提供配置部分。
选择要应用控件的投放配置。
提交控件设置。

新创建的或更新的控件需要几分钟时间才能准备好传送实时流量。您可以在控制台的评估页面上测试更改是否已应用。

您可以在“控件”页面的投放控件 (Serving controls) 标签页上找到列出的新控件。

curl

发出 Control.create 请求，其中包含控制 ID 和请求正文中的 Control 实例。

如需了解字段详情，请参阅 Controls API 参考文档和 Controls.create API 参考文档。

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "doNotAssociateAction": {
                    "queryTerms": [
                      "QUERY_TERM_1",
                      "QUERY_TERM_2"
                    ],
                    "doNotAssociateTerms": [
                      "DISSOCIATED_TERM_1",
                      "DISSOCIATED_TERM_2"
                    ]
                  ]
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

如需向投放配置添加控制变量，请使用 ServingConfig.addControl 方法：

如需详细了解此方法，请参阅 ServingConfig.addControl API 参考文档。
如需查看此方法的示例，请参阅管理投放配置。

创建忽略控制措施

如需详细了解此控件类型，请参阅忽略控件。

营销规划控制台

点击管理员提供的网址。Sign in（登录）。

系统会将您转到商品推介控制台中的控制页面。
点击 创建控制变量。
确定最终用户的目标和所需时间。必须回答所有问题。点击下一步。
选择一个控件。输入控件的名称，选择 Search 产品，然后选择控件类型 Ignore。
配置忽略控件：
1. 在触发条件下，通过为相关搜索查询提供条件（例如包含或不在范围内），定义哪些目录属性会触发此控制。如果未配置任何目录属性，此控件将始终适用。
2. 通过输入日期范围来定义适用时间范围。如果满足指定的任一时间范围，则在指定的任一时间范围内，目录属性将与查询匹配。使用 添加时间范围添加时间范围。
3. 在忽略操作下，输入您要忽略的字词。
点击提交，将控制请求提交给审批者。您将能够在 Merchandising Console 中查看已提交请求的状态。如果您改变了主意，可以删除控制请求。

审批人步骤

在投放配置下，将您的控件分配给现有的投放配置。
批准对忽略控件的请求。

Cloud 控制台

前往 Search for commerce 控制台中的控件页面。

转到“控件”页面
在投放控件标签页上，点击 创建控件。

系统会打开创建控制变量窗格。
在偏好设置部分的控制名称字段中，为新控件输入名称。
可选：如需更改自动创建的控制 ID，请点击修改，然后输入新的控制 ID。
选择不关联控件作为控件类型。
点击“继续”以进入触发器部分。
可选：点击添加时间范围按钮以添加一个或多个可以应用此控制措施的时间范围。
点击继续以进入操作部分。
在忽略字词字段中，输入您希望搜索在输入这些字词作为查询字词时忽略的字词（例如 shoddy）。
点击继续，前往提供配置部分。
选择要应用控件的投放配置。
提交控件设置。

新创建的或更新的控件需要几分钟时间才能准备好传送实时流量。您可以在控制台的评估页面上测试更改是否已应用。

您可以在“控件”页面的投放控件 (Serving controls) 标签页上找到列出的新控件。

curl

发出 Control.create 请求，其中包含控制 ID 和请求正文中的 Control 实例。

如需了解字段详情，请参阅 Controls API 参考文档和 Controls.create API 参考文档。

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "ignoreAction": {
                  "ignoreTerms": [
                      "IGNORE_TERM_1",
                      "IGNORE_TERM_2"
                    ]
                  ]
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

如需向投放配置添加控制变量，请使用 ServingConfig.addControl 方法：

如需详细了解此方法，请参阅 ServingConfig.addControl API 参考文档。
如需查看此方法的示例，请参阅管理投放配置。

创建替代控件

如需详细了解此控制类型，请参阅替换控件。

营销规划控制台

点击管理员提供的网址。Sign in（登录）。

系统会将您转到商品推介控制台中的控制页面。
点击 创建控制变量。
确定最终用户的目标和所需时间。必须回答所有问题。点击下一步。
选择一个控件。输入控件的名称，选择 Search 产品，然后选择控件类型 Replacement。
配置替换控制：
1. 在触发条件下，通过为相关搜索查询提供条件（例如包含或不在范围内），定义哪些目录属性会触发此控制。如果未配置任何目录属性，此控件将始终适用。
2. 通过输入日期范围来定义适用时间范围。如果满足指定的任一时间范围，则在指定的任一时间范围内，目录属性将与查询匹配。使用 添加时间范围添加时间范围。
3. 在替换操作下，在第一个字段中定义要替换的搜索查询字词，并在第二个字段中定义替换字词。
点击提交，将控制请求发送给审批者。您将能够在 Merchandising Console 中查看已提交请求的状态。如果您改变了主意，可以删除控制请求。

审批人步骤

在投放配置下，将您的控件分配给现有的投放配置。
批准对替换控件的请求。

Cloud 控制台

前往 Search for commerce 控制台中的控件页面。

转到“控件”页面
在投放控件标签页上，点击 创建控件。

系统会打开创建控制变量窗格。
在偏好设置部分的控制名称字段中，为新控件输入名称。
可选：如需更改自动创建的控制 ID，请点击修改，然后输入新的控制 ID。
选择替换控件作为控件类型。
点击“继续”以进入触发器部分。
可选：点击添加时间范围按钮以添加一个或多个可以应用此控制措施的时间范围。
点击继续以进入操作部分。
在查询字词字段中，输入您希望替换字词替换的查询字词（例如 gShoe）。
在替换字词字段中，输入应替换您指定的查询字词的字词。

例如，您可以将搜索字词 gShoe 替换为替换字词 Google Shoe。
点击继续，前往提供配置部分。
选择要应用控件的投放配置。
提交控件设置。

新创建的或更新的控件需要几分钟时间才能准备好传送实时流量。您可以在控制台的评估页面上测试更改是否已应用。

您可以在“控件”页面的投放控件 (Serving controls) 标签页上找到列出的新控件。

curl

发出 Control.create 请求，其中包含控制 ID 和请求正文中的 Control 实例。

如需了解字段详情，请参阅 Controls API 参考文档和 Controls.create API 参考文档。

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "replacementAction": {
                    "queryTerms": [
                      "QUERY_TERM_1",
                      "QUERY_TERM_2"
                    ],
                    "replacementTerm": "REPLACEMENT_TERM"
                  }
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

如需向投放配置添加控制变量，请使用 ServingConfig.addControl 方法：

如需详细了解此方法，请参阅 ServingConfig.addControl API 参考文档。
如需查看此方法的示例，请参阅管理投放配置。

创建固定控件

如需创建固定控件，请执行以下操作：

营销规划控制台

点击管理员提供的网址。Sign in（登录）。

系统会将您转到商品推介控制台中的控制页面。
点击 创建控制变量。
确定最终用户的目标和所需时间。必须回答所有问题。点击下一步。
选择一个控件。输入控件的名称，选择 Search 产品，然后选择控件类型 Pinning。
配置固定控件：
1. 在触发条件下，通过为相关搜索查询提供条件（例如包含或不在范围内），定义哪些目录属性会触发此控制。如果未配置任何目录属性，此控件将始终适用。
2. 通过输入日期范围来定义适用时间范围。如果满足指定的任一时间范围，则在指定的任一时间范围内，目录属性将与查询匹配。使用 添加时间范围添加时间范围。
3. 定义您要使用此控件触发的固定操作。这些操作由商品 ID 和图钉位置（最好是小于 120 的数字，即典型的网页大小）定义。您可以点击 添加商品，最多可添加 10 件商品。
点击提交，将控制请求提交给审批者。您将能够在 Merchandising Console 中查看已提交请求的状态。如果您改变了主意，可以删除控制请求。

审批人步骤

在投放配置下，将您的控件分配给现有的投放配置。
批准对固定控件的请求。

Cloud 控制台

前往 Search for commerce 控制台中的控件页面。

转到“控件”页面
在投放控件标签页上，点击 创建控件。

系统会打开创建控制变量窗格。
在偏好设置部分的控制变量名称字段中，输入新控制变量的名称。
可选：如需更改自动创建的对照组 ID，请点击修改，然后输入新的对照组 ID。
在选择商品部分中，选择搜索或浏览。
选择固定控制作为控制类型。点击继续。
在触发器部分，选择触发此控制措施的用户行为：
- 浏览类别：浏览请求除了要求 search.request.query 为空之外，还需要填充 page_categories 字段。
- 搜索：搜索请求只需要填充 search.request.query。
  
  默认情况下，浏览的所有类别和搜索的所有查询都会触发此控件。
可选：设置一个条件，以便根据浏览的特定类别或搜索的查询来触发规则：
- 浏览类别：在类别字段中，输入触发控制的类别。
- 搜索：如需添加要过滤的查询字词（例如 running shoes），请点击添加查询。为每个字词选择部分匹配或完全匹配。
可选：点击添加时间范围或添加日期范围，以添加一个或多个可以应用此控制措施的时间范围。

注意：如果您指定了类别或搜索查询字词，以及时间范围或日期范围条件，则只有在同时满足这两种类型的条件时，系统才会应用控件措施。
点击继续以进入操作部分。对于置顶商品，请使用滑块指定要将商品置顶到哪个位置。针脚值滑块不接受 0、负数或非整数值。

Vertex AI Search 商务解决方案允许在任何单个控件的针脚地图中放置 10 个针脚。位置可以是 1 到 120（最大请求页面大小）之间的任何值。

注意：如果位置大于请求的页面大小，则不会遵循固定到第二页的设置。例如，如果搜索查询请求的页面大小为 50，但您已将固定位置设置为第 75 页，则搜索项将在结果中被忽略。
点击继续，前往提供配置部分。选择要应用控件的投放配置，然后提交控件设置。

新创建的或更新的控件需要几分钟时间才能准备好传送实时流量。您可以在控制台的评估页面上测试更改是否已应用。

您可以在控件页面的投放控件标签页上找到列出的新控件。

curl

发出 Control.create 请求，其中包含控制 ID 和请求正文中的 Control 实例。

如需了解字段详情，请参阅 Controls API 参考文档和 Controls.create API 参考文档。

curl -X POST \
 -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
 -H "Content-Type: application/json; charset=utf-8" \
 -H "X-Goog-User-Project: PROJECT_NUMBER" \
 --data '{
          "displayName": "DisplayName",
          "solutionTypes": "SOLUTION_TYPE_SEARCH",
          "searchSolutionUseCase": ["SEARCH_SOLUTION_USE_CASE_SEARCH"],
     "rule": {
            "condition": {
 "queryTerms": [
                {
                  "value": "Term1",
                  "fullMatch": "boolean: true / false"
                },
                {
                  "value": "Term2",
                  "fullMatch": "boolean: true / false"
                },
             ],
             "activeTimeRange": [
               {
                 "startTime": timestamp1,
                 "endTime": timestamp2
               },
               {
                 "startTime": timestamp3,
                 "endTime": timestamp4
               }
             ]
            },
            "pinAction": {
               "pinMap" :  {
                        "pin_position1": "product_id",
                      "pin_position2": "product_id>"
                    }
            }
              }
}' \
"https://retail.googleapis.com/v2alpha/projects/PROJECT_NUMBER/locations/LOCATION/catalogs/default_catalog/controls?controlId=CONTROL_ID"

pin_position 应该是介于 [1,10] 之间的整数（含首尾），并且 product_id 必须存在于您的目录中。每个控件的针脚地图中允许的元素数量上限为 10。

接下来，将置顶控件附加到服务配置：

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-H "X-Goog-User-Project: PROJECT_NUMBER" \
-d '{
      "controlId": "CONTROL_ID"
  }' \
'https://retail.googleapis.com/v2alpha/projects/PROJECT_NUMBER/locations/LOCATION/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID:addControl'

在这种情况下，CONTROL_ID 应为之前创建的固定控制 id。

如需向投放配置添加控制变量，请使用 ServingConfig.addControl 方法：

如需详细了解此方法，请参阅 ServingConfig.addControl API 参考文档。
如需查看此方法的示例，请参阅管理投放配置。

最后，为了测试您的设置，请发出搜索请求。为确保系统成功应用固定控制，请使用与您在前面步骤中创建的控制中提供的字词/类别相匹配的搜索字词（在搜索中）或网页类别（在浏览中）。

Cloud 控制台

前往 Search for Commerce 控制台中的评估页面。

前往“评估”页面
前往搜索标签页。
在搜索查询字段中输入测试查询。
点击搜索预览。
查看结果，确保所选商品已固定。

curl

curl -s -X POST -H "Authorization: Bearer " -H "Content-Type: application/json"
--data "{'query': '','visitorId': ''}" \ "https://retail.googleapis.com/v2/projects/PROJECT/locations/global/catalogs/CATALOG/placements/default_search:search"

错误检查的限制

在进行错误检查时，请注意以下限制：

两个商品不能固定到同一位置，也就是说，商品“a”和“b”不能同时占据位置 2。
反之，一个商品不能同时固定到多个位置，也就是说，对于同一查询，商品“a”不能同时固定到位置 2 和位置 3。
假设未应用任何过滤条件或排序，product_id 必须作为商品存在于目录中。

创建投放控件 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

服务控制与配置之间的关系

快速入门视频和指南

投放控制配置选项

使用 Google Cloud 控制台

使用商品推介控制台

以管理员身份使用控制台

Merchandising 控制台用户入门指导

以用户身份访问控制台

以网站推销员的身份使用控制台

控制类型

创建提升/掩埋控件

创建搜索提升/埋没控制

营销规划控制台

审批人步骤

Cloud 控制台

curl

创建推荐提升/掩埋控件

营销规划控制台

审批人步骤

Cloud 控制台

curl

创建过滤控件

营销规划控制台

审批人步骤

Cloud 控制台

curl

创建重定向控件

营销规划控制台

审批人步骤

Cloud 控制台

curl

创建双向同义词控件

营销规划控制台

审批人步骤

Cloud 控制台

curl

创建单向同义词控件

营销规划控制台

审批人步骤

Cloud 控制台

curl

创建不关联控件

营销规划控制台

审批人步骤

Cloud 控制台

curl

创建忽略控制措施

营销规划控制台

审批人步骤

Cloud 控制台

curl

创建替代控件

营销规划控制台

审批人步骤

Cloud 控制台

curl

创建固定控件

营销规划控制台

审批人步骤

Cloud 控制台

curl

Cloud 控制台

curl

错误检查的限制

创建投放控件