创建投放控件

本页介绍了如何创建投放控件。

投放控件是指您定义并应用于各个 服务配置如需详细了解投放配置，请参阅投放配置简介。

借助投放控件规则，您可以创建规则，从而自定义您的投放配置提供结果的方式。

您可以在 Retail Search 控制台中创建投放控件，其中包含触发控件的条件和条件触发时执行的操作。然后，您可以将新的服务控件 一项服务配置

投放配置与控件之间存在多对多关系。您可以 向服务配置添加多个控件，也可以将单个控件 与多项服务配置相关联。

创建投放控件和投放配置时，您可以选择其可用于的产品（推荐或搜索）。服务控件只能与服务配置相关联 同一产品类型。例如，为推荐功能创建的广告投放控件无法与为搜索功能创建的广告投放配置相关联。

投放配置用于管理在搜索或预测请求期间应用哪些控件。在投放时，系统只会考虑请求的有效投放配置中的控件。例如，假设您创建了两个控件：一个名为“gShoe 促销”的控件，用于在搜索“鞋子”时提升品牌 gShoe 的搜索结果排名；另一个名为“更多鞋子”的控件，用于将使用字词“跑鞋”的查询扩展为包含“运动鞋”。如果您 请仅附上“gShoe Sale”服务配置，然后搜索请求 使用该服务配置后，对于使用该字词的查询，提高 gShoe 结果 而是使用“More Shoes”不会产生任何影响 附加到您正在使用的服务配置。

您可以创建控件，然后添加控件或将其替换为实际投放中的控件 配置。

您可以随时在以下位置创建或修改投放控件： 控件页面，或使用 Controls.create 方法。在控制台中，您可以选择在投放配置创建过程中创建控件。

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

投放控件适用于：

• 提升/掩埋：影响结果在返回结果列表中的排名和顺序。 可用于搜索和建议。
• Filter：从返回的 结果列表。仅适用于搜索。
• 重定向：根据搜索查询将用户重定向到特定页面。仅适用于搜索。
• 语言：自定义搜索查询语言。适用于 。有多种类型的语言控件 可用：
  • 同义词：扩展搜索查询的搜索查询的同义词。
  • 单向同义词：针对特定字词扩展单向同义词。
  • 不关联：阻止在出现特定字词时搜索一组字词。
  • 忽略：阻止搜索中使用某个字词。
  • 替换：替换搜索查询中的字词。

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

注意：建议您不要创建链式控件或存在冲突的控件。Vertex AI Search for Retail 不支持按预定顺序运行控件。

教程：重定向控件

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

---

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

操作演示

---

创建新的投放控件

在 Google Cloud 控制台的“控件”页面上创建新的投放控件，或使用 Controls.create 方法在线内创建。

控件有不同的要求，具体取决于其类型。前往您计划创建的控件类型的创建流程：

• 创建增强/掩埋控件
• 创建过滤器控件
• 创建重定向控件
• 创建双向同义词控件
• 创建单向同义词控件
• 创建“不关联”控件
• 创建忽略控件
• 创建替换控件

创建提升/掩埋控件

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

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

• 创建搜索提升/埋没控件
• 创建推荐提升/掩埋控制

创建搜索提升/掩埋控件

要创建搜索提升/掩埋控件，请执行以下操作：

控制台

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

2. 在投放控件标签页上，点击 创建控件。

   系统随即会打开创建控件窗格。

在偏好设置部分：

1. 在控件名称字段中，输入新控件的名称。

2. 可选：如需更改自动创建的对照组 ID，请点击修改，然后输入新的对照组 ID。

3. 在产品选择部分中，选择搜索广告。

4. 选择增强/掩埋控件作为控件类型。

5. 点击“继续”以转到触发器部分。

在触发器部分中，设置触发控件的条件：

1. 选择哪些类型的用户行为可触发此控件：

   • 浏览类别：当用户浏览网页时，就会触发规则 您网站上的类别（search.request.query 是 为空）。

   • 搜索：当用户在您的网站上进行搜索时，就会触发规则 （search.request.query 不为空）。

   您可以设置可以触发此控件的特定类别或查询 。如需将此控件设置为在浏览任何类别或搜索任何查询时触发，请跳过以下步骤。

