解锁搜索效果层级

本页面介绍了搜索用例及其各自的性能层级，并介绍了如何通过 Search for Retail 控制台查看数据质量评估结果和您已解锁的性能层级。其中介绍了如何注册接收数据质量提醒。

搜索用例

Google 搜索为两种用例提供搜索结果：

  • 文本查询搜索，当买家通过输入文本查询并获取一组相关结果在应用中查找商品时使用。
  • 浏览搜索，当买家到达特定类别页面（例如家居装修商店零售网站的“家电”类别网页）并浏览该类别中的已排序商品时使用。

如需详细了解这些用例之间的差异，请参阅文本搜索和浏览搜索简介。

性能层级

文本查询搜索和浏览搜索具有不同的性能层级，可大大改进搜索结果。能否解锁性能层级取决于您上传到 Vertex AI Search for Retail 的用户事件和清单数据。

当您满足所有阻止升级的数据要求时，系统会自动激活每个性能层级。您还必须满足先前所有层级的要求才能升级到下一层级。

以下性能层级适用于每个用例：

  • 文本查询搜索用例

    • 相关性：系统仅会根据与查询的相关性返回结果
    • 相关性和热门程度：根据与查询的相关性返回结果。同等程度的商品会按照 相应商品在您网站上的热门程度排名
    • 针对收入优化：相关结果按产品的购买可能性 根据整个网站的活动进行排名
    • 个性化且针对收入进行了优化：相关结果按各个用户的偏好以及商品的购买可能性（基于整个网站的活动）排序

  • 浏览搜索用例

    • 热门程度：仅根据与类别的相关性返回结果
    • 针对收入优化：相关结果按产品的购买可能性 根据整个网站的活动进行排名
    • 个性化且针对收入进行了优化：相关结果按各个用户的偏好以及商品的购买可能性（基于整个网站的活动）排序

Search for Retail 控制台提供了一个数据质量页面，您可以在其中检查自己是否满足每个层级的数据要求。

检查数据质量

上传数据后，请转到 Search for Retail 控制台，查看您的用例的每个性能层级的数据检查指标。

  1. 前往 Search for Retail 控制台中的数据质量页面。

    转到“数据质量”页面

  2. 查看搜索用例的数据检查指标：

    • 如需查看文本搜索指标，请点击搜索标签页。
    • 对于浏览搜索指标，请点击浏览标签页。

  3. 请在页面顶部查看每个性能层级的问题统计信息摘要。

    • 如果其被标记为“使用中”：表示您已经满足该层级的所有阻止问题，并已解锁该层级。
    • 如果不存在 0 个阻塞问题：表示您已满足该层级的数据检查要求。如果此层级和之前的所有层级没有阻碍性问题，则需要大约 24 小时才能训练和准备模型并激活新解锁的层级。
    • 如果存在任何阻止问题：检查该层级的指标，了解需要解决哪些数据问题才能解锁该层级。

  4. 查看每个性能层级的数据检查指标表，了解可能会阻碍层级升级或影响搜索性能的问题列表。

  5. 在状态列中查看每个数据检查指标的优先级：

    • 阻止升级：识别导致搜索无法将用例升级到下一性能层级的数据问题。如需解锁某个层级，需通过相应性能层级（及其先前层级）的所有阻止升级的数据检查。
    • 性能关键型：识别不会阻止升级但会对文本搜索或浏览搜索性能产生重大影响的数据问题。
    • 符合：表示此数据检查已通过。
    • 不可用：表示尚未完成的非升级阻塞数据检查。这些指标的值会显示为不适用。导入数据后，最多可能需要 24 小时才能计算一些数据检查。

  6. 如需详细了解任何指标，请点击详细信息以查看详细信息面板，其中显示了该指标的说明、数据检查时间戳和阈值。

  7. 您可以在指标的详细信息面板中查看阈值，了解满足该指标的数据检查和改善结果所需的值。并非所有阈值都适用于所有指标：

    • 阻塞阈值：满足此指标的数据检查要求而必须满足的阈值。
    • 临界阈值：强烈建议达到的阈值。 不达到此阈值会对性能产生严重的负面影响。
    • 警告阈值：建议应达到的阈值。不达到此阈值可能会对性能产生轻微影响。

如需导入更多数据以满足任何数据问题，请参阅公共文档中的导入历史用户事件或导入目录信息。

