创建服务控件

本页介绍了如何创建服务控件。

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

借助服务控件，您可以创建规则来自定义服务配置如何提供结果。

您可以在 Search for Retail 控制台中创建服务控件，该控件由一个条件（用于触发该控件）以及一个在条件触发时发生的操作组成。然后，您可以将新的服务控件附加到服务配置。

服务配置与控件之间存在多对多关系。您可以向一项服务配置添加多个控件，并且一个控件可与多项服务配置相关联。

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

服务配置用于管理在搜索或预测请求期间应用哪些控件。在服务时，系统只会考虑请求的有效服务配置的控件。例如，假设您创建了两个控件：一个名为“gShoe Sale”的控件，在用户搜索“shoes”时提升品牌 gShoe 的搜索结果；另一个控件名为“More Shoes”，使用字词“跑鞋”扩展查询，使其包含“运动鞋”。如果您只将“gShoe Sale”控件附加到服务配置，则使用该服务配置的搜索请求会针对使用字词“shoes”的查询提升 gShoe 结果，但“More Shoes”控件未附加到您正在使用的服务配置，因此该控件不会产生任何影响。

您可以创建控件，然后将其添加或切换为实时投放配置。

您可以随时在控件页面上创建或修改服务控件，也可以使用 Controls.create 方法以内嵌方式创建或修改。在控制台中，您可以选择在服务配置创建过程中创建控件。

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

投放控件适用于：

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

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

教程：重定向控件

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

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

操作演示

创建新的投放控件

在 Google Cloud 控制台的“控件”页面上创建新的服务控件，或使用 Controls.create 方法以内嵌方式创建新的服务控件。

控件的要求因控件类型而异。转到您计划创建的控件类型的创建过程：

创建提升/掩埋控件

有关此控件类型的详情，请参见提升/掩埋控件。

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

要创建搜索增强/掩埋控件：

控制台

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

    前往“控件”页面

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

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

在偏好设置部分中：

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

  2. 可选：如需更改自动创建的控件 ID，请点击 Edit，然后输入新的控件 ID。

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

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

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

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

  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. 对于提升/掩埋值，使用滑块设置提升强度。正值会增强结果，负值会掩埋结果。

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

在服务配置部分：

  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"
                    }
                  ]
                },
                "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 方法：

创建建议增强/掩埋控制

如需创建建议增强/掩埋控制，请执行以下操作：

控制台

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

    前往“控件”页面

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

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

在偏好设置部分中：

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

  2. （可选）如需更改自动创建的控件 ID，请点击 Edit，然后输入新的控件 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 方法：

创建过滤器控件

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

控制台

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

    前往“控件”页面

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

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

在偏好设置部分中：

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

  2. 可选：如需更改自动创建的控件 ID，请点击 Edit，然后输入新的控件 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 方法：

创建重定向控件

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

控制台

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

    前往“控件”页面

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

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

在偏好设置部分中：

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

  2. 可选：如需更改自动创建的控件 ID，请点击 Edit，然后输入新的控件 ID。

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

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

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

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

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

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

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

    • 如果您选择浏览类别：在类别字段中，输入在浏览时将触发此控件的类别。

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

      • 部分匹配：当查询包含与此查询字词的部分匹配时，系统会应用此控件。
      • 完全匹配：仅当查询包含与此查询字词完全匹配时，此控件才适用。

      当某个字词包含在查询中时，将应用控件。

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

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

    如果除了此时间范围条件外，您还指定了类别或查询字词条件，则仅当同时满足这两个条件时，系统才会应用该控件。

  4. 点击继续以继续查看操作部分。

在操作部分中：

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

  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": {
                  "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 方法：

创建双向同义词控件

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

控制台

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

    前往“控件”页面

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

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

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

在偏好设置部分中：

  1. 可选：如需更改自动创建的控件 ID，请点击 Edit，然后输入新的控件 ID。

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

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

在触发器部分中：

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

  2. 点击继续以继续查看操作部分。

在操作部分中：

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

    当查询中包含其中任何一个字词时，搜索功能会将其他查询字词视为所包含字词的同义词。

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

在服务配置部分：

  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"
                    }
                    ]
                },
                "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，请点击 Edit，然后输入新的控件 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 方法：

创建“取消关联”控件

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

控制台

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

    前往“控件”页面

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

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

在偏好设置部分中：

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

  2. 可选：如需更改自动创建的控件 ID，请点击 Edit，然后输入新的控件 ID。

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

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

在触发器部分中：

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

  2. 点击继续以继续查看操作部分。

在操作部分中：

  1. 在查询字词字段中，输入您要明确与其他字词区分的字词（例如 gShoe）。

  2. 在已分离的字词字段中，输入不应在搜索结果中与您指定的查询字词关联的字词。

    例如，您可以将查询字词 gShoe 与字词 cheap 分离。

  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"
                    }
                  ]
                },
                "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 方法：

创建忽略控件

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

控制台

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

    前往“控件”页面

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

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

在偏好设置部分中：

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

  2. 可选：如需更改自动创建的控件 ID，请点击 Edit，然后输入新的控件 ID。

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

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

在触发器部分中：

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

  2. 点击继续以继续查看操作部分。

在操作部分中：

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

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

在服务配置部分：

  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"
                    }
                  ]
                },
                "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 方法：

创建替换控件

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

控制台

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

    前往“控件”页面

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

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

在偏好设置部分中：

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

  2. 可选：如需更改自动创建的控件 ID，请点击 Edit，然后输入新的控件 ID。

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

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

在触发器部分中：

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

  2. 点击继续以继续查看操作部分。

在操作部分中：

  1. 在查询字词字段中，输入要替换为替换字词的查询字词（例如 gShoe）。

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

    例如，您可以将查询字词 gShoe 替换为替换字词 Google Shoe。

  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"
                    }
                  ]
                },
                "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 方法：