2. 可选：设置一个控制条件，根据是否满足 浏览特定类别或搜索特定查询。

   如需将此控件设置为针对任何类别或任何查询触发，请跳过此步骤。

   是否可用选项取决于您选择了浏览类别还是 Search：

   • 如果您选择了浏览类别：在类别字段中，输入浏览哪些类别时会触发此控制。

   • 如果您选择了搜索：点击添加查询按钮，添加要过滤的查询字词（例如 running shoes），然后为每个字词选择以下选项之一：

     • 部分匹配：此控件仅在查询包含与查询字词部分匹配的内容时适用。
     • 完全匹配：此控件仅在查询包含 与此查询字词完全匹配。

     当查询中包含其中一个字词时，系统会应用该控件。

   如果您除了此类条件之外还指定了时间范围条件，则只有在同时满足这两种条件时，才会应用控件措施。

3. 可选：点击添加时间范围按钮，添加一个或多个可应用此控件的时间范围。

   如果您在时间之外指定了类别或查询字词条件 范围条件时，只有当两个条件同时满足时，系统才会应用该控件 符合。

4. 点击继续，进入操作部分。

在操作部分：

1. 在提升/掩埋商品字段中，为商品属性添加过滤条件。

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

   例如，如需要指定“product1”和“product2”的红色和蓝色版本，请使用以下语法：(id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))

2. 对于提升/掩埋值，使用滑块设置提升强度。正值会增强结果，负值会掩埋结果。

3. 点击继续以转到服务配置部分。

在服务配置部分中，执行以下操作：

1. 选择要应用该控件的服务配置。

2. 提交控件设置。

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

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

curl

发出包含控件 ID 和Control.create 请求正文中包含的 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 参考文档。

• 有关此方法的示例，请参阅 管理服务配置。

创建推荐提升/掩埋控件

预览

此功能须遵守服务专用条款的“通用服务条款”部分中的“非正式版产品条款”。 非正式版功能“按原样”提供，可能只能获得有限的支持。 如需了解详情，请参阅发布阶段说明。

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

控制台

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

2. 在投放控件标签页上，点击 创建控件。

   系统随即会打开创建控件窗格。

在偏好设置部分：

1. 在 Control name（控件名称）字段中，为新控件输入名称。

2. （可选）如需更改自动创建的对照组 ID，请点击修改，然后输入新的对照组 ID。

3. 在产品选择部分中，选择建议。

4. 选择增强/掩埋控件作为控件类型。

5. 点击继续以转到操作部分。

在操作部分：

1. 在提升/掩埋商品字段中，为商品属性添加过滤条件。

   使用 中所述的过滤器表达式语法， 过滤建议。

   例如，如需要指定“product1”和“product2”的红色和蓝色版本，请使用以下语法：(id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))

2. 对于提升/掩埋值，使用滑块设置提升强度。正值会增强结果，负值会掩埋结果。

3. 点击继续以转到服务配置部分。

在服务配置部分中，执行以下操作：

1. 选择要应用该控件的服务配置。

2. 提交控件设置。

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

您可以在“控件”页面的投放控件 (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_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 参考文档。

• 有关此方法的示例，请参阅 管理服务配置。

创建过滤条件控件

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

控制台

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

2. 在投放控件标签页上，点击 创建控件。

   系统随即会打开创建控件窗格。

在偏好设置部分：

1. 在控件名称字段中，输入新控件的名称。

2. 可选：如需更改自动创建的对照组 ID，请点击修改，然后输入新的对照组 ID。

3. 选择过滤器控件作为控件类型。

4. 点击“继续”以转到触发器部分。

在触发器部分中：

1. 选择哪些类型的用户行为可触发此控件：

   • 浏览类别：当用户浏览您网站上的类别时，此规则就会触发（search.request.query 为空）。

   • 搜索：当用户在您的网站上进行搜索时触发此规则（search.request.query 不为空）。

2. 可选：设置一个控制条件，以触发规则的触发条件 或搜索的是哪个查询。可用的选项 取决于您选择了浏览类别还是搜索：

   • 如果您选择了浏览类别：在类别字段中，输入浏览哪些类别时会触发此控制。

   • 如果您选择了搜索：点击添加查询按钮，添加要过滤的查询字词（例如 running shoes），然后为每个字词选择以下选项之一：

     • 部分匹配：此控件仅在查询包含与查询字词部分匹配的内容时适用。
     • 完全匹配：此控件仅在查询包含 与此查询字词完全匹配。

     如果查询中包含这些字词之一，则会应用相应控制。

   如果您除了此条件之外还指定了时间范围条件，则只有在同时满足这两个条件时，才会应用控件措施。

3. 可选：点击添加时间范围按钮，以添加一个或多个时间范围 可以应用此控件的时间范围。

   如果您除了此时间范围条件之外还指定了类别或查询字词条件，则只有在同时满足这两个条件时，才会应用控件措施。

4. 点击继续，进入操作部分。

在操作部分中：

1. 在过滤条件操作字段中，为商品属性添加过滤条件。

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

   例如，如需要指定“product1”和“product2”的红色和蓝色版本，请使用以下语法：(id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))