最佳实践

  • 在搜索请求和用户事件中，除了已登录用户的访问者 ID 之外，还要提供用户 ID。这样，搜索服务就可以根据用户跨设备的登录事件为用户个性化搜索结果。
  • 实时发送用户事件，而不是延迟批量上传。这有助于系统根据用户在您网站上最近的活动提供个性化搜索结果。
  • 上传所有用户事件。例如，不要仅提交可归因于搜索的事件。

关闭个性化功能

如需关闭个性化功能，请将 ServingConfig.personalizationSpec 设置为 mode.DISABLED。

数据质量提醒

如果信息中心内的指标值从“满意”变为“不理想”，就会触发数据质量提醒。提醒是通过电子邮件发送的。

如果您想查看与 Cloud Monitoring 相关的提醒，请参阅设置提醒。

查看数据质量

前往 Search for Retail 控制台中的数据质量页面。

转到“数据质量”页面

一行对应一个指标，一个指标对应一条提醒。

设置数据质量提醒

REST

调用 UpdateAlertConfig API。

curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" -H "X-GFE-SSL: yes" -H "X-Goog-User-Project: PROJECT_ID" \
 "https://retail.googleapis.com/v2alpha/projects/PROJECT_ID/alertConfig" \
--data '
{
  "alertPolicies": [
    {
      "alertGroup": "search-data-quality",
      "enrollStatus": "ENROLLED",
      "recipients": [
        {
          "emailAddress": "EMAIL_ADDRESS_1"
        },
        {
          "emailAddress": "EMAIL_ADDRESS_2"
        }
      ]
    }
  ]
}'

请替换以下内容：

  • PROJECT_ID：您的 Google Cloud 项目的 ID。
  • EMAIL_ADDRESS_1，EMAIL_ADDRESS_2：您要注册接收提醒的电子邮件地址。它们应符合 SMTP（简单邮件传输协议）。一个提醒政策中最多可以添加 20 个电子邮件地址。

控制台

  1. 前往 Search for Retail 控制台中的数据质量页面。

    转到“数据质量”页面

  2. 点击顶部的 配置提醒。

  3. 请至少添加一个电子邮件地址。电子邮件地址应符合 SMTP（简单邮件传输协议）。一个提醒政策中最多可以添加 20 个电子邮件地址。

  4. 点击提交。

停用数据质量提醒

REST

调用 UpdateAlertConfig API。

curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" -H "X-GFE-SSL: yes" -H "X-Goog-User-Project: PROJECT_ID" \
 "https://retail.googleapis.com/v2alpha/projects/PROJECT_ID/alertConfig" \
--data '
{
  "alertPolicies": [
    {
      "alertGroup": "search-data-quality",
      "enrollStatus": "DECLINED",
      "recipients": [
      ]
    }
  ]
}'

请替换以下内容：

  • PROJECT_ID：您的 Google Cloud 项目的 ID。

控制台

  1. 前往 Search for Retail 控制台中的数据质量页面。

    转到“数据质量”页面

  2. 点击顶部的 配置提醒。

  3. 删除所有现有电子邮件。

  4. 点击提交。

问题排查

以下是一些常见问题及其解决方法：

数据检查未通过

如果数据检查未通过，请在数据质量页面上点击该指标的详细信息，以查看该指标的更详细的说明以及满足该数据检查要求的阈值。

如果您已经满足数据要求，请查看 Timestamp（时间戳）部分，了解该指标的上次计算时间。如果您最近重新设置了格式或提取了大量数据，则可能需要数小时才能重新计算该指标。

如果您未满足数据要求，则可能需要重新设置数据格式或收集更多数据，以满足数据检查要求。确保数据满足指标阈值后，重新导入调整过格式的数据或导入其他数据，然后等待指标重新计算。

指标值显示为“不适用”

如果未上传任何数据或指标尚未计算，则指标值会显示为“不适用”。导入数据后，最多可能需要 24 小时才能计算一些数据检查。

性能层级没有阻塞问题，但尚未使用

要进行问题排查，请按以下步骤操作：

  1. 检查之前的层级是否存在任何阻止数据的问题。您需要满足先前所有层级的要求才能升级到下一层级。

  2. 等待 24 小时。通过所有阻止升级的数据检查后，需要大约 24 小时才能训练、准备模型并激活新解锁的层级。

如果该性能层级在通过所有阻止升级的数据检查后的两天内未标记为使用中，请与 Vertex AI Search 零售支持团队联系，并提供您的项目编号和项目 ID，以获取帮助。

更多数据要求信息

如需详细了解适用于零售业的 Vertex AI Search 的数据要求，请参阅以下文档：

后续步骤