2. 点击继续，进入服务配置部分。

在服务配置部分中，执行以下操作：

1. 选择要应用该控件的服务配置。

2. 提交控件设置。

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

您可以在“控件”页面的投放控件 (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": {
                  "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 参考文档。

• 有关此方法的示例，请参阅 管理服务配置。

创建重定向控件

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

控制台

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

2. 在投放控件标签页上，点击 创建控件。

   系统随即会打开创建控件窗格。

在偏好设置部分：

1. 在控件名称字段中，输入新控件的名称。

2. 可选：如需更改自动创建的对照组 ID，请点击修改，然后输入新的对照组 ID。

3. 选择重定向控件作为控件类型。

4. 点击“继续”以转到触发器部分。

在触发器部分，至少创建一个搜索字词触发器或时间范围触发器。重定向控件至少需要一个触发器：

1. 选择哪些类型的用户行为可触发此控件：

   • 浏览类别：当用户浏览网页时，就会触发规则 您网站上的类别（search.request.query 是 为空）。

   • 搜索：当用户在您的网站上进行搜索时触发此规则（search.request.query 不为空）。

2. 设置控件条件，以便根据浏览的类别或搜索的查询触发规则。可用的选项取决于您选择的是浏览类别还是搜索：

   • 如果您选择了浏览类别：在类别字段中，输入浏览哪些类别时会触发此控制。

   • 如果您选择了搜索：点击添加查询按钮，添加要过滤的查询字词（例如 running shoes），然后为每个字词选择以下选项之一：

     • 部分匹配：此控件仅在查询包含与查询字词部分匹配的内容时适用。
     • 完全匹配：此控件仅在查询包含 与此查询字词完全匹配。

     如果查询中包含这些字词之一，则会应用相应控制。

   如果除了此条件外，您还指定了时间范围条件，则 只有同时满足两个条件时，系统才会应用相应控件。

3. 点击添加时间范围按钮，添加一个或多个时间范围， 即可应用此控件

   如果您还指定类别或查询字词条件， 时间范围条件时，只有当同时满足两个条件时，系统才会应用该控件 都符合。

4. 点击继续，进入操作部分。

在操作部分：

1. 输入触发此控件时要重定向到的 URI。

2. 点击继续以转到服务配置部分。

在服务配置部分中，执行以下操作：

1. 选择要应用该控件的服务配置。

2. 提交控件设置。

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

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

curl

发出包含控件 ID 和Control.create 请求正文中包含的 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 参考文档。

• 如需查看此方法的示例，请参阅管理投放配置。

创建双向同义词控件

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

控制台

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

2. 在投放控件标签页上，点击 创建控件。

3. 在 Control name（控件名称）字段中，为新控件输入名称。

   系统随即会打开创建控件窗格。

在偏好设置部分：

1. 可选：如需更改自动创建的对照组 ID，请点击修改，然后输入新的对照组 ID。

2. 选择双向同义词控制作为控制类型。

3. 点击“继续”以转到触发器部分。

在触发器部分中：

1. 可选：点击添加时间范围按钮，添加一个或多个可应用此控件的时间范围。

2. 点击继续，进入操作部分。

在操作部分中：

1. 在同义词字段中，输入 2 到 100 个查询字词（例如， shirt 和 top）。

   当查询中包含这些字词中的任意一个时， 将其他查询字词视为所含字词的同义词。

2. 点击继续以转到服务配置部分。

在服务配置部分中，执行以下操作：

1. 选择要应用该控件的服务配置。

2. 提交控件设置。

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

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

curl

发出包含控件 ID 和Control.create 请求正文中包含的 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 方法结合使用。请参阅在内嵌方式下向投放配置添加控件。

创建单向同义词控件

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

控制台

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

2. 在投放控件标签页上，点击 创建控件。

   系统随即会打开创建控件窗格。

在偏好设置部分：

1. 在控件名称字段中，输入新控件的名称。

2. 可选：要更改自动创建的控件 ID，请点击 修改并输入新的控件 ID。

3. 选择单向同义词控件作为控制类型。

4. 点击“继续”以进入触发器部分。

在触发器部分中：

1. 可选：点击添加时间范围按钮，添加一个或多个可应用此控件的时间范围。

2. 点击继续，进入操作部分。

在操作部分：

1. 在查询字词字段中，输入符合以下条件的字词（例如 shoes） 都应该有与之相关联的同义词 查询。

2. 在同义词字段中，输入应用作同义词的字词 （例如 sneakers 和 sandals） 作为查询字词 shoes 的单向同义词）。

3. 点击继续以转到服务配置部分。

在服务配置部分中，执行以下操作：

1. 选择要应用该控件的服务配置。

2. 提交控件设置。

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

您可以在“控件”页面的投放控件 (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 参考文档。

• 有关此方法的示例，请参阅 管理服务配置。

创建“不关联”控件

有关详情，请参阅“不关联”控件 控件类型。

控制台

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

2. 在投放控件标签页上，点击 创建控件。

   系统随即会打开创建控件窗格。

在偏好设置部分：

1. 在控件名称字段中，输入新控件的名称。

2. 可选：如需更改自动创建的对照组 ID，请点击修改，然后输入新的对照组 ID。

3. 选择不关联控件作为控件类型。

4. 点击“继续”以转到触发器部分。

在触发器部分中：

1. 可选：点击添加时间范围按钮，添加一个或多个可应用此控件的时间范围。

2. 点击继续，进入操作部分。

在操作部分中：

1. 在查询字词字段中，输入字词（例如 gShoe） 您希望明确区分开来的范围。

2. 在不相关的字词字段中，输入不应 与您指定的查询字词相关联。

   例如，您可以将查询字词“gShoe”与 cheap。

3. 点击继续以转到服务配置部分。

在服务配置部分中，执行以下操作：

1. 选择要应用该控件的服务配置。

2. 提交控件设置。

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

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

curl

发出包含控件 ID 和Control.create 请求正文中包含的 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 参考文档。

• 有关此方法的示例，请参阅 管理服务配置。

创建忽略控件

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

控制台

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

2. 在投放控件标签页上，点击 创建控件。

   系统随即会打开创建控件窗格。

在偏好设置部分：

1. 在控件名称字段中，输入新控件的名称。

2. 可选：如需更改自动创建的对照组 ID，请点击修改，然后输入新的对照组 ID。

3. 选择不关联控件作为控件类型。

4. 点击“继续”以转到触发器部分。

在触发器部分中：

1. 可选：点击添加时间范围按钮，添加一个或多个可应用此控件的时间范围。

2. 点击继续，进入操作部分。

在操作部分：

1. 在忽略字词字段中，输入您希望搜索功能在用户将其作为查询字词输入时忽略的字词（例如 shoddy）。

2. 点击继续以转到服务配置部分。

在服务配置部分中，执行以下操作：

1. 选择要应用该控件的服务配置。

2. 提交控件设置。

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

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

curl

发出包含控件 ID 和Control.create 请求正文中包含的 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 参考文档。

• 如需查看此方法的示例，请参阅管理投放配置。

创建替换控件

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

控制台

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

2. 在投放控件标签页上，点击 创建控件。

   系统随即会打开创建控件窗格。

在偏好设置部分：

1. 在控件名称字段中，输入新控件的名称。

2. 可选：要更改自动创建的控件 ID，请点击 修改并输入新的控件 ID。

3. 选择替换控件作为控件类型。

4. 点击“继续”以转到触发器部分。

在触发器部分中：

1. 可选：点击添加时间范围按钮，添加一个或多个可应用此控件的时间范围。

2. 点击继续，进入操作部分。

在操作部分：

1. 在查询字词字段中，输入查询字词（例如， gShoe）。

2. 在替换字词字段中，输入应替换您指定的查询字词的字词。

   例如，您可以将查询字词“gShoe”替换为 期限：Google Shoe。

3. 点击继续以转到服务配置部分。

在服务配置部分中，执行以下操作：

1. 选择要应用该控件的服务配置。

2. 提交控件设置。

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

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

curl

发出包含控件 ID 和Control.create 请求正文中包含的 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 参考文档。

• 有关此方法的示例，请参阅 管理服务配置。